javax.net
Class SocketFactory

java.lang.Object
  extended by javax.net.SocketFactory
Direct Known Subclasses:
SSLSocketFactory

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
 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SocketFactory

protected SocketFactory()
Default 0-arguments constructor.

Method Detail

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.

createSocket

public Socket createSocket()
                    throws IOException
Returns an unbound client socket.

Returns:
The new, unbound socket.
Throws:
IOException

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.
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)
                             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.
Throws:
IOException - If a network error occurs.
UnknownHostException - If host cannot be resolved.

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.
Throws:
IOException - If a network error occurs.

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