me.melchor9000.net

Class SSLAcceptor

java.lang.Object

me.melchor9000.net.Acceptor<TCPSocket>

me.melchor9000.net.TCPAcceptor

me.melchor9000.net.SSLAcceptor

All Implemented Interfaces:

java.lang.AutoCloseable

public class SSLAcceptor
extends TCPAcceptor

Accepts SSL connections, and creates SSLSocket for any new one, using a public and private keys.

SSL servers uses a public and private keys (with a public certificate and a private key both in .pem format) to identify itself and cipher all data during a connection. You can provide both certificates using File objects or InputStreams.

A SSLAcceptor is just a layer over a TCPAcceptor, the full documentation will be found in TCPAcceptor and Acceptor. All sockets will be of type SSLSocket.

Note for Android: An SSL Acceptor in Android will fail its creation. In general, use a Server in an Android app could lead into problems. If you need one, your solution could be create the acceptor using these constructors SSLAcceptor(IOService, SSLAcceptorConfigurator) or SSLAcceptor(IOService, IOService, SSLAcceptorConfigurator). See SSLSocket documentation to give you a clue that could help you to make the custom configuration for Android.

Field Summary

Fields inherited from class me.melchor9000.net.Acceptor

bootstrap, channel, onConnection, service

Constructor Summary

Constructors

Constructor and Description
SSLAcceptor(IOService service, java.io.File publicKey, java.io.File privateKey) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, java.io.File publicKey, java.io.File privateKey, java.lang.String password) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, java.io.InputStream publicKey, java.io.InputStream privateKey) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, java.io.InputStream publicKey, java.io.InputStream privateKey, java.lang.String password) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, IOService worker, java.io.File publicKey, java.io.File privateKey) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, IOService worker, java.io.File publicKey, java.io.File privateKey, java.lang.String password) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, IOService worker, java.io.InputStream publicKey, java.io.InputStream privateKey) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, IOService worker, java.io.InputStream publicKey, java.io.InputStream privateKey, java.lang.String password) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, IOService worker, SSLAcceptorConfigurator configurator) Creates a SSL acceptor for server applications.
SSLAcceptor(IOService service, SSLAcceptorConfigurator configurator) Creates a SSL acceptor for server applications.

Method Summary

Modifier and Type	Method and Description
protected TCPSocket	createSocketForImplementation(io.netty.channel.socket.SocketChannel ch)

Methods inherited from class me.melchor9000.net.TCPAcceptor

acceptAsync, pendingConnections, setOnConnectionListener

Methods inherited from class me.melchor9000.net.Acceptor

accept, bind, bind, bind, checkSocketCreated, close, closeAsync, createFuture, createFuture, onClose, setChildOption, setOption, waitForClose

Methods inherited from class java.lang.Object

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

Constructor Detail

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   java.io.File publicKey,
                   @NotNull
                   java.io.File privateKey)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private must not have a passphrase.

Parameters:

service - IOService for the acceptor and the sockets

publicKey - a File to the public certificate in .pem format

privateKey - a File to the public certificate in .pem format

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   java.io.InputStream publicKey,
                   @NotNull
                   java.io.InputStream privateKey)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private must not have a passphrase.

Parameters:

service - IOService for the acceptor and the sockets

publicKey - a InputStream to the public certificate in .pem format

privateKey - a InputStream to the public certificate in .pem format

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   java.io.File publicKey,
                   @NotNull
                   java.io.File privateKey,
                   java.lang.String password)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private one has a passphrase.

Parameters:

service - IOService for the acceptor and the sockets

publicKey - a File to the public certificate in .pem format

privateKey - a File to the public certificate in .pem format

password - the private key passphrase

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   java.io.InputStream publicKey,
                   @NotNull
                   java.io.InputStream privateKey,
                   java.lang.String password)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private one has a passphrase.

Parameters:

service - IOService for the acceptor and the sockets

publicKey - a InputStream to the public certificate in .pem format

privateKey - a InputStream to the public certificate in .pem format

password - the private key passphrase

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   IOService worker,
                   @NotNull
                   java.io.File publicKey,
                   @NotNull
                   java.io.File privateKey)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private must not have a passphrase.

Parameters:

service - IOService for the acceptor

worker - IOService for the sockets

publicKey - a File to the public certificate in .pem format

privateKey - a File to the public certificate in .pem format

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   IOService worker,
                   @NotNull
                   java.io.InputStream publicKey,
                   @NotNull
                   java.io.InputStream privateKey)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private must not have a passphrase.

Parameters:

service - IOService for the acceptor

worker - IOService for the sockets

publicKey - a InputStream to the public certificate in .pem format

privateKey - a InputStream to the public certificate in .pem format

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   IOService worker,
                   @NotNull
                   java.io.File publicKey,
                   @NotNull
                   java.io.File privateKey,
                   java.lang.String password)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private one has a passphrase.

Parameters:

service - IOService for the acceptor

worker - IOService for the sockets

publicKey - a File to the public certificate in .pem format

privateKey - a File to the public certificate in .pem format

password - the private key passphrase

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   IOService worker,
                   @NotNull
                   java.io.InputStream publicKey,
                   @NotNull
                   java.io.InputStream privateKey,
                   java.lang.String password)

Creates a SSL acceptor for server applications. Uses a public and private certificates, and the private one has a passphrase.

Parameters:

service - IOService for the acceptor

worker - IOService for the sockets

publicKey - a InputStream to the public certificate in .pem format

privateKey - a InputStream to the public certificate in .pem format

password - the private key passphrase

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   SSLAcceptorConfigurator configurator)

Creates a SSL acceptor for server applications. Uses custom configuration for the SSLSocket done by the SSLAcceptorConfigurator implementation.

Parameters:

service - IOService for the acceptor and the sockets

configurator - Allows custom configuration for the SSLSockets

SSLAcceptor

public SSLAcceptor(@NotNull
                   IOService service,
                   @NotNull
                   IOService worker,
                   @NotNull
                   SSLAcceptorConfigurator configurator)

Creates a SSL acceptor for server applications. Uses custom configuration for the SSLSocket done by the SSLAcceptorConfigurator implementation.

Parameters:

service - IOService for the acceptor

worker - IOService for the sockets

configurator - Allows custom configuration for the SSLSockets

Method Detail

createSocketForImplementation

@NotNull
protected TCPSocket createSocketForImplementation(@NotNull
                                                           io.netty.channel.socket.SocketChannel ch)
                                                    throws java.io.IOException

Overrides:

createSocketForImplementation in class TCPAcceptor

Throws:

java.io.IOException