org.sellcom.core.net

Class NetworkMessage

java.lang.Object

org.sellcom.core.net.NetworkMessage

public class NetworkMessage
extends Object

Network message.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	HEADER_LENGTH Length of the network message header (in bytes).

Method Summary

Modifier and Type	Method and Description
static NetworkMessage	create() Creates an empty network message.
static NetworkMessage	fromByteBuffer(ByteBuffer buffer, InetSocketAddress remoteEndPoint) Creates a NetworkMessage from the given ByteBuffer containing the raw data.
byte[]	getPayload() Returns the payload of this message.
InetAddress	getRemoteAddress() Returns the address of the remote end point associated with this message.
InetSocketAddress	getRemoteEndPoint() Returns the remote end point associated with this message.
String	getRemoteHostName() Returns the host name of the remote end point associated with this message.
Integer	getRemotePort() Returns the port of the remote end point associated with this message.
UUID	getUuid() Returns the UUID of this message.
boolean	isValid() Checks whether the message is valid.
ByteBuffer	toByteBuffer() Returns a ByteBuffer containing the raw data of this message.
NetworkMessage	withPayload(byte[] payload) Sets the payload of this message.
NetworkMessage	withRandomUuid() Sets the UUID of this message to a random value.
NetworkMessage	withRemoteEndPoint(InetSocketAddress remoteEndPoint) Sets the remote end point associated with this message.
NetworkMessage	withUuid(UUID uuid) Sets the UUID of this message.

Methods inherited from class java.lang.Object

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

Field Detail

HEADER_LENGTH

public static final int HEADER_LENGTH

Length of the network message header (in bytes).

Since:

1.0

See Also:

Constant Field Values

Method Detail

create

public static NetworkMessage create()

Creates an empty network message.

Since:

1.0

fromByteBuffer

public static NetworkMessage fromByteBuffer(ByteBuffer buffer,
                                            InetSocketAddress remoteEndPoint)
                                     throws IOException

Creates a NetworkMessage from the given ByteBuffer containing the raw data.

Throws:

IllegalArgumentException - if buffer is null

IllegalArgumentException - if remoteEndPoint is null

IOException

Since:

1.0

getPayload

public byte[] getPayload()

Returns the payload of this message.

Since:

1.0

getRemoteAddress

public InetAddress getRemoteAddress()

Returns the address of the remote end point associated with this message.

Since:

1.0

getRemoteEndPoint

public InetSocketAddress getRemoteEndPoint()

Returns the remote end point associated with this message.

Since:

1.0

getRemoteHostName

public String getRemoteHostName()

Returns the host name of the remote end point associated with this message.

Since:

1.0

getRemotePort

public Integer getRemotePort()

Returns the port of the remote end point associated with this message.

Since:

1.0

getUuid

public UUID getUuid()

Returns the UUID of this message.

Since:

1.0

isValid

public boolean isValid()

Checks whether the message is valid.

Since:

1.0

toByteBuffer

public ByteBuffer toByteBuffer()

Returns a ByteBuffer containing the raw data of this message.

Throws:

IllegalStateException - if the UUID has not yet been set

Since:

1.0

withPayload

public NetworkMessage withPayload(byte[] payload)

Sets the payload of this message.

Throws:

IllegalArgumentException - if payload is null

Since:

1.0

withRandomUuid

public NetworkMessage withRandomUuid()

Sets the UUID of this message to a random value.

Since:

1.0

withRemoteEndPoint

public NetworkMessage withRemoteEndPoint(InetSocketAddress remoteEndPoint)

Sets the remote end point associated with this message.

Throws:

IllegalArgumentException - if remoteEndPoint is null

IllegalArgumentException - if remoteEndPoint.getPort() is 0

Since:

1.0

withUuid

public NetworkMessage withUuid(UUID uuid)

Sets the UUID of this message.

Throws:

IllegalArgumentException - if uuid is null

Since:

1.0