org.eclipse.californium.scandium.dtls

Interface RecordLayer

All Known Implementing Classes:

DtlsClusterConnector, DTLSConnector, DtlsManagedClusterConnector

public interface RecordLayer

An abstraction of the DTLS record layer's capabilities for sending records to peers. MTU values according MTU - Wikipedia.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_ETH_MTU Default Ethernet MTU.
static int	DEFAULT_IPV4_MTU Default IPv4 MTU.
static int	DEFAULT_IPV6_MTU Default IPv6 MTU.
static int	IPV4_HEADER_LENGTH IPv4 header size.
static int	IPV6_HEADER_LENGTH IPv6 header size.
static int	MAX_MTU Maximum MTU.

Method Summary

Methods

Modifier and Type	Method and Description
void	dropReceivedRecord(Record record) Report dropped record
int	getMaxDatagramSize(boolean ipv6) Gets the maximum size of a UDP datagram that can be sent to this session's peer without IP fragmentation.
boolean	isRunning() Returns execution state of record layer.
void	processRecord(Record record, Connection connection) Process received record.
void	sendFlight(List<DatagramPacket> datagrams) Sends a set of UDP datagrams containing DTLS records with handshake messages to a peer.

Field Detail

MAX_MTU

static final int MAX_MTU

Maximum MTU.

Since:

2.4

See Also:

Constant Field Values

DEFAULT_IPV6_MTU

static final int DEFAULT_IPV6_MTU

Default IPv6 MTU.

Since:

2.4

See Also:

Constant Field Values

DEFAULT_IPV4_MTU

static final int DEFAULT_IPV4_MTU

Default IPv4 MTU.

Since:

2.4

See Also:

Constant Field Values

DEFAULT_ETH_MTU

static final int DEFAULT_ETH_MTU

Default Ethernet MTU.

Since:

2.4

See Also:

Constant Field Values

IPV4_HEADER_LENGTH

static final int IPV4_HEADER_LENGTH

IPv4 header size.

Since:

2.4

See Also:

Constant Field Values

IPV6_HEADER_LENGTH

static final int IPV6_HEADER_LENGTH

IPv6 header size.

Since:

2.4

See Also:

Constant Field Values

Method Detail

isRunning

boolean isRunning()

Returns execution state of record layer.

Returns:

true if execution is running, false, otherwise.

Since:

2.4

getMaxDatagramSize

int getMaxDatagramSize(boolean ipv6)

Gets the maximum size of a UDP datagram that can be sent to this session's peer without IP fragmentation.

Parameters:

ipv6 - true, IPv6 destination, false, IPv4 destination

Returns:

the maximum datagram size in bytes

Since:

2.4

sendFlight

void sendFlight(List<DatagramPacket> datagrams)
                throws IOException

Sends a set of UDP datagrams containing DTLS records with handshake messages to a peer.

The set is sent as a whole. In particular this means that all datagrams will be re-transmitted in case of a missing acknowledgement from the peer.

Parameters:

datagrams - list of UDP datagrams containing DTLS records to send.

Throws:

IOException - if an io error occurs

Since:

2.4

processRecord

void processRecord(Record record,
                 Connection connection)

Process received record.

Parameters:

record - received record.

connection - connection to process record.

dropReceivedRecord

void dropReceivedRecord(Record record)

Report dropped record

Parameters:

record - dropped record

Since:

2.4