org.eclipse.californium.elements.tcp.netty

Class TlsClientConnector

java.lang.Object

org.eclipse.californium.elements.tcp.netty.TcpClientConnector

org.eclipse.californium.elements.tcp.netty.TlsClientConnector

All Implemented Interfaces:

org.eclipse.californium.elements.Connector

public class TlsClientConnector
extends TcpClientConnector

A TLS client connector that establishes outbound TLS connections.

Field Summary

Fields inherited from class org.eclipse.californium.elements.tcp.netty.TcpClientConnector

contextUtil, LOGGER

Constructor Summary

Constructors

Constructor and Description
TlsClientConnector(SSLContext sslContext, int numberOfThreads, int connectTimeoutMillis, int idleTimeout) Creates TLS client connector with custom SSL context.
TlsClientConnector(SSLContext sslContext, int numberOfThreads, int connectTimeoutMillis, int handshakeTimeoutMillis, int idleTimeout) Creates TLS client connector with custom SSL context.

Method Summary

Methods

Modifier and Type	Method and Description
String	getProtocol()
protected void	onNewChannelCreated(SocketAddress remote, io.netty.channel.Channel ch) Called when a new channel is created, Allows subclasses to add their own handlers first, like an SSL handler.
protected void	send(io.netty.channel.Channel channel, org.eclipse.californium.elements.EndpointContextMatcher endpointMatcher, org.eclipse.californium.elements.RawData msg) Send message with acquired channel.

Methods inherited from class org.eclipse.californium.elements.tcp.netty.TcpClientConnector

destroy, getAddress, send, setEndpointContextMatcher, setRawDataReceiver, start, stop, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TlsClientConnector

public TlsClientConnector(SSLContext sslContext,
                  int numberOfThreads,
                  int connectTimeoutMillis,
                  int idleTimeout)

Creates TLS client connector with custom SSL context. Useful for using client keys, or custom trust stores. The context must be initialized by the caller.

Parameters:

sslContext - ssl context

numberOfThreads - number of thread used by connector

connectTimeoutMillis - tcp connect timeout in milliseconds

idleTimeout - idle timeout in seconds to close unused connection.

TlsClientConnector

public TlsClientConnector(SSLContext sslContext,
                  int numberOfThreads,
                  int connectTimeoutMillis,
                  int handshakeTimeoutMillis,
                  int idleTimeout)

Creates TLS client connector with custom SSL context. Useful for using client keys, or custom trust stores. The context must be initialized by the caller.

Parameters:

sslContext - ssl context

numberOfThreads - number of thread used by connector

connectTimeoutMillis - tcp connect timeout in milliseconds

handshakeTimeoutMillis - handshake timeout in milliseconds

idleTimeout - idle timeout in seconds to close unused connection

Method Detail

send

protected void send(io.netty.channel.Channel channel,
        org.eclipse.californium.elements.EndpointContextMatcher endpointMatcher,
        org.eclipse.californium.elements.RawData msg)

Send message with acquired channel. Intended to be overridden, if message sending should be delayed to complete a TLS handshake. Delay message sending after TLS handshake is completed.

Overrides:

send in class TcpClientConnector

Parameters:

channel - acquired channel

endpointMatcher - endpoint matcher

msg - message to be send

onNewChannelCreated

protected void onNewChannelCreated(SocketAddress remote,
                       io.netty.channel.Channel ch)

Description copied from class: TcpClientConnector

Called when a new channel is created, Allows subclasses to add their own handlers first, like an SSL handler. At this stage the channel is not connected, and therefore the Channel.remoteAddress() is null. To create a "remote peer" aware SSLEngine, provide the remote address as additional parameter.

Overrides:

onNewChannelCreated in class TcpClientConnector

Parameters:

remote - remote address the channel will be connected to.

ch - new created channel

getProtocol

public String getProtocol()

Specified by:

getProtocol in interface org.eclipse.californium.elements.Connector

Overrides:

getProtocol in class TcpClientConnector