Class AFUNIXSocketFactory.SystemProperty

java.lang.Object

javax.net.SocketFactory

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

org.newsclub.net.unix.AFUNIXSocketFactory

org.newsclub.net.unix.AFUNIXSocketFactory.SystemProperty

All Implemented Interfaces:

AFSocketAddressFromHostname<AFUNIXSocketAddress>

Enclosing class:

AFUNIXSocketFactory

public static final class AFUNIXSocketFactory.SystemProperty
extends AFUNIXSocketFactory

A socket factory that handles a custom hostname ("junixsocket.localhost", by default, and configured by the system property "org.newsclub.net.unix.socket.hostname"), forwarding all other requests to the fallback SocketFactory. The socket path is configured through a system property, "org.newsclub.net.unix.socket.default". NOTE: While it is technically possible, it is highly discouraged to programmatically change the value of the property as it can lead to concurrency issues and undefined behavior.

Nested Class Summary

Nested classes/interfaces inherited from class AFUNIXSocketFactory

AFUNIXSocketFactory.FactoryArg, AFUNIXSocketFactory.SystemProperty, AFUNIXSocketFactory.URIScheme

Modifier and Type	Class	Description
static final class	AFUNIXSocketFactory.FactoryArg	A socket factory that handles a custom hostname ("localhost", by default, and configured by the system property "org.newsclub.net.unix.socket.hostname"), forwarding all other requests to the fallback SocketFactory.
static final class	AFUNIXSocketFactory.SystemProperty	A socket factory that handles a custom hostname ("junixsocket.localhost", by default, and configured by the system property "org.newsclub.net.unix.socket.hostname"), forwarding all other requests to the fallback SocketFactory.
static final class	AFUNIXSocketFactory.URIScheme	A socket factory that handles special host names formatted as file:// URIs.

Nested classes/interfaces inherited from class AFSocketFactory

AFSocketFactory.FixedAddressSocketFactory

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

Constructor	Description
SystemProperty()	Creates a AFUNIXSocketFactory.SystemProperty socket factory.

Method Summary

Modifier and Type	Method	Description
AFUNIXSocketAddress	addressFromHost(String host, int port)	Translates a "host" string (and port) to an AFSocketAddress.
final boolean	isHostnameSupported(String host)	Checks whether the given hostname is supported by this socket factory.

Methods inherited from class AFUNIXSocketFactory

connectTo, createSocket

Modifier and Type	Method	Description
protected AFUNIXSocket	connectTo(AFUNIXSocketAddress addr)	Creates a new AFSocket, connected to the given address.
Socket	createSocket()

Methods inherited from class AFSocketFactory

createSocket, createSocket, createSocket, createSocket, isInetAddressSupported

Modifier and Type	Method	Description
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 SocketFactory

getDefault

Methods inherited from class Object

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

Constructor Details

SystemProperty

public SystemProperty()

Creates a AFUNIXSocketFactory.SystemProperty socket factory.

Method Details

addressFromHost

public AFUNIXSocketAddress addressFromHost(String host,
 int port)
                                    throws SocketException

Description copied from interface: AFSocketAddressFromHostname

Translates a "host" string (and port) to an AFSocketAddress.

Parameters:

host - The hostname

port - The port, or 0.

Returns:

The AFSocketAddress

Throws:

SocketException - If there was a problem converting the hostname

isHostnameSupported

public final boolean isHostnameSupported(String host)

Description copied from interface: AFSocketAddressFromHostname

Checks whether the given hostname is supported by this socket factory. If not, calls to createSocket will cause a SocketException.

Parameters:

host - The host to check.

Returns:

true if supported.