javax.net.ssl

Class SSLSocketFactory

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

public abstract class SSLSocketFactory
extends javax.net.SocketFactory

A socket factory for creating Secure Socket Layer (SSL) sockets.

Constructor Summary

Constructors

Constructor and Description
SSLSocketFactory()

Method Summary

Methods

Modifier and Type	Method and Description
abstract java.net.Socket	createSocket(java.net.Socket socket, java.lang.String host, int port, boolean autoClose) Creates a SSL socket wrapped around an existing socket.
static javax.net.SocketFactory	getDefault() Returns a default implementation of a SSL socket factory.
abstract java.lang.String[]	getDefaultCipherSuites() Returns the list of cipher suites that will be enabled in sockets created by this factory.
abstract java.lang.String[]	getSupportedCipherSuites() Returns the list of all cipher suites supported by this factory.

Methods inherited from class javax.net.SocketFactory

createSocket, createSocket, createSocket, createSocket, createSocket

Methods inherited from class java.lang.Object

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

Constructor Detail

SSLSocketFactory

public SSLSocketFactory()

Method Detail

getDefault

public static javax.net.SocketFactory getDefault()

Returns a default implementation of a SSL socket factory.

To control the class that gets returned by this method, set the security property "ssl.SocketFactory.provider" to the class name of a concrete implementation of this class. If not set, a system-dependent implementation will be used.

The implementation returned is created by the first implementation of the SSLContext class found, which is initialized with default parameters. To control the key and trust manager factory algorithms used as defaults, set the security properties "ssl.keyManagerFactory.algorithm" and "ssl.trustManagerFactory.algorithm" to the appropriate names.

Using this method is not recommended. Instead, use the methods of SSLContext, which provide much better control over the creation of socket factories.

Returns:

The default socket factory.

Throws:

java.lang.RuntimeException - If no default can be created.

createSocket

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

Creates a SSL socket wrapped around an existing socket.

Parameters:

socket - The socket to wrap.

host - The host the socket is connected to.

port - The port the socket is connected to.

autoClose - Whether or not the wrapped socket should be closed automatically.

Returns:

The new SSL socket.

Throws:

java.io.IOException - If the socket could not be created.

getDefaultCipherSuites

public abstract java.lang.String[] getDefaultCipherSuites()

Returns the list of cipher suites that will be enabled in sockets created by this factory.

Returns:

The default cipher suites.

getSupportedCipherSuites

public abstract java.lang.String[] getSupportedCipherSuites()

Returns the list of all cipher suites supported by this factory.

Returns:

The list of supported cipher suites.