javax.net

Class SocketFactory

Known Direct Subclasses:
SSLSocketFactory

public abstract class SocketFactory
extends java.lang.Object

A factory for client sockets. The purpose of this class is to serve as the superclass of server socket factories that produce client sockets of a particular type, such as Secure Socket Layer (SSL) sockets.
Author:
Casey Marshall (rsdio@metastatic.org)

Constructor Summary

SocketFactory()
Default 0-arguments constructor.

Method Summary

Socket
createSocket()
Returns an unbound client socket.
abstract Socket
createSocket(InetAddress host, int port)
Creates a socket connected to a given host on a given port.
abstract Socket
createSocket(InetAddress hast, int port, InetAddress localHost, int localPort)
Creates a socket connected to a given host on a given port, connecting locally to the interface with the given address and port.
abstract Socket
createSocket(String host, int port)
Creates a socket connected to a given host on a given port.
abstract Socket
createSocket(String host, int port, InetAddress localHost, int localPort)
Creates a socket connected to a given host on a given port, connecting locally to the interface with the given address and port.
static SocketFactory
getDefault()
Returns the default socket factory.

Constructor Details

SocketFactory

protected SocketFactory()
Default 0-arguments constructor.

Method Details

createSocket

public Socket createSocket()
            throws IOException
Returns an unbound client socket.
Returns:
The new, unbound socket.

createSocket

public abstract Socket createSocket(InetAddress host,
                                    int port)
            throws IOException
Creates a socket connected to a given host on a given port.
Parameters:
host - The host address to connect to.
port - The port on host to connect to.
Returns:
A socket connected to host on port.

createSocket

public abstract Socket createSocket(InetAddress hast,
                                    int port,
                                    InetAddress localHost,
                                    int localPort)
            throws IOException
Creates a socket connected to a given host on a given port, connecting locally to the interface with the given address and port.
Parameters:
port - The port on host to connect to.
localHost - The address of the local interface to bind to.
localPort - The local port to bind to.
Returns:
A socket connected to host on port.

createSocket

public abstract Socket createSocket(String host,
                                    int port)
            throws IOException,
                   UnknownHostException
Creates a socket connected to a given host on a given port.
Parameters:
host - The hostname to connect to.
port - The port on host to connect to.
Returns:
A socket connected to host on port.

createSocket

public abstract Socket createSocket(String host,
                                    int port,
                                    InetAddress localHost,
                                    int localPort)
            throws IOException,
                   UnknownHostException
Creates a socket connected to a given host on a given port, connecting locally to the interface with the given address and port.
Parameters:
host - The hostname to connect to.
port - The port on host to connect to.
localHost - The address of the local interface to bind to.
localPort - The local port to bind to.
Returns:
A socket connected to host on port.

getDefault

public static SocketFactory getDefault()
Returns the default socket factory. The type of factory returned may depend upon the installation.
Returns:
The default socket factory.