Module org.freedesktop.dbus.transport.jre

Package org.freedesktop.dbus.transport.jre

Class NativeUnixSocketTransport

java.lang.Object

org.freedesktop.dbus.connections.transports.AbstractTransport

org.freedesktop.dbus.connections.transports.AbstractUnixTransport

org.freedesktop.dbus.transport.jre.NativeUnixSocketTransport

All Implemented Interfaces:

Closeable, AutoCloseable

public class NativeUnixSocketTransport
extends AbstractUnixTransport

Transport type representing a transport connection to a unix socket. This implementation uses features of Java 16+ to connect to a unix socket without a 3rd party library.

Please note: The functionality of the native unix sockets in Java are limited. 'Side-channel' communication (e.g. passing file descriptors) is not possible (unlike using jnr-unix socket + dbus-java-nativefd).

Also using 'abstract' sockets is not possible when using this native implementation.
In most cases this implementation should suit our needs. If it does not fit for you, use jnr-unixsocket instead.

Since:

v4.0.0 - 2021-09-01

Author:

hypfvieh

Method Summary

Modifier and Type	Method	Description
SocketChannel	acceptImpl()
protected void	bindImpl()
protected void	closeTransport()
SocketChannel	connectImpl()	Establish a connection to DBus using unix sockets.
int	getUid(SocketChannel _sock)
protected boolean	hasFileDescriptorSupport()
protected boolean	isBound()

Methods inherited from class org.freedesktop.dbus.connections.transports.AbstractTransport

close, connect, getAddress, getLogger, getMessageFactory, getSaslConfig, getTransportConfig, getTransportConnection, isConnected, isFileDescriptorSupported, isListening, listen, readMessage, setPreConnectCallback, toString, writeMessage

Methods inherited from class java.lang.Object

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

Method Details

hasFileDescriptorSupport

protected boolean hasFileDescriptorSupport()

Specified by:

hasFileDescriptorSupport in class AbstractTransport

connectImpl

public SocketChannel connectImpl()
                          throws IOException

Establish a connection to DBus using unix sockets.

Specified by:

connectImpl in class AbstractTransport

Throws:

IOException - on error

bindImpl

protected void bindImpl()
                 throws IOException

Specified by:

bindImpl in class AbstractTransport

Throws:

IOException

acceptImpl

public SocketChannel acceptImpl()
                         throws IOException

Specified by:

acceptImpl in class AbstractTransport

Throws:

IOException

isBound

protected boolean isBound()

Specified by:

isBound in class AbstractTransport

closeTransport

protected void closeTransport()
                       throws IOException

Specified by:

closeTransport in class AbstractTransport

Throws:

IOException

getUid

public int getUid(SocketChannel _sock)
           throws IOException

Specified by:

getUid in class AbstractUnixTransport

Throws:

IOException