org.eclipse.californium.scandium.dtls

Class ReassemblingHandshakeMessage

java.lang.Object

org.eclipse.californium.scandium.dtls.AbstractMessage

org.eclipse.californium.scandium.dtls.HandshakeMessage

org.eclipse.californium.scandium.dtls.GenericHandshakeMessage

org.eclipse.californium.scandium.dtls.ReassemblingHandshakeMessage

All Implemented Interfaces:

DTLSMessage

public final class ReassemblingHandshakeMessage
extends GenericHandshakeMessage

Reassemble fragmented handshake messages. According RFC 6347, Section 4.2.3 "DTLS implementations MUST be able to handle overlapping fragment ranges". Therefore the processing of overlapping fragments is optimized by early testing, if it contains a new data-range and merging of adjacent ranges afterwards.

Field Summary

Fields inherited from class org.eclipse.californium.scandium.dtls.HandshakeMessage

FRAGMENT_LENGTH_BITS, FRAGMENT_OFFSET_BITS, MESSAGE_HEADER_LENGTH_BYTES, MESSAGE_LENGTH_BITS, MESSAGE_SEQ_BITS, MESSAGE_TYPE_BITS

Constructor Summary

Constructors

Constructor and Description
ReassemblingHandshakeMessage(FragmentedHandshakeMessage message) Called when reassembling a handshake message or received a fragment during the handshake.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(FragmentedHandshakeMessage message) Add data of fragment to reassembled data.
byte[]	fragmentToByteArray() The serialization of the handshake body (without the handshake header).
int	getMessageLength() Must be implemented by each subclass.
HandshakeType	getMessageType() Returns the type of the handshake message.
boolean	isComplete() Check, if message reassembling is complete.
String	toString()

Methods inherited from class org.eclipse.californium.scandium.dtls.GenericHandshakeMessage

fromByteArray

Methods inherited from class org.eclipse.californium.scandium.dtls.HandshakeMessage

fragmentChanged, fromByteArray, fromGenericHandshakeMessage, getContentType, getFragmentLength, getFragmentOffset, getMessageSeq, getNextHandshakeMessage, getRawMessage, setMessageSeq, setNextHandshakeMessage, size, toByteArray, writeTo

Methods inherited from class org.eclipse.californium.scandium.dtls.AbstractMessage

getPeer

Methods inherited from class java.lang.Object

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

Constructor Detail

ReassemblingHandshakeMessage

public ReassemblingHandshakeMessage(FragmentedHandshakeMessage message)

Called when reassembling a handshake message or received a fragment during the handshake.

Parameters:

message - starting fragmented message

Method Detail

isComplete

public boolean isComplete()

Check, if message reassembling is complete.

Returns:

true, if message is complete

add

public void add(FragmentedHandshakeMessage message)

Add data of fragment to reassembled data. Optimize processing of overlapping fragments by early testing, if it contains a new data-range and merging of adjacent ranges before returning.

Parameters:

message - fragmented handshake message

Throws:

IllegalArgumentException - if type, sequence number, total message length, or peer's address doesn't match the previous fragments. Or the fragment exceeds the handshake message.

getMessageType

public HandshakeType getMessageType()

Description copied from class: HandshakeMessage

Returns the type of the handshake message. See HandshakeType.

Overrides:

getMessageType in class GenericHandshakeMessage

Returns:

the HandshakeType.

getMessageLength

public int getMessageLength()

Description copied from class: HandshakeMessage

Must be implemented by each subclass. The length is given in bytes and only includes the length of the subclass' specific fields (not the handshake message header).

Overrides:

getMessageLength in class GenericHandshakeMessage

Returns:

the length of the message in bytes.

toString

public String toString()

Overrides:

toString in class HandshakeMessage

fragmentToByteArray

public byte[] fragmentToByteArray()

Description copied from class: HandshakeMessage

The serialization of the handshake body (without the handshake header). Must be implemented by each subclass. Except the ClientHello, the fragments are considered to be not modified. If a modification is required, call HandshakeMessage.fragmentChanged().

Overrides:

fragmentToByteArray in class GenericHandshakeMessage

Returns:

the raw byte representation of the handshake body.