Module org.newsclub.net.unix.darwin

Package org.newsclub.net.unix.darwin.system

Class AFSYSTEMSocket

java.lang.Object

java.net.Socket

org.newsclub.net.unix.AFSocket<AFSYSTEMSocketAddress>

org.newsclub.net.unix.darwin.system.AFSYSTEMSocket

All Implemented Interfaces:

Closeable, AutoCloseable, AFSocketExtensions, AFSomeSocket, AFSomeSocketThing, AFSYSTEMSocketExtensions, FileDescriptorAccess

public final class AFSYSTEMSocket
extends AFSocket<AFSYSTEMSocketAddress>
implements AFSYSTEMSocketExtensions

Implementation of an AF_SYSTEM socket.

Author:

Christian Kohlschütter

Nested Class Summary

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

AFSocket.Constructor<A extends AFSocketAddress>

Method Summary

Modifier and Type	Method	Description
static AFSYSTEMSocket	connectTo(AFSYSTEMSocketAddress addr)	Creates a new AFSocket and connects it to the given AFSYSTEMSocketAddress.
AFSYSTEMSocketChannel	getChannel()
static boolean	isSupported()	Returns true iff AFSYSTEMSockets (sockets of type "AF_SYSTEM") are supported by the current Java VM and the kernel.
static void	main(String[] args)	Very basic self-test function.
protected AFSYSTEMSocketChannel	newChannel()	Creates a new AFSocketChannel for this socket.
static AFSYSTEMSocket	newInstance()	Creates a new, unbound AFSocket.
static AFSYSTEMSocket	newStrictInstance()	Creates a new, unbound, "strict" AFSocket.

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

addCloseable, bind, checkConnectionClosed, close, connect, connect, connectHook, connectTo, connectTo, ensureAncillaryReceiveBufferSize, ensureSupported, ensureUnsafeSupported, forceConnectAddress, getAncillaryReceiveBufferSize, getFileDescriptor, getImplExtensions, getInputStream, getLoadedLibrary, getLocalSocketAddress, getOutputStream, getRemoteSocketAddress, getVersion, isBound, isClosed, isConnected, isRunningOnAndroid, newInstance, removeCloseable, setAncillaryReceiveBufferSize, setShutdownOnClose, socketAddressClass, supports, supports, toString

Methods inherited from class java.net.Socket

getInetAddress, getKeepAlive, getLocalAddress, getLocalPort, getOOBInline, getOption, getPort, getReceiveBufferSize, getReuseAddress, getSendBufferSize, getSoLinger, getSoTimeout, getTcpNoDelay, getTrafficClass, isInputShutdown, isOutputShutdown, sendUrgentData, setKeepAlive, setOOBInline, setOption, setPerformancePreferences, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSocketImplFactory, setSoLinger, setSoTimeout, setTcpNoDelay, setTrafficClass, shutdownInput, shutdownOutput, supportedOptions

Methods inherited from class java.lang.Object

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

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

ensureAncillaryReceiveBufferSize, getAncillaryReceiveBufferSize, setAncillaryReceiveBufferSize

Method Details

isSupported

public static boolean isSupported()

Returns true iff AFSYSTEMSockets (sockets of type "AF_SYSTEM") are supported by the current Java VM and the kernel. To support AFSYSTEMSockets, a custom JNI library must be loaded that is supplied with junixsocket, and the system must support AF_SYSTEM sockets. This call is equivalent to checking AFSocket.isSupported() and AFSocket.supports(AFSocketCapability) with AFSocketCapability.CAPABILITY_DARWIN.

Returns:

true iff supported.

newChannel

protected AFSYSTEMSocketChannel newChannel()

Description copied from class: AFSocket

Creates a new AFSocketChannel for this socket.

Specified by:

newChannel in class AFSocket<AFSYSTEMSocketAddress>

Returns:

The new instance.

newInstance

public static AFSYSTEMSocket newInstance()
                                  throws IOException

Creates a new, unbound AFSocket. This "default" implementation is a bit "lenient" with respect to the specification. In particular, we ignore calls to Socket.getTcpNoDelay() and Socket.setTcpNoDelay(boolean).

Returns:

A new, unbound socket.

Throws:

IOException - if the operation fails.

newStrictInstance

public static AFSYSTEMSocket newStrictInstance()
                                        throws IOException

Creates a new, unbound, "strict" AFSocket. This call uses an implementation that tries to be closer to the specification than newInstance(), at least for some cases.

Returns:

A new, unbound socket.

Throws:

IOException - if the operation fails.

connectTo

public static AFSYSTEMSocket connectTo(AFSYSTEMSocketAddress addr)
                                throws IOException

Creates a new AFSocket and connects it to the given AFSYSTEMSocketAddress.

Parameters:

addr - The address to connect to.

Returns:

A new, connected socket.

Throws:

IOException - if the operation fails.

getChannel

public AFSYSTEMSocketChannel getChannel()

Overrides:

getChannel in class AFSocket<AFSYSTEMSocketAddress>

main

public static void main(String[] args)

Very basic self-test function. Prints "supported" and "capabilities" status to System.out.

Parameters:

args - ignored.