javax.net

Class SocketFactory

public abstract class SocketFactory extends 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.
Constructor Summary
protected SocketFactory()
Default 0-arguments constructor.
Method Summary
SocketcreateSocket()
Returns an unbound client socket.
abstract SocketcreateSocket(String host, int port)
Creates a socket connected to a given host on a given port.
abstract SocketcreateSocket(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.
abstract SocketcreateSocket(InetAddress host, int port)
Creates a socket connected to a given host on a given port.
abstract SocketcreateSocket(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.
static SocketFactorygetDefault()
Returns the default socket factory.

Constructor Detail

SocketFactory

protected SocketFactory()
Default 0-arguments constructor.

Method Detail

createSocket

public Socket createSocket()
Returns an unbound client socket.

Returns: The new, unbound socket.

createSocket

public abstract Socket createSocket(String host, int port)
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.

Throws: IOException If a network error occurs. UnknownHostException If host cannot be resolved.

createSocket

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

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.

Throws: IOException If a network error occurs. UnknownHostException If host cannot be resolved.

createSocket

public abstract Socket createSocket(InetAddress host, int port)
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.

Throws: IOException If a network error occurs.

createSocket

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

Parameters: host The host address 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.

Throws: IOException If a network error occurs.

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.