Module org.newsclub.net.unix

Package org.newsclub.net.unix

Class AFDatagramSocket<A extends AFSocketAddress>

java.lang.Object

java.net.DatagramSocket

org.newsclub.net.unix.AFDatagramSocket<A>

Type Parameters:

A - The concrete AFSocketAddress that is supported by this type.

All Implemented Interfaces:

Closeable, AutoCloseable, AFSocketExtensions, AFSomeSocket, FileDescriptorAccess

Direct Known Subclasses:

AFUNIXDatagramSocket

public abstract class AFDatagramSocket<A extends AFSocketAddress>
extends DatagramSocket
implements AFSomeSocket, AFSocketExtensions

A DatagramSocket implementation that works with junixsocket.

Author:

Christian Kohlschütter

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AFDatagramSocket.Constructor<A extends AFSocketAddress>	A reference to the constructor of an AFDatagramSocket subclass.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AFDatagramSocket(AFDatagramSocketImpl<A> impl)	Creates a new AFDatagramSocket instance.

Method Summary

Modifier and Type	Method	Description
protected final AFAddressFamily<A>	addressFamily()	Returns the address family supported by this implementation.
final void	bind(SocketAddress addr)
final void	close()
final void	connect(InetAddress address, int port)
final void	connect(SocketAddress addr)
final void	ensureAncillaryReceiveBufferSize(int minSize)	Ensures a minimum ancillary receive buffer size.
protected final org.newsclub.net.unix.AncillaryDataSupport	getAncillaryDataSupport()	Returns the AncillaryDataSupport instance.
final int	getAncillaryReceiveBufferSize()	Returns the size of the receive buffer for ancillary messages (in bytes).
AFDatagramChannel<A>	getChannel()
final FileDescriptor	getFileDescriptor()	Returns the corresponding FileDescriptor.
protected AFSocketImplExtensions<A>	getImplExtensions()	Returns the internal helper instance for address-specific extensions.
final @Nullable A	getLocalSocketAddress()	Returns the socket's local socket address, or null if unavailable or if there was a problem retrieving it.
final @Nullable A	getRemoteSocketAddress()	Returns the socket's remote socket address, or null if unavailable/not connected, or if there was a problem retrieving it.
final boolean	isBound()
final boolean	isClosed()
final boolean	isConnected()
final boolean	isDeleteOnClose()	Checks if this AFDatagramSocket's bound filename should be removed upon close().
protected abstract AFDatagramChannel<A>	newChannel()	Creates a new DatagramChannel that is associated with this socket.
protected static final <A extends AFSocketAddress> AFDatagramSocket<A>	newInstance(AFDatagramSocket.Constructor<A> constructor)	Returns a new AFDatagramSocket instance.
protected static final <A extends AFSocketAddress> AFDatagramSocket<A>	newInstance(AFDatagramSocket.Constructor<A> constructor, FileDescriptor fdObj, int localPort, int remotePort)	Creates a new AFDatagramSocket.
final void	peek(DatagramPacket p)	Reads the next received packet without actually removing it from the queue.
final void	receive(DatagramPacket p)
final void	send(DatagramPacket p)
final void	setAncillaryReceiveBufferSize(int size)	Sets the size of the receive buffer for ancillary messages (in bytes).
final void	setDeleteOnClose(boolean b)	Enables/disables deleting this AFDatagramSocket's bound filename upon close().
protected final Class<? extends AFSocketAddress>	socketAddressClass()	Returns the AFSocketAddress type supported by this socket.

Methods inherited from class java.net.DatagramSocket

disconnect, getBroadcast, getInetAddress, getLocalAddress, getLocalPort, getOption, getPort, getReceiveBufferSize, getReuseAddress, getSendBufferSize, getSoTimeout, getTrafficClass, joinGroup, leaveGroup, setBroadcast, setDatagramSocketImplFactory, setOption, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSoTimeout, setTrafficClass, supportedOptions

Methods inherited from class java.lang.Object

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

Constructor Details

AFDatagramSocket

protected AFDatagramSocket(AFDatagramSocketImpl<A> impl)
                    throws IOException

Creates a new AFDatagramSocket instance.

Parameters:

impl - The corresponding SocketImpl class.

Throws:

IOException - on error.

Method Details

newChannel

protected abstract AFDatagramChannel<A> newChannel()

Creates a new DatagramChannel that is associated with this socket.

Returns:

The channel.

getAncillaryDataSupport

protected final org.newsclub.net.unix.AncillaryDataSupport getAncillaryDataSupport()

Returns the AncillaryDataSupport instance.

Returns:

The instance.

socketAddressClass

protected final Class<? extends AFSocketAddress> socketAddressClass()

Returns the AFSocketAddress type supported by this socket.

Returns:

The supported AFSocketAddress.

newInstance

protected static final <A extends AFSocketAddress>
AFDatagramSocket<A> newInstance(AFDatagramSocket.Constructor<A> constructor)
                         throws IOException

Returns a new AFDatagramSocket instance.

Type Parameters:

A - The concrete AFSocketAddress that is supported by this type.

Parameters:

constructor - The supplying constructor.

Returns:

The new instance.

Throws:

IOException - on error.

newInstance

protected static final <A extends AFSocketAddress>
AFDatagramSocket<A> newInstance(AFDatagramSocket.Constructor<A> constructor,
 FileDescriptor fdObj,
 int localPort,
 int remotePort)
                         throws IOException

Creates a new AFDatagramSocket.

Type Parameters:

A - The concrete AFSocketAddress that is supported by this type.

Parameters:

constructor - The supplying constructor.

fdObj - The file descriptor.

localPort - The local port.

remotePort - The remote port.

Returns:

The new instance.

Throws:

IOException - on error.

connect

public final void connect(InetAddress address,
 int port)

Overrides:

connect in class DatagramSocket

peek

public final void peek(DatagramPacket p)
                throws IOException

Reads the next received packet without actually removing it from the queue. In other words, once a packet is received, calling this method multiple times in a row will not have further effects on the packet contents. This call still blocks until at least one packet has been received and added to the queue.

Parameters:

p - The packet.

Throws:

IOException - on error.

send

public final void send(DatagramPacket p)
                throws IOException

Overrides:

send in class DatagramSocket

Throws:

IOException

connect

public final void connect(SocketAddress addr)
                   throws SocketException

Overrides:

connect in class DatagramSocket

Throws:

SocketException

getRemoteSocketAddress

public final @Nullable A getRemoteSocketAddress()

Description copied from interface: AFSomeSocket

Returns the socket's remote socket address, or null if unavailable/not connected, or if there was a problem retrieving it.

Specified by:

getRemoteSocketAddress in interface AFSomeSocket

Overrides:

getRemoteSocketAddress in class DatagramSocket

Returns:

The remote socket address, or null.

isConnected

public final boolean isConnected()

Overrides:

isConnected in class DatagramSocket

isBound

public final boolean isBound()

Overrides:

isBound in class DatagramSocket

close

public final void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class DatagramSocket

bind

public final void bind(SocketAddress addr)
                throws SocketException

Overrides:

bind in class DatagramSocket

Throws:

SocketException

getLocalSocketAddress

public final @Nullable A getLocalSocketAddress()

Description copied from interface: AFSomeSocket

Returns the socket's local socket address, or null if unavailable or if there was a problem retrieving it.

Specified by:

getLocalSocketAddress in interface AFSomeSocket

Overrides:

getLocalSocketAddress in class DatagramSocket

Returns:

The local socket address, or null.

isDeleteOnClose

public final boolean isDeleteOnClose()

Checks if this AFDatagramSocket's bound filename should be removed upon close(). Deletion is not guaranteed, especially when not supported (e.g., addresses in the abstract namespace).

Returns:

true if an attempt is made to delete the socket file upon close().

setDeleteOnClose

public final void setDeleteOnClose(boolean b)

Enables/disables deleting this AFDatagramSocket's bound filename upon close(). Deletion is not guaranteed, especially when not supported (e.g., addresses in the abstract namespace).

Parameters:

b - Enabled if true.

getAncillaryReceiveBufferSize

public final int getAncillaryReceiveBufferSize()

Description copied from interface: AFSocketExtensions

Returns the size of the receive buffer for ancillary messages (in bytes).

Specified by:

getAncillaryReceiveBufferSize in interface AFSocketExtensions

Returns:

The size.

setAncillaryReceiveBufferSize

public final void setAncillaryReceiveBufferSize(int size)

Description copied from interface: AFSocketExtensions

Sets the size of the receive buffer for ancillary messages (in bytes). To disable handling ancillary messages, set it to 0 (default).

Specified by:

setAncillaryReceiveBufferSize in interface AFSocketExtensions

Parameters:

size - The size.

ensureAncillaryReceiveBufferSize

public final void ensureAncillaryReceiveBufferSize(int minSize)

Description copied from interface: AFSocketExtensions

Ensures a minimum ancillary receive buffer size.

Specified by:

ensureAncillaryReceiveBufferSize in interface AFSocketExtensions

Parameters:

minSize - The minimum size (in bytes).

isClosed

public final boolean isClosed()

Overrides:

isClosed in class DatagramSocket

getChannel

public AFDatagramChannel<A> getChannel()

Overrides:

getChannel in class DatagramSocket

getFileDescriptor

public final FileDescriptor getFileDescriptor()
                                       throws IOException

Description copied from interface: FileDescriptorAccess

Returns the corresponding FileDescriptor.

Specified by:

getFileDescriptor in interface FileDescriptorAccess

Returns:

The corresponding FileDescriptor.

Throws:

IOException - on error.

receive

public final void receive(DatagramPacket p)
                   throws IOException

Overrides:

receive in class DatagramSocket

Throws:

IOException

addressFamily

protected final AFAddressFamily<A> addressFamily()

Returns the address family supported by this implementation.

Returns:

The family.

getImplExtensions

protected AFSocketImplExtensions<A> getImplExtensions()

Returns the internal helper instance for address-specific extensions.

Returns:

The helper instance.

Throws:

UnsupportedOperationException - if such extensions are not supported for this address type.