net.i2p.data.i2np

Class DatabaseStoreMessage

java.lang.Object

net.i2p.data.i2np.I2NPMessageImpl

net.i2p.data.i2np.FastI2NPMessageImpl

net.i2p.data.i2np.DatabaseStoreMessage

All Implemented Interfaces:

I2NPMessage

public class DatabaseStoreMessage
extends FastI2NPMessageImpl

Defines the message a router sends to another router to test the network database reachability, as well as the reply message sent back. TODO: Don't decompress and recompress RouterInfos at the OBEP and IBGW. Could this even change the message length or corrupt things?

Author:

jrandom

Nested Class Summary

Nested classes/interfaces inherited from class net.i2p.data.i2np.I2NPMessageImpl

I2NPMessageImpl.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static int	MESSAGE_TYPE

Fields inherited from class net.i2p.data.i2np.FastI2NPMessageImpl

_checksum, _hasChecksum

Fields inherited from class net.i2p.data.i2np.I2NPMessageImpl

_context, _expiration, _log, CHECKSUM_LENGTH, DEFAULT_EXPIRATION_MS, HEADER_LENGTH

Fields inherited from interface net.i2p.data.i2np.I2NPMessage

MAX_ID_VALUE, MAX_SIZE

Constructor Summary

Constructors

Constructor and Description
DatabaseStoreMessage(net.i2p.I2PAppContext context)

Method Summary

Modifier and Type	Method and Description
protected int	calculateWrittenLength() calculate the message body's length (not including the header and footer)
boolean	equals(Object object)
net.i2p.data.DatabaseEntry	getEntry() Defines the entry in the network database being stored
net.i2p.data.Hash	getKey() Defines the key in the network database being stored
net.i2p.data.Hash	getReplyGateway()
long	getReplyToken() If a reply is desired, this token specifies the message ID that should be used for a DeliveryStatusMessage to be sent to the reply tunnel on the reply gateway.
net.i2p.data.TunnelId	getReplyTunnel()
int	getType() Return the unique identifier for this type of I2NP message, as defined in the I2NP spec
int	hashCode()
void	readMessage(byte[] data, int offset, int dataSize, int type) Read the body into the data structures, after the initial type byte and the uniqueId / expiration, using the current class's format as defined by the I2NP specification
void	setEntry(net.i2p.data.DatabaseEntry entry) This also sets the key
void	setReplyGateway(net.i2p.data.Hash peer)
void	setReplyToken(long token) Update the reply token.
void	setReplyTunnel(net.i2p.data.TunnelId id)
String	toString()
protected int	writeMessageBody(byte[] out, int curIndex) write the message body to the output array, starting at the given index

Methods inherited from class net.i2p.data.i2np.FastI2NPMessageImpl

readBytes, toByteArray, toByteArrayWithSavedChecksum

Methods inherited from class net.i2p.data.i2np.I2NPMessageImpl

createMessage, fromRawByteArray, fromRawByteArrayNTCP2, getMessageExpiration, getMessageSize, getRawMessageSize, getUniqueId, readBytes, readBytes, readMessage, registerBuilder, setMessageExpiration, setUniqueId, toByteArray, toByteArray, toRawByteArray, toRawByteArrayNTCP2, writeBytes

Methods inherited from class java.lang.Object

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

Field Detail

MESSAGE_TYPE

public static final int MESSAGE_TYPE

See Also:

Constant Field Values

Constructor Detail

DatabaseStoreMessage

public DatabaseStoreMessage(net.i2p.I2PAppContext context)

Method Detail

getKey

public net.i2p.data.Hash getKey()

Defines the key in the network database being stored

getEntry

public net.i2p.data.DatabaseEntry getEntry()

Defines the entry in the network database being stored

setEntry

public void setEntry(net.i2p.data.DatabaseEntry entry)

This also sets the key

Throws:

IllegalStateException - if data previously set, to protect saved checksum

getReplyToken

public long getReplyToken()

If a reply is desired, this token specifies the message ID that should be used for a DeliveryStatusMessage to be sent to the reply tunnel on the reply gateway.

Returns:

positive reply token ID, or 0 if no reply is necessary.

setReplyToken

public void setReplyToken(long token)
                   throws IllegalArgumentException

Update the reply token.

Throws:

IllegalArgumentException - if the token is out of range (min=0, max=I2NPMessage.MAX_ID_VALUE)

getReplyTunnel

public net.i2p.data.TunnelId getReplyTunnel()

setReplyTunnel

public void setReplyTunnel(net.i2p.data.TunnelId id)

getReplyGateway

public net.i2p.data.Hash getReplyGateway()

setReplyGateway

public void setReplyGateway(net.i2p.data.Hash peer)

readMessage

public void readMessage(byte[] data,
                        int offset,
                        int dataSize,
                        int type)
                 throws I2NPMessageException

Description copied from interface: I2NPMessage

Read the body into the data structures, after the initial type byte and the uniqueId / expiration, using the current class's format as defined by the I2NP specification

Parameters:

data - data to read from

offset - where to start in the data array

dataSize - how long into the data to read

type - I2NP message type

Throws:

I2NPMessageException - if the stream doesn't contain a valid message that this class can read.

calculateWrittenLength

protected int calculateWrittenLength()

calculate the message body's length (not including the header and footer)

Specified by:

calculateWrittenLength in class I2NPMessageImpl

Throws:

IllegalStateException

writeMessageBody

protected int writeMessageBody(byte[] out,
                               int curIndex)
                        throws I2NPMessageException

write the message body to the output array, starting at the given index

Specified by:

writeMessageBody in class I2NPMessageImpl

Returns:

the index into the array after the last byte written (NOT the length)

Throws:

I2NPMessageException

getType

public int getType()

Description copied from interface: I2NPMessage

Return the unique identifier for this type of I2NP message, as defined in the I2NP spec

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object object)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object