junixsocket 2.10.1 · org.newsclub.net.unix.AFInetAddress

A workaround to create an InetAddress for an AFSocketAddress. DatagramPacket internally requires InetAddress compatibility. Even if it pretends to accept SocketAddresses, it refuses anything other than InetSocketAddress and then even stores host and port separately. This implementation deserializes a specially crafted InetAddress with a hostname that encodes the raw bytes of an AFSocketAddress. We do this because the deserialization code path does not attempt DNS resolution (which would fail one way or another). The hostnames we use end with ".junixsocket", to distinguish them from regular hostnames.

Field Summary

Modifier and Type	Field and Description
pack-priv static final String	INETADDR_SUFFIX
private static final byte[]	LOCAL_AF
private static final String	MARKER_HEX_ENCODING
private static final char	PREFIX

Constructor Summary

Access	Constructor and Description
pack-priv	AFInetAddress()

Method Summary

Modifier and Type	Method and Description
pack-priv static final String	Returns: A string, to be used when calling `InetSocketAddress#InetSocketAddress(String, int)`, etc. createUnresolvedHostname(byte[] The socket address. socketAddress, AFAddressFamily<?> af) Encodes a junixsocket socketAddress into a string that is (somewhat) guaranteed to not be resolved by java.net code.
pack-priv static boolean	isSupportedAddress(InetAddress addr, AFAddressFamily<?> af)
pack-priv static final byte[]	unwrapAddress(InetAddress addr, AFAddressFamily<?> af)
pack-priv static final byte[]	unwrapAddress(String hostname, AFAddressFamily<?> af)
pack-priv static final InetAddress	Returns: The `InetAddress`. wrapAddress(byte[] The socket address. socketAddress, AFAddressFamily<?> af) Creates an InetAddress that is considered "resolved" internally (using a static loopback address), without actually having to resolve the address via DNS, thus still carrying the "hostname" field containing a hostname as returned by `createUnresolvedHostname(byte[], AFAddressFamily)`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

INETADDR_SUFFIX	back to summary
pack-priv static final String INETADDR_SUFFIX

LOCAL_AF	back to summary
private static final byte[] LOCAL_AF

MARKER_HEX_ENCODING	back to summary
private static final String MARKER_HEX_ENCODING

PREFIX	back to summary
private static final char PREFIX

Constructor Detail

AFInetAddress	back to summary
pack-priv AFInetAddress()

Method Detail

createUnresolvedHostname back to summary

createUnresolvedHostname	back to summary
pack-priv static final String createUnresolvedHostname(byte[] socketAddress, AFAddressFamily<?> af) Encodes a junixsocket socketAddress into a string that is (somewhat) guaranteed to not be resolved by java.net code. Implementation detail: The "[" prefix (with the corresponding "]" suffix missing from the input) should cause an early `UnknownHostException` be thrown, which is caught within `InetSocketAddress#InetSocketAddress(String, int)`, causing the hostname be marked as "unresolved" (without an address set). Parameters socketAddress:byte[] The socket address. Returns:String A string, to be used when calling `InetSocketAddress#InetSocketAddress(String, int)`, etc.

pack-priv static final String createUnresolvedHostname(byte[] socketAddress, AFAddressFamily<?> af)

Encodes a junixsocket socketAddress into a string that is (somewhat) guaranteed to not be resolved by java.net code. Implementation detail: The "[" prefix (with the corresponding "]" suffix missing from the input) should cause an early UnknownHostException be thrown, which is caught within InetSocketAddress#InetSocketAddress(String, int), causing the hostname be marked as "unresolved" (without an address set).

Parameters

socketAddress:byte[]: The socket address.

Returns:String

A string, to be used when calling InetSocketAddress#InetSocketAddress(String, int), etc.

isSupportedAddress	back to summary
pack-priv static boolean isSupportedAddress(InetAddress addr, AFAddressFamily<?> af)

unwrapAddress	back to summary
pack-priv static final byte[] unwrapAddress(InetAddress addr, AFAddressFamily<?> af) throws SocketException

unwrapAddress	back to summary
pack-priv static final byte[] unwrapAddress(String hostname, AFAddressFamily<?> af) throws SocketException

wrapAddress back to summary

wrapAddress	back to summary
pack-priv static final InetAddress wrapAddress(byte[] socketAddress, AFAddressFamily<?> af) Creates an InetAddress that is considered "resolved" internally (using a static loopback address), without actually having to resolve the address via DNS, thus still carrying the "hostname" field containing a hostname as returned by `createUnresolvedHostname(byte[], AFAddressFamily)`. Parameters socketAddress:byte[] The socket address. Returns:InetAddress The `InetAddress`.

pack-priv static final InetAddress wrapAddress(byte[] socketAddress, AFAddressFamily<?> af)

Creates an InetAddress that is considered "resolved" internally (using a static loopback address), without actually having to resolve the address via DNS, thus still carrying the "hostname" field containing a hostname as returned by createUnresolvedHostname(byte[], AFAddressFamily).