Module org.freedesktop.dbus

Package org.freedesktop.dbus.utils

Class AddressBuilder

java.lang.Object

org.freedesktop.dbus.utils.AddressBuilder

public final class AddressBuilder
extends Object

Constructor Summary

Constructors

Modifier	Constructor	Description
private	AddressBuilder()

Method Summary

Modifier and Type	Method	Description
static String	createMachineId()	Creates a machine identifier by using the MD5 sum of the hostname.
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

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

createMachineId

public static String createMachineId()

Creates a machine identifier by using the MD5 sum of the hostname. If hostname could not be determined, a random string will be used.

Returns:

String