javax.net

Class SocketFactory

java.lang.Object

javax.net.SocketFactory

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.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SocketFactory() Default 0-arguments constructor.

Method Summary

Methods

Modifier and Type	Method and Description
java.net.Socket	createSocket() Returns an unbound client socket.
abstract java.net.Socket	createSocket(java.net.InetAddress host, int port) Creates a socket connected to a given host on a given port.
abstract java.net.Socket	createSocket(java.net.InetAddress hast, int port, java.net.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 java.net.Socket	createSocket(java.lang.String host, int port) Creates a socket connected to a given host on a given port.
abstract java.net.Socket	createSocket(java.lang.String host, int port, java.net.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 java.net.Socket createSocket()
                             throws java.io.IOException

Returns an unbound client socket.

Returns:

The new, unbound socket.

Throws:

java.io.IOException

createSocket

public abstract java.net.Socket createSocket(java.lang.String host,
                           int port)
                                      throws java.io.IOException,
                                             java.net.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:

java.io.IOException - If a network error occurs.

java.net.UnknownHostException - If host cannot be resolved.

createSocket

public abstract java.net.Socket createSocket(java.lang.String host,
                           int port,
                           java.net.InetAddress localHost,
                           int localPort)
                                      throws java.io.IOException,
                                             java.net.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:

java.io.IOException - If a network error occurs.

java.net.UnknownHostException - If host cannot be resolved.

createSocket

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

java.io.IOException - If a network error occurs.

createSocket

public abstract java.net.Socket createSocket(java.net.InetAddress hast,
                           int port,
                           java.net.InetAddress localHost,
                           int localPort)
                                      throws java.io.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:

java.io.IOException - If a network error occurs.