ej.net.dtls

Class DTLSSocket

java.lang.Object

java.net.DatagramSocket

ej.net.dtls.DTLSSocket

All Implemented Interfaces:

Closeable, AutoCloseable

public abstract class DTLSSocket
extends DatagramSocket

This class extends DatagramSockets and provides secure socket using protocols such as the "IETF "Datagram Transport Layer Security" (DTLS) protocols.

• calling startHandshake which explicitly begins handshakes, or
• any attempt to receive or send application data on this socket causes an implicit handshake

If handshaking fails for any reason, the DTLSSocket is closed, and no further communications can be done.

When DTLSSockets are first created, no handshaking is done. However, security is always provided by the time that application data is sent over the connection. DTLSSockets are created by DTLSSocketFactorys.

Method Summary

Modifier and Type	Method and Description
abstract void	startHandshake() Starts an DTLS handshake on this connection.

Methods inherited from class java.net.DatagramSocket

bind, close, connect, connect, disconnect, getBroadcast, getInetAddress, getLocalAddress, getLocalPort, getLocalSocketAddress, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoTimeout, getTrafficClass, isBound, isClosed, isConnected, receive, send, setBroadcast, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSoTimeout, setTrafficClass

Methods inherited from class java.lang.Object

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

Method Detail

startHandshake

public abstract void startHandshake()
                             throws IOException

Starts an DTLS handshake on this connection.

This method is synchronous for the initial handshake on a connection and returns when the negotiated handshake is complete. Some protocols may not support multiple handshakes on an existing socket and may throw an IOException.

Throws:

IOException - on a network level error