- java.lang.Object
-
- javax.net.SocketFactory
-
- javax.net.ssl.SSLSocketFactory
-
public abstract class SSLSocketFactory extends SocketFactory
SSLSocketFactory
s createSSLSocket
s.- Since:
- 1.4
- See Also:
SSLSocket
-
-
Constructor Summary
Constructors Constructor and Description SSLSocketFactory()
Constructor is used only by subclasses.
-
Method Summary
Methods Modifier and Type Method and Description 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.-
Methods inherited from class javax.net.SocketFactory
createSocket, createSocket, createSocket, createSocket, createSocket
-
-
-
-
Constructor Detail
-
SSLSocketFactory
public SSLSocketFactory()
Constructor is used only by subclasses.
-
-
Method Detail
-
getDefault
public static 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()
-
getDefaultCipherSuites
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()
-
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()
-
createSocket
public abstract Socket createSocket(Socket s, String host, int port, boolean autoClose) throws IOException
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 sockethost
- the server hostport
- the server portautoClose
- 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 socketNullPointerException
- if the parameter s is null
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/net/ssl/SSLSocketFactory.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.