gov.nist.javax.sip.stack

Class SSLStateMachine

java.lang.Object

gov.nist.javax.sip.stack.SSLStateMachine

public class SSLStateMachine
extends Object

This is a helper state machine that negotiates the SSL connection automatically without ever blocking any threads. It is important not to block here because the TLS may occur in the selector thread which is one per all sockets. Other than that the state machine is able to handle partial chunks of SIP messages and only supply them when they are ready to the original TCP channel once they are decrypted.

Author:

vladimirralev

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SSLStateMachine.MessageSendCallback
static class	SSLStateMachine.MessageSendItem Each time we send a SIP message it will be associated with the originating channel.send() method which keep additional information about the transport in its context.

Field Summary

Fields

Modifier and Type	Field and Description
protected NioTlsChannelInterface	channel
static ByteBuffer	EMPTY_BUFFER
protected Queue<SSLStateMachine.MessageSendItem>	pendingOutboundBuffers
protected SSLEngine	sslEngine
protected ByteBuffer	tlsRecordBuffer

Constructor Summary

Constructors

Constructor and Description
SSLStateMachine(SSLEngine sslEngine, NioTlsChannelInterface channel)

Method Summary

Methods

Modifier and Type	Method and Description
void	sendSSLMetadata(byte[] msg)
void	unwrap(ByteBuffer src)
void	wrap(ByteBuffer src, ByteBuffer dst, SSLStateMachine.MessageSendCallback callback)
void	wrapRemaining()

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_BUFFER

public static final ByteBuffer EMPTY_BUFFER

sslEngine

protected SSLEngine sslEngine

pendingOutboundBuffers

protected Queue<SSLStateMachine.MessageSendItem> pendingOutboundBuffers

channel

protected NioTlsChannelInterface channel

tlsRecordBuffer

protected ByteBuffer tlsRecordBuffer

Constructor Detail

SSLStateMachine

public SSLStateMachine(SSLEngine sslEngine,
               NioTlsChannelInterface channel)

Method Detail

wrapRemaining

public void wrapRemaining()
                   throws IOException

Throws:

IOException

wrap

public void wrap(ByteBuffer src,
        ByteBuffer dst,
        SSLStateMachine.MessageSendCallback callback)
          throws IOException

Throws:

IOException

unwrap

public void unwrap(ByteBuffer src)
            throws Exception

Throws:

Exception

sendSSLMetadata

public void sendSSLMetadata(byte[] msg)
                     throws IOException

Throws:

IOException