Module org.newsclub.net.unix

Package org.newsclub.net.unix

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 org.newsclub.net.unix.AFUNIXSocketFactory

AFUNIXSocketFactory.FactoryArg, AFUNIXSocketFactory.SystemProperty, AFUNIXSocketFactory.URIScheme

Nested classes/interfaces inherited from class org.newsclub.net.unix.AFSocketFactory

AFSocketFactory.FixedAddressSocketFactory

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 org.newsclub.net.unix.AFUNIXSocketFactory

connectTo, createSocket

Methods inherited from class org.newsclub.net.unix.AFSocketFactory

createSocket, createSocket, createSocket, createSocket, isInetAddressSupported

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

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.