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 and Description
java.lang.String	getApplicationProtocol()
BCApplicationProtocolSelector<javax.net.ssl.SSLSocket>	getBCHandshakeApplicationProtocolSelector()
BCExtendedSSLSession	getBCHandshakeSession()
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	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

getApplicationProtocol

java.lang.String getApplicationProtocol()

getBCHandshakeApplicationProtocolSelector

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

setBCHandshakeApplicationProtocolSelector

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

getBCHandshakeSession

BCExtendedSSLSession getBCHandshakeSession()

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