org.newsclub.net.unix

Class AFUNIXSocket

java.lang.Object

java.net.Socket

org.newsclub.net.unix.AFUNIXSocket

All Implemented Interfaces:

Closeable, AutoCloseable

public class AFUNIXSocket
extends Socket

Implementation of an AF_UNIX domain socket.

Author:

Christian Kohlschütter

Field Summary

Fields

Modifier and Type	Field and Description
protected org.newsclub.net.unix.AFUNIXSocketImpl	impl

Method Summary

Modifier and Type	Method and Description
void	bind(SocketAddress bindpoint) Binds this AFUNIXSocket to the given bindpoint.
void	connect(SocketAddress endpoint)
void	connect(SocketAddress endpoint, int timeout)
static AFUNIXSocket	connectTo(AFUNIXSocketAddress addr) Creates a new AFUNIXSocket and connects it to the given AFUNIXSocketAddress.
static boolean	isSupported() Returns true iff AFUNIXSockets are supported by the current Java VM.
static AFUNIXSocket	newInstance() Creates a new, unbound AFUNIXSocket.
static AFUNIXSocket	newStrictInstance() Creates a new, unbound, "strict" AFUNIXSocket.
String	toString()

Methods inherited from class java.net.Socket

close, getChannel, getInetAddress, getInputStream, getKeepAlive, getLocalAddress, getLocalPort, getLocalSocketAddress, getOOBInline, getOutputStream, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoLinger, getSoTimeout, getTcpNoDelay, getTrafficClass, isBound, isClosed, isConnected, isInputShutdown, isOutputShutdown, sendUrgentData, setKeepAlive, setOOBInline, setPerformancePreferences, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSocketImplFactory, setSoLinger, setSoTimeout, setTcpNoDelay, setTrafficClass, shutdownInput, shutdownOutput

Methods inherited from class java.lang.Object

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

Field Detail

impl

protected org.newsclub.net.unix.AFUNIXSocketImpl impl

Method Detail

newInstance

public static AFUNIXSocket newInstance()
                                throws IOException

Creates a new, unbound AFUNIXSocket. 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

newStrictInstance

public static AFUNIXSocket newStrictInstance()
                                      throws IOException

Creates a new, unbound, "strict" AFUNIXSocket. 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

connectTo

public static AFUNIXSocket connectTo(AFUNIXSocketAddress addr)
                              throws IOException

Creates a new AFUNIXSocket and connects it to the given AFUNIXSocketAddress.

Parameters:

addr - The address to connect to.

Returns:

A new, connected socket.

Throws:

IOException

bind

public void bind(SocketAddress bindpoint)
          throws IOException

Binds this AFUNIXSocket to the given bindpoint. Only bindpoints of the type AFUNIXSocketAddress are supported.

Overrides:

bind in class Socket

Throws:

IOException

connect

public void connect(SocketAddress endpoint)
             throws IOException

Overrides:

connect in class Socket

Throws:

IOException

connect

public void connect(SocketAddress endpoint,
                    int timeout)
             throws IOException

Overrides:

connect in class Socket

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Socket

isSupported

public static boolean isSupported()

Returns true iff AFUNIXSockets are supported by the current Java VM. To support AFUNIXSockets, a custom JNI library must be loaded that is supplied with junixsocket.

Returns:

true iff supported.