Module org.newsclub.net.unix

Package org.newsclub.net.unix

Class AFSocketFactory<A extends AFSocketAddress>

java.lang.Object

javax.net.SocketFactory

org.newsclub.net.unix.AFSocketFactory<A>

Type Parameters:

A - The supported address type.

All Implemented Interfaces:

AFSocketAddressFromHostname<A>

Direct Known Subclasses:

AFSocketFactory.FixedAddressSocketFactory, AFSYSTEMSocketFactory, AFTIPCSocketFactory, AFUNIXSocketFactory, AFVSOCKSocketFactory

public abstract class AFSocketFactory<A extends AFSocketAddress>
extends SocketFactory
implements AFSocketAddressFromHostname<A>

The base for a SocketFactory that connects to UNIX sockets. Typically, the "hostname" is used as a reference to a socketFile on the file system. The actual mapping is left to the implementor.

See Also:

• AFUNIXSocketFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AFSocketFactory.FixedAddressSocketFactory	A socket factory that always connects to a fixed socket address, no matter what.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AFSocketFactory(Class<? extends AFSocketAddress> socketAddressClass)	Creates a new socket factory instance.

Method Summary

Modifier and Type	Method	Description
protected abstract Socket	connectTo(A addr)	Creates a new AFSocket, connected to the given address.
abstract Socket	createSocket()
final Socket	createSocket(String host, int port)
final Socket	createSocket(String host, int port, InetAddress localHost, int localPort)
final Socket	createSocket(InetAddress address, int port)
final Socket	createSocket(InetAddress address, int port, InetAddress localAddress, int localPort)
protected final boolean	isInetAddressSupported(InetAddress address)	Checks whether the given InetAddress is supported by this socket factory.

Methods inherited from class javax.net.SocketFactory

getDefault

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.newsclub.net.unix.AFSocketAddressFromHostname

addressFromHost, isHostnameSupported

Constructor Details

AFSocketFactory

protected AFSocketFactory(Class<? extends AFSocketAddress> socketAddressClass)

Creates a new socket factory instance.

Parameters:

socketAddressClass - The AFSocketAddress subclass.

Method Details

isInetAddressSupported

protected final boolean isInetAddressSupported(InetAddress address)

Checks whether the given InetAddress is supported by this socket factory. If not, calls to createSocket will cause a SocketException. By default, this only checks the hostname part of the address via AFSocketAddressFromHostname.isHostnameSupported(String).

Parameters:

address - The address to check.

Returns:

true if supported.

createSocket

public abstract Socket createSocket()
                             throws SocketException

Overrides:

createSocket in class SocketFactory

Throws:

SocketException

connectTo

protected abstract Socket connectTo(A addr)
                             throws IOException

Creates a new AFSocket, connected to the given address.

Parameters:

addr - The address to connect to.

Returns:

The socket instance.

Throws:

IOException - on error.

createSocket

public final Socket createSocket(String host,
 int port)
                          throws IOException

Specified by:

createSocket in class SocketFactory

Throws:

IOException

createSocket

public final Socket createSocket(String host,
 int port,
 InetAddress localHost,
 int localPort)
                          throws IOException

Specified by:

createSocket in class SocketFactory

Throws:

IOException

createSocket

public final Socket createSocket(InetAddress address,
 int port)
                          throws IOException

Specified by:

createSocket in class SocketFactory

Throws:

IOException

createSocket

public final Socket createSocket(InetAddress address,
 int port,
 InetAddress localAddress,
 int localPort)
                          throws IOException

Specified by:

createSocket in class SocketFactory

Throws:

IOException