Package org.bouncycastle.jsse

Interface BCSSLSocket

public interface BCSSLSocket

A BCJSSE-specific interface to expose extended functionality on SSLSocket implementations.

Method Summary

Modifier and Type	Method	Description
void	connect(java.lang.String host, int port, int timeout)
java.lang.String	getApplicationProtocol()
BCApplicationProtocolSelector<javax.net.ssl.SSLSocket>	getBCHandshakeApplicationProtocolSelector()
BCExtendedSSLSession	getBCHandshakeSession()
BCExtendedSSLSession	getBCSession()
BCSSLConnection	getConnection()	Returns an accessor for extended SSL connection data.
java.lang.String	getHandshakeApplicationProtocol()
BCSSLParameters	getParameters()	Returns a BCSSLParameters with properties reflecting the current configuration.
void	setBCHandshakeApplicationProtocolSelector(BCApplicationProtocolSelector<javax.net.ssl.SSLSocket> selector)
void	setBCSessionToResume(BCExtendedSSLSession session)
void	setHost(java.lang.String host)	Allows explicit setting of the 'host' String when the SocketFactory methods that include it as an argument are not used.
void	setParameters(BCSSLParameters parameters)	Sets parameters according to the properties in a BCSSLParameters.

Method Detail

connect

void connect(java.lang.String host,
             int port,
             int timeout)
      throws java.io.IOException

Throws:

java.io.IOException

getApplicationProtocol

java.lang.String getApplicationProtocol()

getBCHandshakeApplicationProtocolSelector

BCApplicationProtocolSelector<javax.net.ssl.SSLSocket> getBCHandshakeApplicationProtocolSelector()

setBCHandshakeApplicationProtocolSelector

void setBCHandshakeApplicationProtocolSelector(BCApplicationProtocolSelector<javax.net.ssl.SSLSocket> selector)

setBCSessionToResume

void setBCSessionToResume(BCExtendedSSLSession session)

getBCHandshakeSession

BCExtendedSSLSession getBCHandshakeSession()

getBCSession

BCExtendedSSLSession getBCSession()

getConnection

BCSSLConnection getConnection()

Returns an accessor for extended SSL connection data. This method will initiate the initial handshake if necessary and then block until the handshake has been established. If an error occurs during the initial handshake, this method returns null.

Returns:

A BCSSLConnection instance.

getHandshakeApplicationProtocol

java.lang.String getHandshakeApplicationProtocol()

getParameters

BCSSLParameters getParameters()

Returns a BCSSLParameters with properties reflecting the current configuration.

Returns:

the current parameters

setHost

void setHost(java.lang.String host)

Allows explicit setting of the 'host' String when the SocketFactory methods that include it as an argument are not used.

Must be called prior to attempting to connect the socket to have any effect.

Parameters:

host - the server host name with which to connect, or null for the loopback address.

setParameters

void setParameters(BCSSLParameters parameters)

Sets parameters according to the properties in a BCSSLParameters.

Note that any properties set to null will be ignored, which will leave the corresponding settings unchanged.

Parameters:

parameters - the parameters to set

Throws:

java.lang.IllegalArgumentException - if the cipherSuites or protocols properties contain unsupported values