Package org.conscrypt

Class SSLSocketImpl

java.lang.Object

java.net.Socket

javax.net.ssl.SSLSocket

org.conscrypt.SSLSocketImpl

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

SSLSocketWrapper

public class SSLSocketImpl
extends SSLSocket

SSLSocket implementation.

See Also:

class documentation for more information.

Field Summary

Fields

Modifier and Type	Field	Description
protected InputStream	input
protected OutputStream	output
protected SSLRecordProtocol	recordProtocol
protected SSLParametersImpl	sslParameters

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SSLSocketImpl(String host, int port, InetAddress localHost, int localPort, SSLParametersImpl sslParameters)	Constructor
protected	SSLSocketImpl(String host, int port, SSLParametersImpl sslParameters)	Constructor
protected	SSLSocketImpl(InetAddress address, int port, InetAddress localAddress, int localPort, SSLParametersImpl sslParameters)	Constructor
protected	SSLSocketImpl(InetAddress host, int port, SSLParametersImpl sslParameters)	Constructor
protected	SSLSocketImpl(SSLParametersImpl sslParameters)	Constructor

Method Summary

Modifier and Type	Method	Description
void	addHandshakeCompletedListener(HandshakeCompletedListener listener)	This method works according to the specification of implemented class.
void	close()	This method works according to the specification of implemented class.
protected void	closeTransportLayer()	Closes the transport data streams.
void	connect(SocketAddress endpoint)	This method works according to the specification of implemented class.
void	connect(SocketAddress endpoint, int timeout)	This method works according to the specification of implemented class.
String[]	getEnabledCipherSuites()	This method works according to the specification of implemented class.
String[]	getEnabledProtocols()	This method works according to the specification of implemented class.
boolean	getEnableSessionCreation()	This method works according to the specification of implemented class.
InputStream	getInputStream()	This method works according to the specification of implemented class.
boolean	getNeedClientAuth()	This method works according to the specification of implemented class.
OutputStream	getOutputStream()	This method works according to the specification of implemented class.
SSLSession	getSession()	This method works according to the specification of implemented class.
String[]	getSupportedCipherSuites()	This method works according to the specification of implemented class.
String[]	getSupportedProtocols()	This method works according to the specification of implemented class.
boolean	getUseClientMode()	This method works according to the specification of implemented class.
boolean	getWantClientAuth()	This method works according to the specification of implemented class.
protected void	init()	Initialize the SSL socket.
protected void	initTransportLayer()	Initialize the transport data streams.
protected void	needAppData()	This method is called by SSLSocketInputStream class when client application tries to read application data from the stream, but there is no data in its underlying buffer.
void	removeHandshakeCompletedListener(HandshakeCompletedListener listener)	This method works according to the specification of implemented class.
void	sendUrgentData(int data)	This method is not supported for SSLSocket implementation.
void	setEnabledCipherSuites(String[] suites)	This method works according to the specification of implemented class.
void	setEnabledProtocols(String[] protocols)	This method works according to the specification of implemented class.
void	setEnableSessionCreation(boolean flag)	This method works according to the specification of implemented class.
void	setNeedClientAuth(boolean need)	This method works according to the specification of implemented class.
void	setOOBInline(boolean on)	This method is not supported for SSLSocket implementation.
void	setUseClientMode(boolean mode)	This method works according to the specification of implemented class.
void	setWantClientAuth(boolean want)	This method works according to the specification of implemented class.
void	startHandshake()	Performs the handshake process over the SSL/TLS connection as described in rfc 2246, TLS v1 specification http://www.ietf.org/rfc/rfc2246.txt.
protected void	writeAppData(byte[] data, int offset, int len)	This method is called by SSLSocketOutputStream when a client application tries to send the data over ssl protocol.

Methods inherited from class javax.net.ssl.SSLSocket

getSSLParameters, setSSLParameters, shutdownInput, shutdownOutput

Methods inherited from class java.net.Socket

bind, getChannel, getFileDescriptor$, getInetAddress, getKeepAlive, getLocalAddress, getLocalPort, getLocalSocketAddress, getOOBInline, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoLinger, getSoTimeout, getTcpNoDelay, getTrafficClass, isBound, isClosed, isConnected, isInputShutdown, isOutputShutdown, setKeepAlive, setPerformancePreferences, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSocketImplFactory, setSoLinger, setSoTimeout, setTcpNoDelay, setTrafficClass, toString

Methods inherited from class java.lang.Object

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

Field Details

recordProtocol

protected SSLRecordProtocol recordProtocol

sslParameters

protected SSLParametersImpl sslParameters

input

protected InputStream input

output

protected OutputStream output

Constructor Details

SSLSocketImpl

protected SSLSocketImpl(SSLParametersImpl sslParameters)

Constructor

Parameters:

sslParameters - : SSLParametersImpl

See Also:

method documentation for more information.

SSLSocketImpl

protected SSLSocketImpl(String host,
int port,
SSLParametersImpl sslParameters)
                 throws IOException,
UnknownHostException

Constructor

Parameters:

host - : String

port - : int

sslParameters - : SSLParametersImpl

Throws:

IOException

UnknownHostException

See Also:

method documentation for more information.

SSLSocketImpl

protected SSLSocketImpl(String host,
int port,
InetAddress localHost,
int localPort,
SSLParametersImpl sslParameters)
                 throws IOException,
UnknownHostException

Constructor

Parameters:

host - : String

port - : int

localHost - : InetAddress

localPort - : int

sslParameters - : SSLParametersImpl

Throws:

IOException

UnknownHostException

See Also:

method documentation for more information.

SSLSocketImpl

protected SSLSocketImpl(InetAddress host,
int port,
SSLParametersImpl sslParameters)
                 throws IOException

Constructor

Parameters:

host - : InetAddress

port - : int

sslParameters - : SSLParametersImpl

Throws:

IOException

See Also:

method documentation for more information.

SSLSocketImpl

protected SSLSocketImpl(InetAddress address,
int port,
InetAddress localAddress,
int localPort,
SSLParametersImpl sslParameters)
                 throws IOException

Constructor

Parameters:

address - : InetAddress

port - : int

localAddress - : InetAddress

localPort - : int

sslParameters - : SSLParametersImpl

Throws:

IOException

See Also:

method documentation for more information.

Method Details

init

protected void init()
             throws IOException

Initialize the SSL socket.

Throws:

IOException

initTransportLayer

protected void initTransportLayer()
                           throws IOException

Initialize the transport data streams.

Throws:

IOException

closeTransportLayer

protected void closeTransportLayer()
                            throws IOException

Closes the transport data streams.

Throws:

IOException

getSupportedCipherSuites

public String[] getSupportedCipherSuites()

This method works according to the specification of implemented class.

Specified by:

getSupportedCipherSuites in class SSLSocket

See Also:

method documentation for more information

getEnabledCipherSuites

public String[] getEnabledCipherSuites()

This method works according to the specification of implemented class.

Specified by:

getEnabledCipherSuites in class SSLSocket

See Also:

method documentation for more information

setEnabledCipherSuites

public void setEnabledCipherSuites(String[] suites)

This method works according to the specification of implemented class.

Specified by:

setEnabledCipherSuites in class SSLSocket

Parameters:

suites - the names of the to be enabled cipher suites.

See Also:

method documentation for more information

getSupportedProtocols

public String[] getSupportedProtocols()

This method works according to the specification of implemented class.

Specified by:

getSupportedProtocols in class SSLSocket

See Also:

method documentation for more information

getEnabledProtocols

public String[] getEnabledProtocols()

This method works according to the specification of implemented class.

Specified by:

getEnabledProtocols in class SSLSocket

See Also:

method documentation for more information

setEnabledProtocols

public void setEnabledProtocols(String[] protocols)

This method works according to the specification of implemented class.

Specified by:

setEnabledProtocols in class SSLSocket

Parameters:

protocols - the names of the to be enabled protocols.

See Also:

method documentation for more information

setUseClientMode

public void setUseClientMode(boolean mode)

This method works according to the specification of implemented class.

Specified by:

setUseClientMode in class SSLSocket

Parameters:

mode - true if this connection should act in client mode, false if not.

See Also:

method documentation for more information

getUseClientMode

public boolean getUseClientMode()

This method works according to the specification of implemented class.

Specified by:

getUseClientMode in class SSLSocket

See Also:

method documentation for more information

setNeedClientAuth

public void setNeedClientAuth(boolean need)

This method works according to the specification of implemented class.

Specified by:

setNeedClientAuth in class SSLSocket

See Also:

method documentation for more information

getNeedClientAuth

public boolean getNeedClientAuth()

This method works according to the specification of implemented class.

Specified by:

getNeedClientAuth in class SSLSocket

See Also:

method documentation for more information

setWantClientAuth

public void setWantClientAuth(boolean want)

This method works according to the specification of implemented class.

Specified by:

setWantClientAuth in class SSLSocket

See Also:

method documentation for more information

getWantClientAuth

public boolean getWantClientAuth()

This method works according to the specification of implemented class.

Specified by:

getWantClientAuth in class SSLSocket

See Also:

method documentation for more information

setEnableSessionCreation

public void setEnableSessionCreation(boolean flag)

This method works according to the specification of implemented class.

Specified by:

setEnableSessionCreation in class SSLSocket

Parameters:

flag - true if new sessions may be created.

See Also:

method documentation for more information

getEnableSessionCreation

public boolean getEnableSessionCreation()

This method works according to the specification of implemented class.

Specified by:

getEnableSessionCreation in class SSLSocket

Returns:

true if new sessions may be created, otherwise false.

See Also:

method documentation for more information

getSession

public SSLSession getSession()

This method works according to the specification of implemented class.

Specified by:

getSession in class SSLSocket

Returns:

the session object.

See Also:

method documentation for more information

addHandshakeCompletedListener

public void addHandshakeCompletedListener(HandshakeCompletedListener listener)

This method works according to the specification of implemented class.

Specified by:

addHandshakeCompletedListener in class SSLSocket

Parameters:

listener - the listener to register.

See Also:

method documentation for more information

removeHandshakeCompletedListener

public void removeHandshakeCompletedListener(HandshakeCompletedListener listener)

This method works according to the specification of implemented class.

Specified by:

removeHandshakeCompletedListener in class SSLSocket

Parameters:

listener - the listener to remove.

See Also:

method documentation for more information

startHandshake

public void startHandshake()
                    throws IOException

Performs the handshake process over the SSL/TLS connection as described in rfc 2246, TLS v1 specification http://www.ietf.org/rfc/rfc2246.txt. If the initial handshake has been already done, this method initiates rehandshake. This method works according to the specification of implemented class.

Specified by:

startHandshake in class SSLSocket

Throws:

IOException - if an error occurs.

See Also:

method documentation for more information

getInputStream

public InputStream getInputStream()
                           throws IOException

This method works according to the specification of implemented class.

Overrides:

getInputStream in class Socket

Returns:

the byte-oriented input stream.

Throws:

IOException - if an error occurs while creating the input stream or the socket is in an invalid state.

See Also:

method documentation for more information

getOutputStream

public OutputStream getOutputStream()
                             throws IOException

This method works according to the specification of implemented class.

Overrides:

getOutputStream in class Socket

Returns:

the byte-oriented output stream.

Throws:

IOException - if an error occurs while creating the output stream or the socket is in an invalid state.

See Also:

method documentation for more information

connect

public void connect(SocketAddress endpoint)
             throws IOException

This method works according to the specification of implemented class.

Overrides:

connect in class Socket

Parameters:

endpoint - the address and port of the remote host to connect to.

Throws:

IOException - if the socket is already connected or an error occurs while connecting.

See Also:

method documentation for more information

connect

public void connect(SocketAddress endpoint,
int timeout)
             throws IOException

This method works according to the specification of implemented class.

Overrides:

connect in class Socket

Parameters:

endpoint - the address and port of the remote host to connect to.

timeout - the timeout value in milliseconds or 0 for an infinite timeout.

Throws:

IOException - if the socket is already connected or an error occurs while connecting.

See Also:

method documentation for more information

close

public void close()
           throws IOException

This method works according to the specification of implemented class.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class Socket

Throws:

IOException - if an error occurs while closing the socket.

See Also:

method documentation for more information

sendUrgentData

public void sendUrgentData(int data)
                    throws IOException

This method is not supported for SSLSocket implementation.

Overrides:

sendUrgentData in class Socket

Parameters:

data - the byte of urgent data to be sent.

Throws:

IOException - if an error occurs while sending urgent data.

setOOBInline

public void setOOBInline(boolean on)
                  throws SocketException

This method is not supported for SSLSocket implementation.

Overrides:

setOOBInline in class Socket

Throws:

SocketException

needAppData

protected void needAppData()
                    throws IOException

This method is called by SSLSocketInputStream class when client application tries to read application data from the stream, but there is no data in its underlying buffer.

Throws:

IOException

writeAppData

protected void writeAppData(byte[] data,
int offset,
int len)
                     throws IOException

This method is called by SSLSocketOutputStream when a client application tries to send the data over ssl protocol.

Throws:

IOException