javax.net.ssl

Class SSLSocketFactory

Known Direct Subclasses:
SSLSocketFactoryImpl

public abstract class SSLSocketFactory
extends SocketFactory

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

Constructor Summary

SSLSocketFactory()
Default 0-arguments constructor.

Method Summary

abstract Socket
createSocket(Socket socket, String host, int port, boolean autoClose)
Creates a SSL socket wrapped around an existing socket.
static SocketFactory
getDefault()
Returns a default implementation of a SSL socket factory.
abstract String[]
getDefaultCipherSuites()
Returns the list of cipher suites that will be enabled in sockets created by this factory.
abstract 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, getDefault

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SSLSocketFactory

public SSLSocketFactory()
Default 0-arguments constructor.

Method Details

createSocket

public abstract Socket createSocket(Socket socket,
                                    String host,
                                    int port,
                                    boolean autoClose)
            throws 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:
IOException - If the socket could not be created.

getDefault

public static 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.

Overrides:
getDefault in interface SocketFactory
Returns:
The default socket factory.
Throws:
RuntimeException - If no default can be created.

getDefaultCipherSuites

public abstract 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 String[] getSupportedCipherSuites()
Returns the list of all cipher suites supported by this factory.
Returns:
The list of supported cipher suites.

SSLSocketFactory.java -- factory for SSL client sockets. Copyright (C) 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.