TunnelDataMessage (I2P Anonymous Network - Java Documentation

java.lang.Object
- net.i2p.data.DataStructureImpl
- - net.i2p.data.i2np.I2NPMessageImpl
  - - net.i2p.data.i2np.FastI2NPMessageImpl
    - - net.i2p.data.i2np.TunnelDataMessage

All Implemented Interfaces:

Serializable, DataStructure, I2NPMessage
```
public class TunnelDataMessage
extends FastI2NPMessageImpl
```
Defines the message sent between routers as part of the tunnel delivery The tunnel ID is changed in-place by TunnelParticipant.send(), so we can't reuse the checksum on output, but we still subclass FastI2NPMessageImpl so we don't verify the checksum on input... because this is a high-usage class.

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class net.i2p.data.i2np.I2NPMessageImpl
  I2NPMessageImpl.Builder

Field Summary

Fields
Modifier and Type Field Description

static int DATA_SIZE

static int MESSAGE_TYPE
- Fields inherited from class net.i2p.data.i2np.FastI2NPMessageImpl
  _checksum, _hasChecksum
- Fields inherited from interface net.i2p.data.i2np.I2NPMessage
  MAX_ID_VALUE, MAX_SIZE
- Fields inherited from class net.i2p.data.i2np.I2NPMessageImpl
  _context, _expiration, _log, _uniqueId, CHECKSUM_LENGTH, DEFAULT_EXPIRATION_MS, HEADER_LENGTH

Fields
Modifier and Type	Field	Description
`static int`	`DATA_SIZE`
`static int`	`MESSAGE_TYPE`

Constructor Summary

Constructors
Constructor Description

TunnelDataMessage(I2PAppContext context)

Constructors
Constructor	Description
`TunnelDataMessage(I2PAppContext context)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected int`	`calculateWrittenLength()`	calculate the message body's length (not including the header and footer
`boolean`	`equals(Object object)`
`byte[]`	`getData()`
`long`	`getTunnelId()`
`TunnelId`	`getTunnelIdObj()`
`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`	`setData(byte[] data)`
`void`	`setTunnelId(long id)`	(correctly) Invalidates stored checksum
`void`	`setTunnelId(TunnelId id)`	(correctly) Invalidates stored checksum
`byte[]`	`toByteArray()`
`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 interface net.i2p.data.DataStructure
calculateHash, fromBase64, fromByteArray, toBase64

Methods inherited from class net.i2p.data.DataStructureImpl
calculateHash, fromBase64, fromByteArray, read, toBase64

Methods inherited from class net.i2p.data.i2np.FastI2NPMessageImpl
readBytes, readBytes, readBytes, toByteArray, toByteArrayWithSavedChecksum, writeBytes

Methods inherited from class net.i2p.data.i2np.I2NPMessageImpl
createMessage, fromRawByteArray, getMessageExpiration, getMessageSize, getRawMessageSize, getUniqueId, readBytes, readMessage, registerBuilder, setMessageExpiration, setUniqueId, toRawByteArray

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
  - DATA_SIZE
```
public static final int DATA_SIZE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TunnelDataMessage
```
public TunnelDataMessage(I2PAppContext context)
```
- Method Detail
  - getTunnelId
```
public long getTunnelId()
```
  - setTunnelId
```
public void setTunnelId(long id)
```
    (correctly) Invalidates stored checksum
  - getTunnelIdObj
```
public TunnelId getTunnelIdObj()
```
  - setTunnelId
```
public void setTunnelId(TunnelId id)
```
    (correctly) Invalidates stored checksum
  - getData
```
public byte[] getData()
```
  - setData
```
public void setData(byte[] data)
```
    Throws:
    
    IllegalStateException - if data previously set, to protect saved checksum
  - 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
  - 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
    
    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
  - toByteArray
```
public byte[] toByteArray()
```
    Specified by:
    
    toByteArray in interface DataStructure
    
    Overrides:
    
    toByteArray in class I2NPMessageImpl
    
    Returns:
    
    may be null if data is not set
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class TunnelDataMessage

Nested Class Summary

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

Field Summary

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

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

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

Constructor Summary

Method Summary

Methods inherited from interface net.i2p.data.DataStructure

Methods inherited from class net.i2p.data.DataStructureImpl

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

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

Methods inherited from class java.lang.Object

Field Detail

MESSAGE_TYPE

DATA_SIZE

Constructor Detail

TunnelDataMessage

Method Detail

getTunnelId

setTunnelId

getTunnelIdObj

setTunnelId

getData

setData

readMessage

calculateWrittenLength

writeMessageBody

getType

hashCode

equals

toByteArray

toString