GetBlocksMessage (bitcoinj-core 0.17-alpha2 API)

java.lang.Object
- org.bitcoinj.core.BaseMessage
- - org.bitcoinj.core.GetBlocksMessage

All Implemented Interfaces:

Message

Direct Known Subclasses:

GetHeadersMessage
```
public class GetBlocksMessage
extends BaseMessage
```
Represents the "getblocks" P2P network message, which requests the hashes of the parts of the block chain we're missing. Those blocks can then be downloaded with a GetDataMessage.

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

Field Summary

Fields
Modifier and Type Field Description

protected BlockLocator locator

protected Sha256Hash stopHash

protected long version
- Fields inherited from interface org.bitcoinj.core.Message
  MAX_SIZE

Constructor Summary

Constructors
Constructor Description

GetBlocksMessage(long protocolVersion, BlockLocator locator, Sha256Hash stopHash)

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected void`	`bitcoinSerializeToStream(java.io.OutputStream stream)`	Serializes this message to the provided stream.
`boolean`	`equals(java.lang.Object o)`
`BlockLocator`	`getLocator()`
`Sha256Hash`	`getStopHash()`
`int`	`hashCode()`
`static GetBlocksMessage`	`read(java.nio.ByteBuffer payload)`	Deserialize this message from a given payload.
`java.lang.String`	`toString()`

Methods inherited from class org.bitcoinj.core.BaseMessage
messageSize, serialize

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.bitcoinj.core.Message
bitcoinSerialize, getMessageSize, unsafeBitcoinSerialize

Field Detail

version
```
protected long version
```

locator
```
protected BlockLocator locator
```

stopHash
```
protected Sha256Hash stopHash
```

Constructor Detail

GetBlocksMessage

public GetBlocksMessage(long protocolVersion,
                        BlockLocator locator,
                        Sha256Hash stopHash)

Method Detail
- read
```
public static GetBlocksMessage read(java.nio.ByteBuffer payload)
                             throws java.nio.BufferUnderflowException,
                                    ProtocolException
```
  Deserialize this message from a given payload.
  
  Parameters:
  
  payload - payload to deserialize from
  
  Returns:
  
  read message
  
  Throws:
  
  java.nio.BufferUnderflowException - if the read message extends beyond the remaining bytes of the payload
  
  ProtocolException
- getLocator
```
public BlockLocator getLocator()
```
- getStopHash
```
public Sha256Hash getStopHash()
```
- toString
```
public java.lang.String toString()
```
  Overrides:
  
  toString in class java.lang.Object
- bitcoinSerializeToStream
```
protected void bitcoinSerializeToStream(java.io.OutputStream stream)
                                 throws java.io.IOException
```
  Description copied from class: BaseMessage
  
  Serializes this message to the provided stream. If you just want the raw bytes use bitcoinSerialize().
  
  Specified by:
  
  bitcoinSerializeToStream in class BaseMessage
  
  Throws:
  
  java.io.IOException
- equals
```
public boolean equals(java.lang.Object o)
```
  Overrides:
  
  equals in class java.lang.Object
- hashCode
```
public int hashCode()
```
  Overrides:
  
  hashCode in class java.lang.Object