org.bitcoinj.core

Class RejectMessage

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.RejectMessage

All Implemented Interfaces:

Serializable

public class RejectMessage
extends Message

A message sent by nodes when a message we sent was rejected (ie a transaction had too little fee/was invalid/etc)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RejectMessage.RejectCode

Nested classes/interfaces inherited from class org.bitcoinj.core.Message

Message.LazyParseException

Field Summary

Fields inherited from class org.bitcoinj.core.Message

checksum, cursor, length, MAX_SIZE, offset, params, parsed, parseLazy, parseRetain, payload, protocolVersion, recached, UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor and Description
RejectMessage(NetworkParameters params, byte[] payload)
RejectMessage(NetworkParameters params, RejectMessage.RejectCode code, Sha256Hash hash, String message, String reason) Constructs a reject message that fingers the object with the given hash as rejected for the given reason.

Method Summary

Modifier and Type	Method and Description
void	bitcoinSerializeToStream(OutputStream stream) Serializes this message to the provided stream.
boolean	equals(Object o)
RejectMessage.RejectCode	getReasonCode() The reason code given for why the peer rejected the message.
String	getReasonString() The reason message given for rejection.
String	getRejectedMessage() Provides the type of message which was rejected by the peer.
Sha256Hash	getRejectedObjectHash() Provides the hash of the rejected object (if getRejectedMessage() is either "tx" or "block"), otherwise null.
int	hashCode()
void	parse()
protected void	parseLite() Perform the most minimal parse possible to calculate the length of the message payload.
String	toString() A String representation of the relevant details of this reject message.

Methods inherited from class org.bitcoinj.core.Message

adjustLength, bitcoinSerialize, bitcoinSerialize, ensureParsed, getHash, getMessageSize, getParams, isCached, isParsed, isRecached, maybeParse, unCache, unsafeBitcoinSerialize

Methods inherited from class java.lang.Object

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

Constructor Detail

RejectMessage

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

Throws:

ProtocolException

RejectMessage

public RejectMessage(NetworkParameters params,
                     RejectMessage.RejectCode code,
                     Sha256Hash hash,
                     String message,
                     String reason)
              throws ProtocolException

Constructs a reject message that fingers the object with the given hash as rejected for the given reason.

Throws:

ProtocolException

Method Detail

parseLite

protected void parseLite()
                  throws ProtocolException

Description copied from class: Message

Perform the most minimal parse possible to calculate the length of the message payload. This is only required for subclasses of ChildMessage as root level messages will have their length passed into the constructor.

Implementations should adhere to the following contract: If parseLazy = true the 'length' field must be set before returning. If parseLazy = false the length field must be set either within the parseLite() method OR the parse() method. The overriding requirement is that length must be set to non UNKNOWN_MESSAGE value by the time the constructor exits.

Specified by:

parseLite in class Message

Throws:

ProtocolException

parse

public void parse()
           throws ProtocolException

Throws:

ProtocolException

bitcoinSerializeToStream

public void bitcoinSerializeToStream(OutputStream stream)
                              throws IOException

Description copied from class: Message

Serializes this message to the provided stream. If you just want the raw bytes use bitcoinSerialize().

Throws:

IOException

getRejectedMessage

public String getRejectedMessage()

Provides the type of message which was rejected by the peer. Note that this is ENTIRELY UNTRUSTED and should be sanity-checked before it is printed or processed.

getRejectedObjectHash

public Sha256Hash getRejectedObjectHash()

Provides the hash of the rejected object (if getRejectedMessage() is either "tx" or "block"), otherwise null.

getReasonCode

public RejectMessage.RejectCode getReasonCode()

The reason code given for why the peer rejected the message.

getReasonString

public String getReasonString()

The reason message given for rejection. Note that this is ENTIRELY UNTRUSTED and should be sanity-checked before it is printed or processed.

toString

public String toString()

A String representation of the relevant details of this reject message. Be aware that the value returned by this method includes the value returned by getReasonString, which is taken from the reject message unchecked. Through malice or otherwise, it might contain control characters or other harmful content.

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object