Package org.bitcoinj.core

Class GetHeadersMessage

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.GetBlocksMessage

org.bitcoinj.core.GetHeadersMessage

public class GetHeadersMessage
extends GetBlocksMessage

The "getheaders" command is structurally identical to "getblocks", but has different meaning. On receiving this message a Bitcoin node returns matching blocks up to the limit, but without the bodies. It is useful as an optimization: when your wallet does not contain any keys created before a particular time, you don't have to download the bodies for those blocks because you know there are no relevant transactions.

Instances of this class are not safe for use by multiple threads.

Field Summary

Fields inherited from class org.bitcoinj.core.GetBlocksMessage

locator, stopHash, version

Fields inherited from class org.bitcoinj.core.Message

cursor, length, MAX_SIZE, offset, params, payload, recached, serializer, UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor	Description
GetHeadersMessage(NetworkParameters params, byte[] payload)
GetHeadersMessage(NetworkParameters params, BlockLocator locator, Sha256Hash stopHash)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)	Compares two getheaders messages.
int	hashCode()
String	toString()

Methods inherited from class org.bitcoinj.core.GetBlocksMessage

bitcoinSerializeToStream, getLocator, getStopHash, parse

Methods inherited from class org.bitcoinj.core.Message

adjustLength, bitcoinSerialize, bitcoinSerialize, getHash, getMessageSize, getParams, hasMoreBytes, isCached, isRecached, readByte, readByteArray, readBytes, readHash, readInt64, readStr, readUint32, readUint64, readVarInt, readVarInt, setSerializer, unCache, unsafeBitcoinSerialize

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

GetHeadersMessage

public GetHeadersMessage(NetworkParameters params,
 BlockLocator locator,
 Sha256Hash stopHash)

GetHeadersMessage

public GetHeadersMessage(NetworkParameters params,
 byte[] payload)
                  throws ProtocolException

Throws:

ProtocolException

Method Details

toString

public String toString()

Overrides:

toString in class GetBlocksMessage

equals

public boolean equals(Object o)

Compares two getheaders messages. Note that even though they are structurally identical a GetHeadersMessage will not compare equal to a GetBlocksMessage containing the same data.

Overrides:

equals in class GetBlocksMessage

hashCode

public int hashCode()

Overrides:

hashCode in class GetBlocksMessage