com.datastax.driver.core

Class RemoteEndpointAwareNettySSLOptions

java.lang.Object

com.datastax.driver.core.NettySSLOptions

com.datastax.driver.core.RemoteEndpointAwareNettySSLOptions

All Implemented Interfaces:

ExtendedRemoteEndpointAwareSslOptions, RemoteEndpointAwareSSLOptions, SSLOptions

public class RemoteEndpointAwareNettySSLOptions
extends NettySSLOptions
implements ExtendedRemoteEndpointAwareSslOptions

RemoteEndpointAwareSSLOptions implementation based on Netty's SSL context.

Netty has the ability to use OpenSSL if available, instead of the JDK's built-in engine. This yields better performance.

Since:

3.2.0

See Also:

JAVA-1364

Field Summary

Fields inherited from class com.datastax.driver.core.NettySSLOptions

context

Constructor Summary

Constructors

Constructor and Description
RemoteEndpointAwareNettySSLOptions(io.netty.handler.ssl.SslContext context) Create a new instance from a given context.

Method Summary

Modifier and Type	Method and Description
io.netty.handler.ssl.SslHandler	newSSLHandler(io.netty.channel.socket.SocketChannel channel) Creates a new SSL handler for the given Netty channel.
io.netty.handler.ssl.SslHandler	newSSLHandler(io.netty.channel.socket.SocketChannel channel, EndPoint remoteEndpoint) Creates a new SSL handler for the given Netty channel and the given remote endpoint.
io.netty.handler.ssl.SslHandler	newSSLHandler(io.netty.channel.socket.SocketChannel channel, InetSocketAddress remoteEndpoint) Creates a new SSL handler for the given Netty channel and the given remote endpoint.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteEndpointAwareNettySSLOptions

public RemoteEndpointAwareNettySSLOptions(io.netty.handler.ssl.SslContext context)

Create a new instance from a given context.

Parameters:

context - the Netty context. SslContextBuilder.forClient() provides a fluent API to build it.

Method Detail

newSSLHandler

public io.netty.handler.ssl.SslHandler newSSLHandler(io.netty.channel.socket.SocketChannel channel)

Description copied from interface: SSLOptions

Creates a new SSL handler for the given Netty channel.

This gets called each time the driver opens a new connection to a Cassandra host. The newly created handler will be added to the channel's pipeline to provide SSL support for the connection.

You don't necessarily need to implement this method directly; see the provided implementations: JdkSSLOptions and NettySSLOptions.

Specified by:

newSSLHandler in interface SSLOptions

Overrides:

newSSLHandler in class NettySSLOptions

Parameters:

channel - the channel.

Returns:

the handler.

newSSLHandler

public io.netty.handler.ssl.SslHandler newSSLHandler(io.netty.channel.socket.SocketChannel channel,
                                                     EndPoint remoteEndpoint)

Description copied from interface: ExtendedRemoteEndpointAwareSslOptions

Creates a new SSL handler for the given Netty channel and the given remote endpoint.

This gets called each time the driver opens a new connection to a Cassandra host. The newly created handler will be added to the channel's pipeline to provide SSL support for the connection.

You don't necessarily need to implement this method directly; see the provided implementations: RemoteEndpointAwareJdkSSLOptions and RemoteEndpointAwareNettySSLOptions.

Specified by:

newSSLHandler in interface ExtendedRemoteEndpointAwareSslOptions

Parameters:

channel - the channel.

remoteEndpoint - the remote endpoint information.

Returns:

a newly-created SslHandler.

newSSLHandler

public io.netty.handler.ssl.SslHandler newSSLHandler(io.netty.channel.socket.SocketChannel channel,
                                                     InetSocketAddress remoteEndpoint)

Description copied from interface: RemoteEndpointAwareSSLOptions

Creates a new SSL handler for the given Netty channel and the given remote endpoint.

This gets called each time the driver opens a new connection to a Cassandra host. The newly created handler will be added to the channel's pipeline to provide SSL support for the connection.

You don't necessarily need to implement this method directly; see the provided implementations: RemoteEndpointAwareJdkSSLOptions and RemoteEndpointAwareNettySSLOptions.

Specified by:

newSSLHandler in interface RemoteEndpointAwareSSLOptions

Parameters:

channel - the channel.

remoteEndpoint - the remote endpoint address.

Returns:

a newly-created SslHandler.