SSLSocketFactory

AI-generated Key Takeaways

• SSLSocketFactory creates SSLSockets, enabling secure communication over sockets using SSL/TLS protocols.

• It provides methods for creating SSLSockets, either new ones or layered over existing sockets.

• It allows retrieval of default and supported cipher suites for configuring SSL connections.

• Developers can access the default SSLSocketFactory or create custom ones through subclasses.

• It inherits functionality from SocketFactory for basic socket creation and connection establishment.

public abstract class SSLSocketFactory extends SocketFactory

SSLSocketFactorys create SSLSockets.

See Also

• SSLSocket

Public Constructor Summary

SSLSocketFactory() Constructor is used only by subclasses.

Public Method Summary

abstract Socket	createSocket(Socket s, String host, int port, boolean autoClose) Returns a socket layered over an existing socket connected to the named host, at the given port.
synchronized static SocketFactory	getDefault() Returns the default SSL socket factory.
abstract String[]	getDefaultCipherSuites() Returns the list of cipher suites which are enabled by default.
abstract String[]	getSupportedCipherSuites() Returns the names of the cipher suites which could be enabled for use on an SSL connection.

Inherited Method Summary

From class javax.net.SocketFactory

abstract Socket	createSocket(String host, int port) Creates a socket and connects it to the specified remote host at the specified remote port.
abstract Socket	createSocket(InetAddress host, int port) Creates a socket and connects it to the specified port number at the specified address.
abstract Socket	createSocket(InetAddress address, int port, InetAddress localAddress, int localPort) Creates a socket and connect it to the specified remote address on the specified remote port.
abstract Socket	createSocket(String host, int port, InetAddress localHost, int localPort) Creates a socket and connects it to the specified remote host on the specified remote port.
Socket	createSocket() Creates an unconnected socket.
static SocketFactory	getDefault() Returns a copy of the environment's default socket factory.

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Public Constructors

public SSLSocketFactory ()

Constructor is used only by subclasses.

Public Methods

public abstract Socket createSocket (Socket s, String host, int port, boolean autoClose)

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

Parameters

s	the existing socket
host	the server host
port	the server port
autoClose	close the underlying socket when this socket is closed

Returns

• a socket connected to the specified host and port

Throws

IOException	if an I/O error occurs when creating the socket
NullPointerException	if the parameter s is null

public static synchronized SocketFactory getDefault ()

Returns the default SSL socket factory.

The first time this method is called, the security property "ssl.SocketFactory.provider" is examined. If it is non-null, a class by that name is loaded and instantiated. If that is successful and the object is an instance of SSLSocketFactory, it is made the default SSL socket factory.

Otherwise, this method returns SSLContext.getDefault().getSocketFactory(). If that call fails, an inoperative factory is returned.

Returns

• the default SocketFactory

See Also

• SSLContext.getDefault()

public abstract String[] getDefaultCipherSuites ()

Returns the list of cipher suites which are enabled by default. Unless a different list is enabled, handshaking on an SSL connection will use one of these cipher suites. The minimum quality of service for these defaults requires confidentiality protection and server authentication (that is, no anonymous cipher suites).

Returns

• array of the cipher suites enabled by default

See Also

• getSupportedCipherSuites()

public abstract 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 meet quality of service requirements for those defaults. Such cipher suites are useful in specialized applications.

Returns

• an array of cipher suite names

See Also

• getDefaultCipherSuites()