com.tencent.kona.sun.security.ssl

Class SSLSocketFactoryImpl

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

com.tencent.kona.sun.security.ssl.SSLSocketFactoryImpl

public final class SSLSocketFactoryImpl
extends javax.net.ssl.SSLSocketFactory

Implementation of an SSL socket factory. This provides the public hooks to create SSL sockets, using a "high level" programming interface which encapsulates system security policy defaults rather than offering application flexibility. In particular, it uses a configurable authentication context (and the keys held there) rather than offering any flexibility about which keys to use; that context defaults to the process-default context, but may be explicitly specified.

Constructor Summary

Constructors

Constructor and Description
SSLSocketFactoryImpl() Constructor used to instantiate the default factory.

Method Summary

Modifier and Type	Method and Description
java.net.Socket	createSocket() Creates an unconnected socket.
java.net.Socket	createSocket(java.net.InetAddress address, int port) Constructs an SSL connection to a server at a specified address and TCP port.
java.net.Socket	createSocket(java.net.InetAddress address, int port, java.net.InetAddress clientAddress, int clientPort) Constructs an SSL connection to a server at a specified address and TCP port.
java.net.Socket	createSocket(java.net.Socket s, java.io.InputStream consumed, boolean autoClose)
java.net.Socket	createSocket(java.net.Socket s, java.lang.String host, int port, boolean autoClose) Returns a socket layered over an existing socket to a ServerSocket on the named host, at the given port.
java.net.Socket	createSocket(java.lang.String host, int port) Constructs an SSL connection to a named host at a specified port.
java.net.Socket	createSocket(java.lang.String host, int port, java.net.InetAddress clientAddress, int clientPort) Constructs an SSL connection to a named host at a specified port.
java.lang.String[]	getDefaultCipherSuites() Returns the subset of the supported cipher suites which are enabled by default.
java.lang.String[]	getSupportedCipherSuites() Returns the names of the cipher suites which could be enabled for use on an SSL connection.

Methods inherited from class javax.net.ssl.SSLSocketFactory

getDefault

Methods inherited from class java.lang.Object

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

Constructor Detail

SSLSocketFactoryImpl

public SSLSocketFactoryImpl()
                     throws java.lang.Exception

Constructor used to instantiate the default factory. This method is only called if the old "ssl.SocketFactory.provider" property in the java.security file is set.

Throws:

java.lang.Exception

Method Detail

createSocket

public java.net.Socket createSocket()

Creates an unconnected socket.

Overrides:

createSocket in class javax.net.SocketFactory

Returns:

the unconnected socket

See Also:

Socket.connect(java.net.SocketAddress, int)

createSocket

public java.net.Socket createSocket(java.lang.String host,
                                    int port)
                             throws java.io.IOException

Constructs an SSL connection to a named host at a specified port. This acts as the SSL client, and may authenticate itself or rejoin existing SSL sessions allowed by the authentication context which has been configured.

Specified by:

createSocket in class javax.net.SocketFactory

Parameters:

host - name of the host with which to connect

port - number of the server's port

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.net.Socket s,
                                    java.lang.String host,
                                    int port,
                                    boolean autoClose)
                             throws java.io.IOException

Returns a socket layered over an existing socket to a ServerSocket on the named host, at the given port. This constructor can be used when tunneling SSL through a proxy. The host and port refer to the logical destination server. This socket is configured using the socket options established for this factory.

Specified by:

createSocket in class javax.net.ssl.SSLSocketFactory

Parameters:

s - the existing socket

host - the server host

port - the server port

autoClose - close the underlying socket when this socket is closed

Throws:

java.io.IOException - if the connection can't be established

java.net.UnknownHostException - if the host is not known

createSocket

public java.net.Socket createSocket(java.net.Socket s,
                                    java.io.InputStream consumed,
                                    boolean autoClose)
                             throws java.io.IOException

Overrides:

createSocket in class javax.net.ssl.SSLSocketFactory

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.net.InetAddress address,
                                    int port)
                             throws java.io.IOException

Constructs an SSL connection to a server at a specified address and TCP port. This acts as the SSL client, and may authenticate itself or rejoin existing SSL sessions allowed by the authentication context which has been configured.

Specified by:

createSocket in class javax.net.SocketFactory

Parameters:

address - the server's host

port - its port

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.lang.String host,
                                    int port,
                                    java.net.InetAddress clientAddress,
                                    int clientPort)
                             throws java.io.IOException

Constructs an SSL connection to a named host at a specified port. This acts as the SSL client, and may authenticate itself or rejoin existing SSL sessions allowed by the authentication context which has been configured. The socket will also bind() to the local address and port supplied.

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.net.InetAddress address,
                                    int port,
                                    java.net.InetAddress clientAddress,
                                    int clientPort)
                             throws java.io.IOException

Constructs an SSL connection to a server at a specified address and TCP port. This acts as the SSL client, and may authenticate itself or rejoin existing SSL sessions allowed by the authentication context which has been configured. The socket will also bind() to the local address and port supplied.

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

getDefaultCipherSuites

public java.lang.String[] getDefaultCipherSuites()

Returns the subset of the supported cipher suites which are enabled by default. These cipher suites all provide a minimum quality of service whereby the server authenticates itself (preventing person-in-the-middle attacks) and where traffic is encrypted to provide confidentiality.

Specified by:

getDefaultCipherSuites in class javax.net.ssl.SSLSocketFactory

getSupportedCipherSuites

public java.lang.String[] getSupportedCipherSuites()

Returns the names of the cipher suites which could be enabled for use on an SSL connection. Normally, only a subset of these will actually be enabled by default, since this list may include cipher suites which do not support the mutual authentication of servers and clients, or which do not protect data confidentiality. Servers may also need certain kinds of certificates to use certain cipher suites.

Specified by:

getSupportedCipherSuites in class javax.net.ssl.SSLSocketFactory