com.maverick.nio.ssl

Class SSLContextConnection

java.lang.Object

com.maverick.nio.SocketConnection

com.maverick.nio.ssl.SSLContextConnection

All Implemented Interfaces:

SelectionKeyAware, SelectorRegistrationListener, SocketHandler

public class SSLContextConnection
extends SocketConnection

This class implements an SSL socket connection for the custom server. Using the Java 1.5 SSLEngine class this implementation wraps all protocol traffic into SSL records.

Version:

$Revision: 1.4 $

Author:

Lee David Painter

Field Summary

Fields inherited from class com.maverick.nio.SocketConnection

closed, daemon, daemonContext, key, localAddr, localPort, protocolEngine, remoteAddr, remotePort, selectorThread, socketChannel, socketDataIn, socketDataOut

Constructor Summary

Constructors

Constructor and Description
SSLContextConnection() Default constructor.
SSLContextConnection(boolean allowClientCertificate, boolean requireClientCertificate)

Method Summary

Modifier and Type	Method and Description
static SSLContext	getSSLContext() Get the SSL context.
static void	initializeSSL() Initialize SSL.
boolean	isConnected() Is the socket still connected? During the initial handshake check the raw socket status, otherwise check the protocol status.
protected boolean	isDeferredConnectEvent()
boolean	processReadEvent() This method is called when new network data arrives on the socket.
boolean	processWriteEvent() Write any application data to the socket by wrapping it up into the SSL protocol.
void	registrationCompleted(SelectableChannel channel, SelectionKey key) This method is called once the socket is registered with a SelectorThread.
static void	setEnabledCipherSuites(String[] aCipherSuites)
static void	setEnabledProtocols(String[] aProtocols)

Methods inherited from class com.maverick.nio.SocketConnection

closeConnection, getDaemonContext, getIdleStates, getInterestedOps, getLocalAddress, getLocalPort, getPort, getProtocolEngine, getRemoteAddress, getSocketChannel, getThread, getUuid, initialize, isSelectorThread, setSelectionKey, setThread, setWriteState

Methods inherited from class java.lang.Object

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

Constructor Detail

SSLContextConnection

public SSLContextConnection()

Default constructor. We need one of these so we can dynamically create a SocketConnection on demand.

SSLContextConnection

public SSLContextConnection(boolean allowClientCertificate,
                            boolean requireClientCertificate)

Method Detail

registrationCompleted

public void registrationCompleted(SelectableChannel channel,
                                  SelectionKey key)

This method is called once the socket is registered with a SelectorThread. At this point we're ready to start transfering data.

Specified by:

registrationCompleted in interface SelectorRegistrationListener

Overrides:

registrationCompleted in class SocketConnection

Parameters:

channel - SelectableChannel

key - SelectionKey

selectorThread - SelectorThread

isDeferredConnectEvent

protected boolean isDeferredConnectEvent()

Overrides:

isDeferredConnectEvent in class SocketConnection

getSSLContext

public static SSLContext getSSLContext()
                                throws IOException

Get the SSL context. If SSL isn't initialized when this is called we initialize it.

Returns:

SSLContext

Throws:

Exception

IOException

initializeSSL

public static void initializeSSL()
                          throws FileNotFoundException,
                                 IOException

Initialize SSL. If at all possible this should be called before any connection attempts are made.

Throws:

FileNotFoundException

IOException

isConnected

public boolean isConnected()

Is the socket still connected? During the initial handshake check the raw socket status, otherwise check the protocol status.

Overrides:

isConnected in class SocketConnection

Returns:

boolean

processReadEvent

public boolean processReadEvent()

This method is called when new network data arrives on the socket. We have to unwrap any SSL traffic into raw application data

Specified by:

processReadEvent in interface SocketHandler

Overrides:

processReadEvent in class SocketConnection

Parameters:

applicationData - ByteBuffer

Returns:

boolean

processWriteEvent

public boolean processWriteEvent()

Write any application data to the socket by wrapping it up into the SSL protocol.

Specified by:

processWriteEvent in interface SocketHandler

Overrides:

processWriteEvent in class SocketConnection

Parameters:

applicationData - ByteBuffer

Returns:

boolean

setEnabledProtocols

public static void setEnabledProtocols(String[] aProtocols)

setEnabledCipherSuites

public static void setEnabledCipherSuites(String[] aCipherSuites)