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.

Author:

Casey Marshall (rsdio@metastatic.org)

Constructor Summary

SocketFactory()

Default 0-arguments constructor.

Method Summary

`Socket`	`createSocket()` Returns an unbound client socket.
`Socket`	`createSocket(String host, int port)` Creates a socket connected to a given host on a given port.
`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.
`Socket`	`createSocket(InetAddress host, int port)` Creates a socket connected to a given host on a given port.
`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.
`static synchronized javax.net.SocketFactory`	`getDefault()` Returns the default socket factory.

Constructor Details

SocketFactory

protected SocketFactory()

Default 0-arguments constructor.

Method Details

createSocket

public Socket createSocket()

Returns an unbound client socket.

Returns:

The new, unbound socket.

createSocket

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

- If a network error occurs.

createSocket

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

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

- If a network error occurs.

createSocket

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

- If a network error occurs.
- If host cannot be resolved.

createSocket

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

- If a network error occurs.
- If host cannot be resolved.

getDefault

public static synchronized SocketFactory getDefault()

Returns the default socket factory. The type of factory returned may depend upon the installation.

Returns:

The default socket factory.