org.freedesktop.dbus.connections

Class AbstractConnection

java.lang.Object

org.freedesktop.dbus.connections.AbstractConnection

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

DBusConnection, DirectConnection

public abstract class AbstractConnection
extends Object
implements Closeable

Handles a connection to DBus.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BUSNAME_REGEX
static String	CONNID_REGEX
static Pattern	DOLLAR_PATTERN
static boolean	FLOAT_SUPPORT
static int	MAX_ARRAY_LENGTH
static int	MAX_NAME_LENGTH
static String	OBJECT_REGEX

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractConnection(String address)

Method Summary

Modifier and Type	Method and Description
void	addFallback(String objectprefix, DBusInterface object) Export an object as a fallback object.
protected abstract void	addGenericSigHandler(DBusMatchRule rule, DBusSigHandler<DBusSignal> handler)
<T extends DBusSignal> void	addSigHandler(Class<T> type, DBusInterface object, DBusSigHandler<T> handler) Add a Signal Handler.
<T extends DBusSignal> void	addSigHandler(Class<T> type, DBusSigHandler<T> handler) Add a Signal Handler.
protected abstract <T extends DBusSignal> void	addSigHandler(DBusMatchRule rule, DBusSigHandler<T> handler)
protected <T extends DBusSignal> void	addSigHandlerWithoutMatch(Class<? extends DBusSignal> signal, DBusSigHandler<T> handler)
DBusAsyncReply<?>	callMethodAsync(DBusInterface object, String m, Object... parameters) Call a method asynchronously and get a handle with which to get the reply.
<A> void	callWithCallback(DBusInterface object, String m, CallbackHandler<A> callback, Object... parameters) Call a method asynchronously and set a callback.
void	changeThreadCount(byte newcount) Change the number of worker threads to receive method calls and handle signals.
void	close() Disconnect this session (for use in try-with-resources).
void	disconnect() Disconnect from the Bus.
void	exportObject(String objectpath, DBusInterface object) Export an object so that its methods can be called on DBus.
BusAddress	getAddress() Returns the address this connection is connected to.
static DBusCallInfo	getCallInfo() Returns a structure with information on the current method call.
DBusExecutionException	getError() Return any DBus error which has been received.
String	getExportedObject(DBusInterface _interface)
abstract DBusInterface	getExportedObject(String source, String path)
protected Map<String,ExportedObject>	getExportedObjects()
protected Map<SignalTuple,List<DBusSigHandler<DBusSignal>>>	getGenericHandledSignals()
protected Map<SignalTuple,List<DBusSigHandler<? extends DBusSignal>>>	getHandledSignals()
protected Map<DBusInterface,RemoteObject>	getImportedObjects()
abstract String	getMachineId()
protected ObjectTree	getObjectTree()
protected Map<Long,MethodCall>	getPendingCalls()
protected Queue<Error>	getPendingErrorQueue()
protected void	handleException(AbstractConnection dbusConnection, Message methodOrSignal, DBusExecutionException exception)
boolean	isConnected()
protected void	listen() Start reading and sending messages.
void	queueCallback(MethodCall _call, Method _method, CallbackHandler<?> _callback)
void	removeFallback(String objectprefix) Remove a fallback
protected abstract void	removeGenericSigHandler(DBusMatchRule rule, DBusSigHandler<DBusSignal> handler)
<T extends DBusSignal> void	removeSigHandler(Class<T> type, DBusInterface object, DBusSigHandler<T> handler) Remove a Signal Handler.
<T extends DBusSignal> void	removeSigHandler(Class<T> type, DBusSigHandler<T> handler) Remove a Signal Handler.
protected abstract <T extends DBusSignal> void	removeSigHandler(DBusMatchRule rule, DBusSigHandler<T> handler)
void	sendMessage(Message _message) Send a message or signal to the DBus daemon.
void	setWeakReferences(boolean _weakreferences) If set to true the bus will not hold a strong reference to exported objects.
void	unExportObject(String objectpath) Stop Exporting an object

Methods inherited from class java.lang.Object

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

Field Detail

FLOAT_SUPPORT

public static final boolean FLOAT_SUPPORT

BUSNAME_REGEX

public static final String BUSNAME_REGEX

See Also:

Constant Field Values

CONNID_REGEX

public static final String CONNID_REGEX

See Also:

Constant Field Values

OBJECT_REGEX

public static final String OBJECT_REGEX

See Also:

Constant Field Values

DOLLAR_PATTERN

public static final Pattern DOLLAR_PATTERN

MAX_ARRAY_LENGTH

public static final int MAX_ARRAY_LENGTH

See Also:

Constant Field Values

MAX_NAME_LENGTH

public static final int MAX_NAME_LENGTH

See Also:

Constant Field Values

Constructor Detail

AbstractConnection

protected AbstractConnection(String address)
                      throws DBusException

Throws:

DBusException

Method Detail

getExportedObject

public abstract DBusInterface getExportedObject(String source,
                                                String path)
                                         throws DBusException

Throws:

DBusException

removeSigHandler

protected abstract <T extends DBusSignal> void removeSigHandler(DBusMatchRule rule,
                                                                DBusSigHandler<T> handler)
                                                         throws DBusException

Throws:

DBusException

addSigHandler

protected abstract <T extends DBusSignal> void addSigHandler(DBusMatchRule rule,
                                                             DBusSigHandler<T> handler)
                                                      throws DBusException

Throws:

DBusException

removeGenericSigHandler

protected abstract void removeGenericSigHandler(DBusMatchRule rule,
                                                DBusSigHandler<DBusSignal> handler)
                                         throws DBusException

Throws:

DBusException

addGenericSigHandler

protected abstract void addGenericSigHandler(DBusMatchRule rule,
                                             DBusSigHandler<DBusSignal> handler)
                                      throws DBusException

Throws:

DBusException

getMachineId

public abstract String getMachineId()

listen

protected void listen()

Start reading and sending messages.

changeThreadCount

public void changeThreadCount(byte newcount)

Change the number of worker threads to receive method calls and handle signals. Default is 4 threads

Parameters:

newcount - The new number of worker Threads to use.

getExportedObject

public String getExportedObject(DBusInterface _interface)
                         throws DBusException

Throws:

DBusException

setWeakReferences

public void setWeakReferences(boolean _weakreferences)

If set to true the bus will not hold a strong reference to exported objects. If they go out of scope they will automatically be unexported from the bus. The default is to hold a strong reference, which means objects must be explicitly unexported before they will be garbage collected.

Parameters:

_weakreferences - reference

exportObject

public void exportObject(String objectpath,
                         DBusInterface object)
                  throws DBusException

Export an object so that its methods can be called on DBus.

Parameters:

objectpath - The path to the object we are exposing. MUST be in slash-notation, like "/org/freedesktop/Local", and SHOULD end with a capitalised term. Only one object may be exposed on each path at any one time, but an object may be exposed on several paths at once.

object - The object to export.

Throws:

DBusException - If the objectpath is already exporting an object. or if objectpath is incorrectly formatted,

addFallback

public void addFallback(String objectprefix,
                        DBusInterface object)
                 throws DBusException

Export an object as a fallback object. This object will have it's methods invoked for all paths starting with this object path.

Parameters:

objectprefix - The path below which the fallback handles calls. MUST be in slash-notation, like "/org/freedesktop/Local",

object - The object to export.

Throws:

DBusException - If the objectpath is incorrectly formatted,

removeFallback

public void removeFallback(String objectprefix)

Remove a fallback

Parameters:

objectprefix - The prefix to remove the fallback for.

unExportObject

public void unExportObject(String objectpath)

Stop Exporting an object

Parameters:

objectpath - The objectpath to stop exporting.

sendMessage

public void sendMessage(Message _message)

Send a message or signal to the DBus daemon.

Parameters:

_message - message to send

removeSigHandler

public <T extends DBusSignal> void removeSigHandler(Class<T> type,
                                                    DBusSigHandler<T> handler)
                                             throws DBusException

Remove a Signal Handler. Stops listening for this signal.

Type Parameters:

T - class extending DBusSignal

Parameters:

type - The signal to watch for.

handler - the handler

Throws:

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,
                                                    DBusInterface object,
                                                    DBusSigHandler<T> handler)
                                             throws DBusException

Remove a Signal Handler. Stops listening for this signal.

Type Parameters:

T - class extending DBusSignal

Parameters:

type - The signal to watch for.

object - The object emitting the signal.

handler - the handler

Throws:

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> void addSigHandler(Class<T> type,
                                                 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 and name.

Type Parameters:

T - class extending DBusSignal

Parameters:

type - The signal to watch for.

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

Throws:

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> void addSigHandler(Class<T> type,
                                                 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 and object.

Type Parameters:

T - class extending DBusSignal

Parameters:

type - The signal to watch for.

object - The object from which the signal will be emitted

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

Throws:

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

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

addSigHandlerWithoutMatch

protected <T extends DBusSignal> void addSigHandlerWithoutMatch(Class<? extends DBusSignal> signal,
                                                                DBusSigHandler<T> handler)
                                                         throws DBusException

Throws:

DBusException

disconnect

public void disconnect()

Disconnect from the Bus.

close

public void close()
           throws IOException

Disconnect this session (for use in try-with-resources).

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

callWithCallback

public <A> void callWithCallback(DBusInterface object,
                                 String m,
                                 CallbackHandler<A> callback,
                                 Object... parameters)

Call a method asynchronously and set a callback. This handler will be called in a separate thread.

Type Parameters:

A - whatever

Parameters:

object - The remote object on which to call the method.

m - The name of the method on the interface to call.

callback - The callback handler.

parameters - The parameters to call the method with.

callMethodAsync

public DBusAsyncReply<?> callMethodAsync(DBusInterface object,
                                         String m,
                                         Object... parameters)

Call a method asynchronously and get a handle with which to get the reply.

Parameters:

object - The remote object on which to call the method.

m - The name of the method on the interface to call.

parameters - The parameters to call the method with.

Returns:

A handle to the call.

handleException

protected void handleException(AbstractConnection dbusConnection,
                               Message methodOrSignal,
                               DBusExecutionException exception)

queueCallback

public void queueCallback(MethodCall _call,
                          Method _method,
                          CallbackHandler<?> _callback)

getExportedObjects

protected Map<String,ExportedObject> getExportedObjects()

getCallInfo

public static DBusCallInfo getCallInfo()

Returns a structure with information on the current method call.

Returns:

the DBusCallInfo for this method call, or null if we are not in a method call.

getError

public DBusExecutionException getError()

Return any DBus error which has been received.

Returns:

A DBusExecutionException, or null if no error is pending.

getAddress

public BusAddress getAddress()

Returns the address this connection is connected to.

Returns:

new BusAddress object

isConnected

public boolean isConnected()

getPendingErrorQueue

protected Queue<Error> getPendingErrorQueue()

getHandledSignals

protected Map<SignalTuple,List<DBusSigHandler<? extends DBusSignal>>> getHandledSignals()

getGenericHandledSignals

protected Map<SignalTuple,List<DBusSigHandler<DBusSignal>>> getGenericHandledSignals()

getPendingCalls

protected Map<Long,MethodCall> getPendingCalls()

getImportedObjects

protected Map<DBusInterface,RemoteObject> getImportedObjects()

getObjectTree

protected ObjectTree getObjectTree()