Package org.freedesktop.dbus.utils

Class AddressBuilder

java.lang.Object

org.freedesktop.dbus.utils.AddressBuilder

public final class AddressBuilder
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DBUS_SESSION_BUS_ADDRESS	Deprecated, for removal: This API element is subject to removal in a future version. Constant has been moved to DBusSysProps.
static final String	DBUS_SYSTEM_BUS_ADDRESS	Deprecated, for removal: This API element is subject to removal in a future version. Constant has been moved to DBusSysProps.
static final String	DEFAULT_SYSTEM_BUS_ADDRESS	Deprecated, for removal: This API element is subject to removal in a future version. Constant has been moved to DBusSysProps.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	AddressBuilder()

Method Summary

Modifier and Type	Method	Description
private static File	determineMachineIdFile(String _dbusMachineIdFile)	Tries to find the DBus machine-id file in different locations.
static String	getDbusMachineId(String _dbusMachineIdFile)	Extracts the machine-id usually found on Linux in various system directories, or generate a fake id for non-Linux platforms.
private static String	getFakeDbusMachineId()	Generates a fake machine-id when DBus is running on Windows.
static BusAddress	getSessionConnection(String _dbusMachineIdFile)	Retrieves the connection address to connect to the DBus session-bus. Will return TCP connection when no unix transport found and TCP is available.
static BusAddress	getSystemConnection()	Determine the address of the DBus system connection.

Methods inherited from class java.lang.Object

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

Field Details

DBUS_SYSTEM_BUS_ADDRESS

@Deprecated(forRemoval=true,
            since="v4.2.2 - 2023-01-20")
public static final String DBUS_SYSTEM_BUS_ADDRESS

Deprecated, for removal: This API element is subject to removal in a future version.

Constant has been moved to DBusSysProps.

See Also:

• Constant Field Values

DEFAULT_SYSTEM_BUS_ADDRESS

@Deprecated(forRemoval=true,
            since="v4.2.2 - 2023-01-20")
public static final String DEFAULT_SYSTEM_BUS_ADDRESS

Deprecated, for removal: This API element is subject to removal in a future version.

Constant has been moved to DBusSysProps.

See Also:

• Constant Field Values

DBUS_SESSION_BUS_ADDRESS

@Deprecated(forRemoval=true,
            since="v4.2.2 - 2023-01-20")
public static final String DBUS_SESSION_BUS_ADDRESS

Deprecated, for removal: This API element is subject to removal in a future version.

Constant has been moved to DBusSysProps.

See Also:

• Constant Field Values

Constructor Details

AddressBuilder

private AddressBuilder()

Method Details

getSystemConnection

public static BusAddress getSystemConnection()

Determine the address of the DBus system connection.

Returns:

String

getSessionConnection

public static BusAddress getSessionConnection(String _dbusMachineIdFile)

Retrieves the connection address to connect to the DBus session-bus.
Will return TCP connection when no unix transport found and TCP is available.

Parameters:

_dbusMachineIdFile - alternative location of dbus machine id file, use null if not needed

Returns:

address

Throws:

AddressResolvingException - when no suitable address can be found for any available transport

getDbusMachineId

public static String getDbusMachineId(String _dbusMachineIdFile)

Extracts the machine-id usually found on Linux in various system directories, or generate a fake id for non-Linux platforms.

Parameters:

_dbusMachineIdFile - alternative location of dbus machine id file, null if not needed

Returns:

machine-id string, never null

determineMachineIdFile

private static File determineMachineIdFile(String _dbusMachineIdFile)

Tries to find the DBus machine-id file in different locations.

Parameters:

_dbusMachineIdFile - alternative location of dbus machine id file

Returns:

File with machine-id

getFakeDbusMachineId

private static String getFakeDbusMachineId()

Generates a fake machine-id when DBus is running on Windows.

Returns:

String