Package org.apache.qpid.protonj2.client.transport

Class SslSupport

java.lang.Object

org.apache.qpid.protonj2.client.transport.SslSupport

public class SslSupport
extends Object

Static class that provides various utility methods used by Transport implementations.

Constructor Summary

Constructors

Constructor	Description
SslSupport()

Method Summary

Modifier and Type	Method	Description
static SSLContext	createJdkSslContext(SslOptions options)	Create a new SSLContext using the options specific in the given TransportOptions instance.
static SSLEngine	createJdkSslEngine(String host, int port, SSLContext context, SslOptions options)	Create a new JDK SSLEngine instance in client mode from the given SSLContext and TransportOptions instances.
static io.netty.handler.ssl.SslContext	createOpenSslContext(SslOptions options)	Create a new Netty SslContext using the options specific in the given TransportOptions instance.
static SSLEngine	createOpenSslEngine(io.netty.buffer.ByteBufAllocator allocator, String host, int port, io.netty.handler.ssl.SslContext context, SslOptions options)	Create a new OpenSSL SSLEngine instance in client mode from the given SSLContext and TransportOptions instances.
static io.netty.handler.ssl.SslHandler	createSslHandler(io.netty.buffer.ByteBufAllocator allocator, String host, int port, SslOptions options)	Creates a Netty SslHandler instance for use in Transports that require an SSL encoder / decoder.
static boolean	isOpenSSLPossible(SslOptions options)	Determines if Netty OpenSSL support is available and applicable based on the configuration in the given TransportOptions instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

SslSupport

public SslSupport()

Method Detail

isOpenSSLPossible

public static boolean isOpenSSLPossible(SslOptions options)

Determines if Netty OpenSSL support is available and applicable based on the configuration in the given TransportOptions instance.

Parameters:

options - The configuration of the Transport being created.

Returns:

true if OpenSSL support is available and usable given the requested configuration.

createSslHandler

public static io.netty.handler.ssl.SslHandler createSslHandler(io.netty.buffer.ByteBufAllocator allocator,
                                                               String host,
                                                               int port,
                                                               SslOptions options)
                                                        throws Exception

Creates a Netty SslHandler instance for use in Transports that require an SSL encoder / decoder. If the given options contain an SSLContext override, this will be used directly when creating the handler. If they do not, an SSLContext will first be created using the other option values.

Parameters:

allocator - The Netty Buffer Allocator to use when Netty resources need to be created.

host - the host name or IP address that this transport connects to.

port - the port on the given host that this transport connects to.

options - The SSL options object to build the SslHandler instance from.

Returns:

a new SslHandler that is configured from the given options.

Throws:

Exception - if an error occurs while creating the SslHandler instance.

createJdkSslContext

public static SSLContext createJdkSslContext(SslOptions options)
                                      throws Exception

Create a new SSLContext using the options specific in the given TransportOptions instance.

Parameters:

options - the configured options used to create the SSLContext.

Returns:

a new SSLContext instance.

Throws:

Exception - if an error occurs while creating the context.

createJdkSslEngine

public static SSLEngine createJdkSslEngine(String host,
                                           int port,
                                           SSLContext context,
                                           SslOptions options)
                                    throws Exception

Create a new JDK SSLEngine instance in client mode from the given SSLContext and TransportOptions instances.

Parameters:

host - the host name or IP address that this transport connects to.

port - the port on the given host that this transport connects to.

context - the SSLContext to use when creating the engine.

options - the TransportOptions to use to configure the new SSLEngine.

Returns:

a new SSLEngine instance in client mode.

Throws:

Exception - if an error occurs while creating the new SSLEngine.

createOpenSslContext

public static io.netty.handler.ssl.SslContext createOpenSslContext(SslOptions options)
                                                            throws Exception

Create a new Netty SslContext using the options specific in the given TransportOptions instance.

Parameters:

options - the configured options used to create the SslContext.

Returns:

a new SslContext instance.

Throws:

Exception - if an error occurs while creating the context.

createOpenSslEngine

public static SSLEngine createOpenSslEngine(io.netty.buffer.ByteBufAllocator allocator,
                                            String host,
                                            int port,
                                            io.netty.handler.ssl.SslContext context,
                                            SslOptions options)
                                     throws Exception

Create a new OpenSSL SSLEngine instance in client mode from the given SSLContext and TransportOptions instances.

Parameters:

allocator - the Netty ByteBufAllocator to use to create the OpenSSL engine

host - the host name or IP address that this transport connects to.

port - the port on the given host that this transport connects to.

context - the Netty SslContext to use when creating the engine.

options - the TransportOptions to use to configure the new SSLEngine.

Returns:

a new Netty managed SSLEngine instance in client mode.

Throws:

Exception - if an error occurs while creating the new SSLEngine.