org.bitcoinj.core

Class ChildMessage

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.ChildMessage

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PeerAddress, Transaction, TransactionInput, TransactionOutPoint, TransactionOutput

public abstract class ChildMessage
extends Message

Represents a Message type that can be contained within another Message. ChildMessages that have a cached backing byte array need to invalidate their parent's caches as well as their own if they are modified.

See Also:

Serialized Form

Nested Class Summary

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

Message.LazyParseException

Field Summary

Fields

Modifier and Type	Field and Description
protected Message	parent

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

Modifier	Constructor and Description
protected	ChildMessage()
	ChildMessage(NetworkParameters params)
	ChildMessage(NetworkParameters params, byte[] payload, int offset)
	ChildMessage(NetworkParameters params, byte[] payload, int offset, int protocolVersion)
	ChildMessage(NetworkParameters params, byte[] payload, int offset, int protocolVersion, Message parent, boolean parseLazy, boolean parseRetain, int length)
	ChildMessage(NetworkParameters params, byte[] payload, int offset, Message parent, boolean parseLazy, boolean parseRetain, int length)

Method Summary

Modifier and Type	Method and Description
protected void	adjustLength(int adjustment)
protected void	adjustLength(int newArraySize, int adjustment)
void	setParent(Message parent)
protected void	unCache() To be called before any change of internal values including any setters.

Methods inherited from class org.bitcoinj.core.Message

bitcoinSerialize, bitcoinSerialize, ensureParsed, getHash, getMessageSize, getParams, isCached, isParsed, isRecached, maybeParse, parseLite, unsafeBitcoinSerialize

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

parent

@Nullable
protected Message parent

Constructor Detail

ChildMessage

protected ChildMessage()

ChildMessage

public ChildMessage(NetworkParameters params)

ChildMessage

public ChildMessage(NetworkParameters params,
                    byte[] payload,
                    int offset,
                    int protocolVersion)
             throws ProtocolException

Throws:

ProtocolException

ChildMessage

public ChildMessage(NetworkParameters params,
                    byte[] payload,
                    int offset,
                    int protocolVersion,
                    Message parent,
                    boolean parseLazy,
                    boolean parseRetain,
                    int length)
             throws ProtocolException

Throws:

ProtocolException

ChildMessage

public ChildMessage(NetworkParameters params,
                    byte[] payload,
                    int offset)
             throws ProtocolException

Throws:

ProtocolException

ChildMessage

public ChildMessage(NetworkParameters params,
                    byte[] payload,
                    int offset,
                    @Nullable
                    Message parent,
                    boolean parseLazy,
                    boolean parseRetain,
                    int length)
             throws ProtocolException

Throws:

ProtocolException

Method Detail

setParent

public void setParent(@Nullable
                      Message parent)

unCache

protected void unCache()

Description copied from class: Message

To be called before any change of internal values including any setters. This ensures any cached byte array is removed after performing a lazy parse if necessary to ensure the object is fully populated.

Child messages of this object(e.g. Transactions belonging to a Block) will not have their internal byte caches invalidated unless they are also modified internally.

Overrides:

unCache in class Message

adjustLength

protected void adjustLength(int adjustment)

adjustLength

protected void adjustLength(int newArraySize,
                            int adjustment)

Overrides:

adjustLength in class Message