SSLSocketFactory (Java Platform SE 7 ) (original) (raw)

• java.lang.Object

• • javax.net.SocketFactory
  • • javax.net.ssl.SSLSocketFactory

• ---

public abstract class SSLSocketFactory
extends SocketFactory
SSLSocketFactorys create SSLSockets.
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](../../../javax/net/SocketFactory.html "class in javax.net")  
     `[createSocket](../../../javax/net/SocketFactory.html#createSocket%28%29), [createSocket](../../../javax/net/SocketFactory.html#createSocket%28java.net.InetAddress,%20int%29), [createSocket](../../../javax/net/SocketFactory.html#createSocket%28java.net.InetAddress,%20int,%20java.net.InetAddress,%20int%29), [createSocket](../../../javax/net/SocketFactory.html#createSocket%28java.lang.String,%20int%29), [createSocket](../../../javax/net/SocketFactory.html#createSocket%28java.lang.String,%20int,%20java.net.InetAddress,%20int%29)`  
     * ### Methods inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../java/lang/Object.html#clone%28%29), [equals](../../../java/lang/Object.html#equals%28java.lang.Object%29), [finalize](../../../java/lang/Object.html#finalize%28%29), [getClass](../../../java/lang/Object.html#getClass%28%29), [hashCode](../../../java/lang/Object.html#hashCode%28%29), [notify](../../../java/lang/Object.html#notify%28%29), [notifyAll](../../../java/lang/Object.html#notifyAll%28%29), [toString](../../../java/lang/Object.html#toString%28%29), [wait](../../../java/lang/Object.html#wait%28%29), [wait](../../../java/lang/Object.html#wait%28long%29), [wait](../../../java/lang/Object.html#wait%28long,%20int%29)`

• • Constructor Detail

     * #### SSLSocketFactory  
     public SSLSocketFactory()  
     Constructor is used only by subclasses.  

  • Method Detail

    * #### getDefault  
    public static [SocketFactory](../../../javax/net/SocketFactory.html "class in javax.net") 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()](../../../javax/net/ssl/SSLContext.html#getDefault%28%29)  
    * #### getDefaultCipherSuites  
    public abstract [String](../../../java/lang/String.html "class in java.lang")[] 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()](../../../javax/net/ssl/SSLSocketFactory.html#getSupportedCipherSuites%28%29)  
    * #### getSupportedCipherSuites  
    public abstract [String](../../../java/lang/String.html "class in java.lang")[] 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()](../../../javax/net/ssl/SSLSocketFactory.html#getDefaultCipherSuites%28%29)  
    * #### createSocket  
    public abstract [Socket](../../../java/net/Socket.html "class in java.net") createSocket([Socket](../../../java/net/Socket.html "class in java.net") s,  
                      [String](../../../java/lang/String.html "class in java.lang") host,  
                      int port,  
                      boolean autoClose)  
                                 throws [IOException](../../../java/io/IOException.html "class in java.io")  
    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](../../../java/io/IOException.html "class in java.io")` \- if an I/O error occurs when creating the socket  
    `[NullPointerException](../../../java/lang/NullPointerException.html "class in java.lang")` \- if the parameter s is null

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.