Skip to content

Most visited

Recently visited

navigation

SSLSocketFactory

public abstract class SSLSocketFactory
extends SocketFactory

java.lang.Object
   ↳ javax.net.SocketFactory
     ↳ javax.net.ssl.SSLSocketFactory
Known Direct Subclasses


SSLSocketFactorys create SSLSockets.

See also:

Summary

Public constructors

SSLSocketFactory()

Constructor is used only by subclasses.

Public methods

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.

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 methods

From class javax.net.SocketFactory
From class java.lang.Object

Public constructors

SSLSocketFactory

Added in API level 1
SSLSocketFactory ()

Constructor is used only by subclasses.

Public methods

createSocket

Added in API level 1
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 Socket: the existing socket
host String: the server host
port int: the server port
autoClose boolean: close the underlying socket when this socket is closed
Returns
Socket 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

getDefault

Added in API level 1
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
SocketFactory the default SocketFactory

See also:

getDefaultCipherSuites

Added in API level 1
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
String[] array of the cipher suites enabled by default

See also:

getSupportedCipherSuites

Added in API level 1
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
String[] an array of cipher suite names

See also:

This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.