net.tomp2p.message
Class Message

java.lang.Object
  net.tomp2p.message.Message

public class Message
extends Object

The message is in binary format in TomP2P. It is defined as follows and has several header and payload fields. Since we do the serialization manually, we do not need a serialization field.

Author:

Thomas Bocek

Nested Class Summary

static class	Message.Command
static class	Message.Content
static class	Message.Type

Constructor Summary

Message()
Creates message with a random ID

Method Summary

void	finished()
Message.Command	getCommand() Command of the message, such as GET, PING, etc.
int	getContentLength() The length of the payload
Message.Content	getContentType1() Returns first content type.
Message.Content	getContentType2() Returns second content type, only if first is not empty
Message.Content	getContentType3() Returns second content type, only if first is not empty
Message.Content	getContentType4() Returns second content type, only if first is not empty
Map<Number160,Data>	getDataMap()
Map<Number480,Data>	getDataMapConvert()
long	getFinished()
int	getInteger()
Number160	getKey1()
Number160	getKey2()
Number160	getKey3()
Map<Number160,Number160>	getKeyMap()
Collection<Number160>	getKeys()
Collection<Number480>	getKeysConvert()
long	getLong()
int	getMessageId() Randomly generated message ID
Collection<PeerAddress>	getNeighbors() Returns the stored neighbors
org.jboss.netty.buffer.ChannelBuffer	getPayload()
PublicKey	getPublicKey()
PeerAddress	getRealSender() The ID of the real sender as seen by us.
PeerAddress	getRecipient() The ID of the recipient.
PeerAddress	getSender() The ID of the sender.
Message.Type	getType() Determines if its a request oCommandr reply, and what kind of reply (error, warning states)
int	getVersion() Returns the version, which is 32bit.
boolean	isConvertNumber480to160()
boolean	isError()
boolean	isFireAndForget()
boolean	isHintSign()
boolean	isNotOk()
boolean	isOk()
boolean	isRequest()
boolean	isUDP()
Message	setCommand(Message.Command command) Command of the message, such as GET, PING, etc.
Message	setContentLength(int contentLength) Set payload length.
Message	setContentType(Message.Content contentType) Convient method to set content type.
void	setConvertNumber480to160(boolean convertNumber480to160)
Message	setDataMap(Map<Number160,Data> dataMap)
Message	setDataMapConvert(Map<Number480,Data> dataMap)
void	setFireAndForget(boolean fireAndForget)
void	setHintSign(boolean hintSign)
Message	setInteger(int int_number)
Message	setKey(Number160 key3)
Message	setKeyKey(Number160 key1, Number160 key2)
Message	setKeyMap(Map<Number160,Number160> keyMap)
Message	setKeys(Collection<Number160> keys)
Message	setKeysConvert(Collection<Number480> keysConvert)
Message	setLong(long long_number)
Message	setMessageId(int messageId) For deserialization, we need to set the id
Message	setNeighbors(Collection<PeerAddress> neighbors)
Message	setNeighbors(Collection<PeerAddress> neighbors, int useAtMostNeighbors)
Message	setPayload(org.jboss.netty.buffer.ChannelBuffer payload)
Message	setPublicKey(PublicKey publicKey)
Message	setPublicKeyAndSign(KeyPair keyPair)
Message	setRealSender(PeerAddress realSender) The ID of the real sender as seen by us.
Message	setRecipient(PeerAddress recipient) Set the ID of the recipient.
Message	setSender(PeerAddress sender) The ID of the sender.
void	setTCP()
Message	setType(Message.Type type) Set the message type.
void	setUDP()
Message	setVersion(int version) For deserialization
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Message

public Message()

Creates message with a random ID

Method Detail

getMessageId

public int getMessageId()

Randomly generated message ID

Returns:

message Id

setMessageId

public Message setMessageId(int messageId)

For deserialization, we need to set the id

Parameters:

messageId - The message Id

setUDP

public void setUDP()

setTCP

public void setTCP()

isUDP

public boolean isUDP()

finished

public void finished()

getFinished

public long getFinished()

getVersion

public int getVersion()

Returns the version, which is 32bit. Each application can choose and version to not intefere with other applications

Returns:

The application version that uses this P2P framework

setVersion

public Message setVersion(int version)

For deserialization

Parameters:

version - The 24bit version

getType

public Message.Type getType()

Determines if its a request oCommandr reply, and what kind of reply (error, warning states)

Returns:

Type of the message

setType

public Message setType(Message.Type type)

Set the message type. Either its a request or reply (with error and warning codes)

Parameters:

type - Type of the message

getCommand

public Message.Command getCommand()

Command of the message, such as GET, PING, etc.

Returns:

Command

setCommand

public Message setCommand(Message.Command command)

Command of the message, such as GET, PING, etc.

Parameters:

command - Command

getRealSender

public PeerAddress getRealSender()

The ID of the real sender as seen by us.

setRealSender

public Message setRealSender(PeerAddress realSender)

The ID of the real sender as seen by us.

Parameters:

sender - The ID of the sender.

getSender

public PeerAddress getSender()

The ID of the sender. Note that the IP is set via the socket.

setSender

public Message setSender(PeerAddress sender)

The ID of the sender. The IP of the sender will *not* be transferred, as this information is in the IP packet.

Parameters:

sender - The ID of the sender.

getRecipient

public PeerAddress getRecipient()

The ID of the recipient. Note that the IP is set via the socket.

Returns:

The ID of the recipient

setRecipient

public Message setRecipient(PeerAddress recipient)

Set the ID of the recipient. The IP is used to connect to the recipient, but the IP is *not* transferred.

Parameters:

recipient - The ID of the recipient

getContentLength

public int getContentLength()

The length of the payload

Returns:

Length of the payload, if no payload set, returns 0.

setContentLength

public Message setContentLength(int contentLength)

Set payload length. This can also be used to not transfer payload even if payload has been set. If contentlength is set to 0, no payload will be transferred.

Parameters:

contentLength - The length of the payload

getContentType1

public Message.Content getContentType1()

Returns first content type. Content type can be empty if not set

Returns:

Content type 1

getContentType2

public Message.Content getContentType2()

Returns second content type, only if first is not empty

Returns:

Content type 2

getContentType3

public Message.Content getContentType3()

Returns second content type, only if first is not empty

Returns:

Content type 2

getContentType4

public Message.Content getContentType4()

Returns second content type, only if first is not empty

Returns:

Content type 2

setContentType

public Message setContentType(Message.Content contentType)

Convient method to set content type. Set first content type 1, if this is set (not empty), then set the second one.

Parameters:

contentType -

isRequest

public boolean isRequest()

isOk

public boolean isOk()

isNotOk

public boolean isNotOk()

isError

public boolean isError()

setNeighbors

public Message setNeighbors(Collection<PeerAddress> neighbors)

setNeighbors

public Message setNeighbors(Collection<PeerAddress> neighbors,
                            int useAtMostNeighbors)

getNeighbors

public Collection<PeerAddress> getNeighbors()

Returns the stored neighbors

Returns:

Null if no neighbors set or the list of neighbors

setKeysConvert

public Message setKeysConvert(Collection<Number480> keysConvert)

setKeys

public Message setKeys(Collection<Number160> keys)

getKeys

public Collection<Number160> getKeys()

getKeysConvert

public Collection<Number480> getKeysConvert()

setDataMapConvert

public Message setDataMapConvert(Map<Number480,Data> dataMap)

setDataMap

public Message setDataMap(Map<Number160,Data> dataMap)

getDataMap

public Map<Number160,Data> getDataMap()

getDataMapConvert

public Map<Number480,Data> getDataMapConvert()

setKey

public Message setKey(Number160 key3)

setKeyKey

public Message setKeyKey(Number160 key1,
                         Number160 key2)

getKey1

public Number160 getKey1()

getKey2

public Number160 getKey2()

getKey3

public Number160 getKey3()

setKeyMap

public Message setKeyMap(Map<Number160,Number160> keyMap)

getKeyMap

public Map<Number160,Number160> getKeyMap()

setLong

public Message setLong(long long_number)

getLong

public long getLong()

setPayload

public Message setPayload(org.jboss.netty.buffer.ChannelBuffer payload)

getPayload

public org.jboss.netty.buffer.ChannelBuffer getPayload()

toString

public String toString()

Overrides:

toString in class Object

setInteger

public Message setInteger(int int_number)

getInteger

public int getInteger()

getPublicKey

public PublicKey getPublicKey()

setPublicKey

public Message setPublicKey(PublicKey publicKey)

setPublicKeyAndSign

public Message setPublicKeyAndSign(KeyPair keyPair)

setHintSign

public void setHintSign(boolean hintSign)

isHintSign

public boolean isHintSign()

setConvertNumber480to160

public void setConvertNumber480to160(boolean convertNumber480to160)

isConvertNumber480to160

public boolean isConvertNumber480to160()

setFireAndForget

public void setFireAndForget(boolean fireAndForget)

isFireAndForget

public boolean isFireAndForget()