Modul org.freedesktop.dbus

Package org.freedesktop.dbus.connections.impl

Klasse DBusConnection

java.lang.Object

org.freedesktop.dbus.connections.AbstractConnection

org.freedesktop.dbus.connections.impl.DBusConnection

Alle implementierten Schnittstellen:

Closeable, AutoCloseable

public final class DBusConnection
extends AbstractConnection

Handles a connection to DBus.

This is a Singleton class, only 1 connection to the SYSTEM or SESSION busses can be made. Repeated calls to getConnection will return the same reference.

Signal Handlers and method calls from remote objects are run in their own threads, you MUST handle the concurrency issues.

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static enum	DBusConnection.DBusBusType

Feldübersicht

Von Klasse geerbte Felder org.freedesktop.dbus.connections.AbstractConnection

BUSNAME_REGEX, CONNID_REGEX, DOLLAR_PATTERN, FLOAT_SUPPORT, MAX_ARRAY_LENGTH, MAX_NAME_LENGTH, OBJECT_REGEX_PATTERN, TCP_ADDRESS_PROPERTY, TCP_CONNECT_TIMEOUT

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
AutoCloseable	addGenericSigHandler(DBusMatchRule _rule, DBusSigHandler<DBusSignal> _handler)	Adds a DBusMatchRule to with a generic signal handler.
<T extends DBusSignal> AutoCloseable	addSigHandler(Class<T> _type, String _source, DBusInterface _object, DBusSigHandler<T> _handler)	Add a Signal Handler.
<T extends DBusSignal> AutoCloseable	addSigHandler(Class<T> _type, String _source, DBusSigHandler<T> _handler)	Add a Signal Handler.
<T extends DBusSignal> AutoCloseable	addSigHandler(DBusMatchRule _rule, DBusSigHandler<T> _handler)	Add a signal handler with the given DBusMatchRule to DBus.
void	close()	Same as disconnect.
void	disconnect()	Disconnect from the Bus.
<T extends DBusInterface> T	dynamicProxy(String _source, String _path, Class<T> _type)	Tries to resolve a proxy to a remote object.
static DBusConnection	getConnection(String _address)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
static DBusConnection	getConnection(String _address, boolean _registerSelf, boolean _shared)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
static DBusConnection	getConnection(String _address, boolean _registerSelf, boolean _shared, int _timeout)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
static DBusConnection	getConnection(DBusConnection.DBusBusType _bustype)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
static DBusConnection	getConnection(DBusConnection.DBusBusType _bustype, boolean _shared, int _timeout)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
DBusInterface	getExportedObject(String _source, String _path)	Retrieves an remote object using source and path.
<T extends DBusInterface> T	getExportedObject(String _source, String _path, Class<T> _type)	Retrieves an remote object using source and path.
String	getMachineId()	The generated UUID of this machine.
String[]	getNames()	Returns all the names owned by this connection.
DBusInterface	getPeerRemoteObject(String _busname, String _objectpath)	Return a reference to a remote object.
<I extends DBusInterface> I	getPeerRemoteObject(String _busname, String _objectpath, Class<I> _type)
<I extends DBusInterface> I	getPeerRemoteObject(String _busname, String _objectpath, Class<I> _type, boolean _autostart)	Return a reference to a remote object.
DBusInterface	getRemoteObject(String _busname, String _objectpath)	Return a reference to a remote object.
<I extends DBusInterface> I	getRemoteObject(String _busname, String _objectpath, Class<I> _type)	Return a reference to a remote object.
<I extends DBusInterface> I	getRemoteObject(String _busname, String _objectpath, Class<I> _type, boolean _autostart)	Return a reference to a remote object.
String	getUniqueName()	Returns the unique name of this connection.
static DBusConnection	newConnection(DBusConnection.DBusBusType _bustype)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. use DBusConnectionBuilder
void	releaseBusName(String _busname)	Release a bus name.
void	removeGenericSigHandler(DBusMatchRule _rule, DBusSigHandler<DBusSignal> _handler)	Remove a generic signal handler with the given DBusMatchRule.
<T extends DBusSignal> void	removeSigHandler(Class<T> _type, String _source, DBusInterface _object, DBusSigHandler<T> _handler)	Remove a Signal Handler.
<T extends DBusSignal> void	removeSigHandler(Class<T> _type, String _source, DBusSigHandler<T> _handler)	Remove a Signal Handler.
protected <T extends DBusSignal> void	removeSigHandler(DBusMatchRule _rule, DBusSigHandler<T> _handler)	Remove a match rule with the given DBusSigHandler.
void	requestBusName(String _busname)	Request a bus name.
static void	setDbusMachineIdFile(String _dbusMachineIdFile)	Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt. no longer required when DBusConnectionBuilder is used

Von Klasse geerbte Methoden org.freedesktop.dbus.connections.AbstractConnection

addFallback, addSigHandler, addSigHandler, addSigHandlerWithoutMatch, callMethodAsync, callWithCallback, changeThreadCount, connect, disconnect, exportObject, exportObject, findMatchingTypes, getAddress, getCallInfo, getDisconnectCallback, getEndianness, getError, getExportedObject, getExportedObjects, getGenericHandledSignals, getHandledSignals, getImportedObjects, getObjectTree, getPendingCalls, getPendingErrorQueue, getSystemEndianness, getTransportConfig, handleException, internalDisconnect, isConnected, listen, queueCallback, removeFallback, removeSigHandler, removeSigHandler, sendMessage, setDisconnectCallback, setEndianness, setWeakReferences, toString, unExportObject

Von Klasse geerbte Methoden java.lang.Object

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

Methodendetails

getConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection getConnection(String _address)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to the BUS. If a connection already exists to the specified Bus, a reference to it is returned. Will always register our own session to Dbus.

Parameter:

_address - The address of the bus to connect to

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

getConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection getConnection(String _address,
 boolean _registerSelf,
 boolean _shared)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to the BUS. If a connection already exists to the specified Bus and the shared-flag is true, a reference is returned. Will register our own session to DBus if registerSelf is true (default). A new connection is created every time if shared-flag is false.

Parameter:

_address - The address of the bus to connect to

_registerSelf - register own session in dbus

_shared - use a shared connections

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

getConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection getConnection(String _address,
 boolean _registerSelf,
 boolean _shared,
 int _timeout)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to the BUS. If a connection already exists to the specified Bus and the shared-flag is true, a reference is returned. Will register our own session to DBus if registerSelf is true (default). A new connection is created every time if shared-flag is false.

Parameter:

_address - The address of the bus to connect to

_registerSelf - register own session in dbus

_shared - use a shared connections

_timeout - connect timeout if this is a TCP socket, 0 will block forever, if this is not a TCP socket this value is ignored

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

getConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection getConnection(DBusConnection.DBusBusType _bustype)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to DBus. If a connection already exists to the specified Bus, a reference to it is returned.

Parameter:

_bustype - The Bus to connect to.

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

newConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection newConnection(DBusConnection.DBusBusType _bustype)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to DBus using a new connection even if there is already a connection established.

Parameter:

_bustype - The Bus to connect to.

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

getConnection

@Deprecated(since="4.1.0",
            forRemoval=true)
public static DBusConnection getConnection(DBusConnection.DBusBusType _bustype,
 boolean _shared,
 int _timeout)
                                    throws DBusException

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

use DBusConnectionBuilder

Connect to the BUS. If a connection to the specified Bus already exists and shared-flag is true, a reference to it is returned. Otherwise a new connection will be created.

Parameter:

_bustype - The Bus to connect to.

_shared - use shared connection

_timeout - connect timeout if this is a TCP socket, 0 will block forever, if this is not a TCP socket this value is ignored

Gibt zurück:

DBusConnection

Löst aus:

DBusException - If there is a problem connecting to the Bus.

setDbusMachineIdFile

@Deprecated(since="4.1.0",
            forRemoval=true)
public static void setDbusMachineIdFile(String _dbusMachineIdFile)

Veraltet, zur Entfernung: Dieses API-Element wird in einer zukünftigen Version entfernt.

no longer required when DBusConnectionBuilder is used

Set a specific machine-id file path to read the machine ID from. The system variable DBUS_MACHINE_ID_LOCATION will take precedence over this.

Parameter:

_dbusMachineIdFile - file containing DBus machine ID.

dynamicProxy

public <T extends DBusInterface> T dynamicProxy(String _source,
 String _path,
 Class<T> _type)
                                         throws DBusException

Tries to resolve a proxy to a remote object. If a type class is given, it tries to convert the object using that class. If null is given as type, it tries to find a proper interface for this object.

Typparameter:

T - object type (DBusInterface compatible)

Parameter:

_source - source

_path - path

_type - class of object type

Gibt zurück:

DBusInterface compatible object

Löst aus:

DBusException - when something goes wrong

getExportedObject

public <T extends DBusInterface> T getExportedObject(String _source,
 String _path,
 Class<T> _type)
                                              throws DBusException

Beschreibung aus Klasse kopiert: AbstractConnection

Retrieves an remote object using source and path. Will use the given type as object class.

Angegeben von:

getExportedObject in Klasse AbstractConnection

Parameter:

_source - source

_path - path

_type - class of remote object

Gibt zurück:

DBusInterface compatible object

Löst aus:

DBusException

getExportedObject

public DBusInterface getExportedObject(String _source,
 String _path)
                                throws DBusException

Beschreibung aus Klasse kopiert: AbstractConnection

Retrieves an remote object using source and path. Will try to find suitable exported DBusInterface automatically.

Angegeben von:

getExportedObject in Klasse AbstractConnection

Parameter:

_source - source

_path - path

Gibt zurück:

DBusInterface compatible object

Löst aus:

DBusException

releaseBusName

public void releaseBusName(String _busname)
                    throws DBusException

Release a bus name. Releases the name so that other people can use it

Parameter:

_busname - The name to release. MUST be in dot-notation like "org.freedesktop.local"

Löst aus:

DBusException - If the busname is incorrectly formatted.

requestBusName

public void requestBusName(String _busname)
                    throws DBusException

Request a bus name. Request the well known name that this should respond to on the Bus.

Parameter:

_busname - The name to respond to. MUST be in dot-notation like "org.freedesktop.local"

Löst aus:

DBusException - If the register name failed, or our name already exists on the bus. or if busname is incorrectly formatted.

getUniqueName

public String getUniqueName()

Returns the unique name of this connection.

Gibt zurück:

unique name

getNames

public String[] getNames()

Returns all the names owned by this connection.

Gibt zurück:

connection names

getPeerRemoteObject

public <I extends DBusInterface> I getPeerRemoteObject(String _busname,
 String _objectpath,
 Class<I> _type)
                                                throws DBusException

Löst aus:

DBusException

getPeerRemoteObject

public DBusInterface getPeerRemoteObject(String _busname,
 String _objectpath)
                                  throws DBusException

Return a reference to a remote object. This method will resolve the well known name (if given) to a unique bus name when you call it. This means that if a well known name is released by one process and acquired by another calls to objects gained from this method will continue to operate on the original process. This method will use bus introspection to determine the interfaces on a remote object and so may block and may fail. The resulting proxy object will, however, be castable to any interface it implements. It will also autostart the process if applicable. Also note that the resulting proxy may fail to execute the correct method with overloaded methods and that complex types may fail in interesting ways. Basically, if something odd happens, try specifying the interface explicitly.

Parameter:

_busname - The bus name to connect to. Usually a well known bus name in dot-notation (such as "org.freedesktop.local") or may be a DBus address such as ":1-16".

_objectpath - The path on which the process is exporting the object.$

Gibt zurück:

A reference to a remote object.

Löst aus:

ClassCastException - If type is not a sub-type of DBusInterface

DBusException - If busname or objectpath are incorrectly formatted.

getRemoteObject

public DBusInterface getRemoteObject(String _busname,
 String _objectpath)
                              throws DBusException

Return a reference to a remote object. This method will always refer to the well known name (if given) rather than resolving it to a unique bus name. In particular this means that if a process providing the well known name disappears and is taken over by another process proxy objects gained by this method will make calls on the new proccess. This method will use bus introspection to determine the interfaces on a remote object and so may block and may fail. The resulting proxy object will, however, be castable to any interface it implements. It will also autostart the process if applicable. Also note that the resulting proxy may fail to execute the correct method with overloaded methods and that complex types may fail in interesting ways. Basically, if something odd happens, try specifying the interface explicitly.

Parameter:

_busname - The bus name to connect to. Usually a well known bus name name in dot-notation (such as "org.freedesktop.local") or may be a DBus address such as ":1-16".

_objectpath - The path on which the process is exporting the object.

Gibt zurück:

A reference to a remote object.

Löst aus:

ClassCastException - If type is not a sub-type of DBusInterface

DBusException - If busname or objectpath are incorrectly formatted.

getPeerRemoteObject

public <I extends DBusInterface> I getPeerRemoteObject(String _busname,
 String _objectpath,
 Class<I> _type,
 boolean _autostart)
                                                throws DBusException

Return a reference to a remote object. This method will resolve the well known name (if given) to a unique bus name when you call it. This means that if a well known name is released by one process and acquired by another calls to objects gained from this method will continue to operate on the original process.

Typparameter:

I - class extending DBusInterface

Parameter:

_busname - The bus name to connect to. Usually a well known bus name in dot-notation (such as "org.freedesktop.local") or may be a DBus address such as ":1-16".

_objectpath - The path on which the process is exporting the object.$

_type - The interface they are exporting it on. This type must have the same full class name and exposed method signatures as the interface the remote object is exporting.

_autostart - Disable/Enable auto-starting of services in response to calls on this object. Default is enabled; when calling a method with auto-start enabled, if the destination is a well-known name and is not owned the bus will attempt to start a process to take the name. When disabled an error is returned immediately.

Gibt zurück:

A reference to a remote object.

Löst aus:

ClassCastException - If type is not a sub-type of DBusInterface

DBusException - If busname or objectpath are incorrectly formatted or type is not in a package.

getRemoteObject

public <I extends DBusInterface> I getRemoteObject(String _busname,
 String _objectpath,
 Class<I> _type)
                                            throws DBusException

Return a reference to a remote object. This method will always refer to the well known name (if given) rather than resolving it to a unique bus name. In particular this means that if a process providing the well known name disappears and is taken over by another process proxy objects gained by this method will make calls on the new proccess.

Typparameter:

I - class extending DBusInterface

Parameter:

_busname - The bus name to connect to. Usually a well known bus name name in dot-notation (such as "org.freedesktop.local") or may be a DBus address such as ":1-16".

_objectpath - The path on which the process is exporting the object.

_type - The interface they are exporting it on. This type must have the same full class name and exposed method signatures as the interface the remote object is exporting.

Gibt zurück:

A reference to a remote object.

Löst aus:

ClassCastException - If type is not a sub-type of DBusInterface

DBusException - If busname or objectpath are incorrectly formatted or type is not in a package.

getRemoteObject

public <I extends DBusInterface> I getRemoteObject(String _busname,
 String _objectpath,
 Class<I> _type,
 boolean _autostart)
                                            throws DBusException

Return a reference to a remote object. This method will always refer to the well known name (if given) rather than resolving it to a unique bus name. In particular this means that if a process providing the well known name disappears and is taken over by another process proxy objects gained by this method will make calls on the new proccess.

Typparameter:

I - class extending DBusInterface

Parameter:

_busname - The bus name to connect to. Usually a well known bus name name in dot-notation (such as "org.freedesktop.local") or may be a DBus address such as ":1-16".

_objectpath - The path on which the process is exporting the object.

_type - The interface they are exporting it on. This type must have the same full class name and exposed method signatures as the interface the remote object is exporting.

_autostart - Disable/Enable auto-starting of services in response to calls on this object. Default is enabled; when calling a method with auto-start enabled, if the destination is a well-known name and is not owned the bus will attempt to start a process to take the name. When disabled an error is returned immediately.

Gibt zurück:

A reference to a remote object.

Löst aus:

ClassCastException - If type is not a sub-type of DBusInterface

DBusException - If busname or objectpath are incorrectly formatted or type is not in a package.

removeSigHandler

public <T extends DBusSignal> void removeSigHandler(Class<T> _type,
 String _source,
 DBusSigHandler<T> _handler)
                                             throws DBusException

Remove a Signal Handler. Stops listening for this signal.

Typparameter:

T - class extending DBusSignal

Parameter:

_type - The signal to watch for.

_source - The source of the signal.

_handler - the handler

Löst aus:

DBusException - If listening for the signal on the bus failed.

ClassCastException - If type is not a sub-type of DBusSignal.

removeSigHandler

public <T extends DBusSignal> void removeSigHandler(Class<T> _type,
 String _source,
 DBusInterface _object,
 DBusSigHandler<T> _handler)
                                             throws DBusException

Remove a Signal Handler. Stops listening for this signal.

Typparameter:

T - class extending DBusSignal

Parameter:

_type - The signal to watch for.

_source - The source of the signal.

_object - The object emitting the signal.

_handler - the handler

Löst aus:

DBusException - If listening for the signal on the bus failed.

ClassCastException - If type is not a sub-type of DBusSignal.

removeSigHandler

protected <T extends DBusSignal> void removeSigHandler(DBusMatchRule _rule,
 DBusSigHandler<T> _handler)
                                                throws DBusException

Remove a match rule with the given DBusSigHandler. The rule will only be removed from DBus if no other additional handlers are registered to the same rule.

Angegeben von:

removeSigHandler in Klasse AbstractConnection

Typparameter:

T - signal type

Parameter:

_rule - rule to remove

_handler - handler to remove

Löst aus:

DBusException - on error

addSigHandler

public <T extends DBusSignal> AutoCloseable addSigHandler(Class<T> _type,
 String _source,
 DBusSigHandler<T> _handler)
                                                   throws DBusException

Add a Signal Handler. Adds a signal handler to call when a signal is received which matches the specified type, name and source.

Typparameter:

T - class extending DBusSignal

Parameter:

_type - The signal to watch for.

_source - The process which will send the signal. This MUST be a unique bus name and not a well known name.

_handler - The handler to call when a signal is received.

Gibt zurück:

closeable that removes signal handler

Löst aus:

DBusException - If listening for the signal on the bus failed.

ClassCastException - If type is not a sub-type of DBusSignal.

addSigHandler

public <T extends DBusSignal> AutoCloseable addSigHandler(Class<T> _type,
 String _source,
 DBusInterface _object,
 DBusSigHandler<T> _handler)
                                                   throws DBusException

Add a Signal Handler. Adds a signal handler to call when a signal is received which matches the specified type, name, source and object.

Typparameter:

T - class extending DBusSignal

Parameter:

_type - The signal to watch for.

_source - The process which will send the signal. This MUST be a unique bus name and not a well known name.

_object - The object from which the signal will be emitted

_handler - The handler to call when a signal is received.

Gibt zurück:

closeable that removes signal handler

Löst aus:

DBusException - If listening for the signal on the bus failed.

ClassCastException - If type is not a sub-type of DBusSignal.

addSigHandler

public <T extends DBusSignal> AutoCloseable addSigHandler(DBusMatchRule _rule,
 DBusSigHandler<T> _handler)
                                                   throws DBusException

Add a signal handler with the given DBusMatchRule to DBus. The rule will be added to DBus if it was not added before. If the rule was already added, the signal handler is added to the internal map receiving the same signal as the first (and additional) handlers for this rule.

Angegeben von:

addSigHandler in Klasse AbstractConnection

Typparameter:

T - signal type

Parameter:

_rule - rule to add

_handler - handler to use

Gibt zurück:

closeable that removes signal handler

Löst aus:

DBusException - on error

disconnect

public void disconnect()

Disconnect from the Bus. If this is a shared connection, it only disconnects when the last reference to the bus has called disconnect. If this is not a shared connection, disconnect will close the connection instantly.

Setzt außer Kraft:

disconnect in Klasse AbstractConnection

close

public void close()
           throws IOException

Same as disconnect.

Angegeben von:

close in Schnittstelle AutoCloseable

Angegeben von:

close in Schnittstelle Closeable

Setzt außer Kraft:

close in Klasse AbstractConnection

Löst aus:

IOException

getMachineId

public String getMachineId()

Beschreibung aus Klasse kopiert: AbstractConnection

The generated UUID of this machine.

Angegeben von:

getMachineId in Klasse AbstractConnection

Gibt zurück:

String

removeGenericSigHandler

public void removeGenericSigHandler(DBusMatchRule _rule,
 DBusSigHandler<DBusSignal> _handler)
                             throws DBusException

Beschreibung aus Klasse kopiert: AbstractConnection

Remove a generic signal handler with the given DBusMatchRule. The rule will only be removed from DBus if no other additional handlers are registered to the same rule.

Angegeben von:

removeGenericSigHandler in Klasse AbstractConnection

Parameter:

_rule - rule to remove

_handler - handler to remove

Löst aus:

DBusException - on error

addGenericSigHandler

public AutoCloseable addGenericSigHandler(DBusMatchRule _rule,
 DBusSigHandler<DBusSignal> _handler)
                                   throws DBusException

Beschreibung aus Klasse kopiert: AbstractConnection

Adds a DBusMatchRule to with a generic signal handler. Generic signal handlers allow receiving different signals with the same handler. If the rule was already added, the signal handler is added to the internal map receiving the same signal as the first (and additional) handlers for this rule.

Angegeben von:

addGenericSigHandler in Klasse AbstractConnection

Parameter:

_rule - rule to add

_handler - handler to use

Gibt zurück:

closeable that removes signal handler

Löst aus:

DBusException - on error