org.freedesktop.dbus.DBusConnection の継承関係図

org.freedesktop.dbus.DBusConnection 連携図

クラス
class	_sighandler

class	PeerSet

公開メンバ関数
void	releaseBusName (String busname) throws DBusException

void	requestBusName (String busname) throws DBusException

String	getUniqueName ()

String []	getNames ()

DBusInterface	getPeerRemoteObject (String busname, String objectpath) throws DBusException

DBusInterface	getRemoteObject (String busname, String objectpath) throws DBusException

void	disconnect ()

void	changeThreadCount (byte newcount)

void	setWeakReferences (boolean weakreferences)

void	exportObject (String objectpath, DBusInterface object) throws DBusException

void	addFallback (String objectprefix, DBusInterface object) throws DBusException

void	removeFallback (String objectprefix)

void	unExportObject (String objectpath)

void	sendSignal (DBusSignal signal)

void	finalize ()

DBusExecutionException	getError ()

DBusAsyncReply	callMethodAsync (DBusInterface object, String m, Object... parameters)

BusAddress	getAddress () throws ParseException

静的公開メンバ関数
static DBusConnection	getConnection (String address) throws DBusException

static DBusConnection	getConnection (int bustype) throws DBusException

static DBusCallInfo	getCallInfo ()

静的公開変数類
static final int	SYSTEM = 0

static final int	SESSION = 1

static final String	DEFAULT_SYSTEM_BUS_ADDRESS = "unix:path=/var/run/dbus/system_bus_socket"

static final boolean	EXCEPTION_DEBUG

限定公開メンバ関数
void	listen ()

void	sendMessage (Message m)

限定公開変数類
Map< String, ExportedObject >	exportedObjects

Map< DBusInterface, RemoteObject >	importedObjects

Map< SignalTuple, Vector< DBusSigHandler<? extends DBusSignal > > >	handledSignals

EfficientMap	pendingCalls

Map< MethodCall, CallbackHandler<? extends Object > >	pendingCallbacks

Map< MethodCall, DBusAsyncReply<? extends Object > >	pendingCallbackReplys

LinkedList< Runnable >	runnables

LinkedList< _workerthread >	workers

FallbackContainer	fallbackcontainer

boolean	_run

_thread	thread

_sender	sender

Transport	transport

String	addr

boolean	weakreferences = false

boolean	connected = false

静的限定公開変数類
static final int	TIMEOUT = 100000

関数
DBusInterface	dynamicProxy (String source, String path) throws DBusException

DBusInterface	getExportedObject (String source, String path) throws DBusException

public< I extends DBusInterface > I	getPeerRemoteObject (String busname, String objectpath, Class< I > type) throws DBusException

public< I extends DBusInterface > I	getPeerRemoteObject (String busname, String objectpath, Class< I > type, boolean autostart) throws DBusException

public< I extends DBusInterface > I	getRemoteObject (String busname, String objectpath, Class< I > type) throws DBusException

public< I extends DBusInterface > I	getRemoteObject (String busname, String objectpath, Class< I > type, boolean autostart) throws DBusException

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

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

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

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

public< T extends DBusSignal > void	addSigHandler (Class< T > type, String source, DBusInterface object, DBusSigHandler< T > handler) throws DBusException

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

String	getExportedObject (DBusInterface i) throws DBusException

void	queueOutgoing (Message m)

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

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

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

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

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

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

静的関数
	[static initializer]

変数
EfficientQueue	outgoing

LinkedList< Error >	pendingErrors

静的変数
static final String	BUSNAME_REGEX = "^[-_a-zA-Z][-_a-zA-Z0-9](\\.[-_a-zA-Z][-_a-zA-Z0-9])*$"

static final String	CONNID_REGEX = "^:[0-9]\\.[0-9]$"

static final String	OBJECT_REGEX = "^/([-_a-zA-Z0-9]+(/[-_a-zA-Z0-9]+)*)?$"

static final byte	THREADCOUNT = 4

static final int	MAX_ARRAY_LENGTH = 67108864

static final int	MAX_NAME_LENGTH = 255

static final Pattern	dollar_pattern = Pattern.compile("[$]")

static final boolean	FLOAT_SUPPORT

非公開メンバ関数
	DBusConnection (String address) throws DBusException

非公開変数類
List< String >	busnames

int	_refcount = 0

Object	_reflock = new Object()

DBus	_dbus

静的非公開変数類
static final Map< Object, DBusConnection >	conn = new HashMap<Object, DBusConnection>()

詳解

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.

構築子と解体子

◆ DBusConnection()

org.freedesktop.dbus.DBusConnection.DBusConnection ( String address ) throws DBusException

inlineprivate

                                                                 {
         super(address);
         busnames = new Vector<String>();
 
         synchronized (_reflock) {
             _refcount = 1;
         }
 
         try {
             transport = new Transport(addr, AbstractConnection.TIMEOUT);
             connected = true;
         } catch (IOException IOe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, IOe);
             disconnect();
             throw new DBusException(getString("connectionFailure") + IOe.getMessage());
         } catch (ParseException Pe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, Pe);
             disconnect();
             throw new DBusException(getString("connectionFailure") + Pe.getMessage());
         }
 
         // start listening for calls
         listen();
 
         // register disconnect handlers
         DBusSigHandler h = new _sighandler();
         addSigHandlerWithoutMatch(org.freedesktop.DBus.Local.Disconnected.class, h);
         addSigHandlerWithoutMatch(org.freedesktop.DBus.NameAcquired.class, h);
 
         // register ourselves
         _dbus = getRemoteObject("org.freedesktop.DBus", "/org/freedesktop/DBus", DBus.class);
         try {
             busnames.add(_dbus.Hello());
         } catch (DBusExecutionException DBEe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
             throw new DBusException(DBEe.getMessage());
         }
     }

関数詳解

◆ [static initializer]()

org.freedesktop.dbus.AbstractConnection.[static initializer] ( )

inlinestaticpackageinherited

◆ addFallback()

void org.freedesktop.dbus.AbstractConnection.addFallback	(	String	objectprefix,
		DBusInterface	object
	)		throws DBusException

inlineinherited

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

引数

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

例外

DBusException If the objectpath is incorrectly formatted,

                                                                                             {
         if (null == objectprefix || "".equals(objectprefix))
             throw new DBusException(getString("missingObjectPath"));
         if (!objectprefix.matches(OBJECT_REGEX) || objectprefix.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectprefix);
         ExportedObject eo = new ExportedObject(object, weakreferences);
         fallbackcontainer.add(objectprefix, eo);
     }

◆ addSigHandler() [1/5]

public<T extends DBusSignal> void org.freedesktop.dbus.AbstractConnection.addSigHandler	(	Class< T >	type,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackageinherited

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

引数

type	The signal to watch for.
handler	The handler to call when a signal is received.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                     {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         addSigHandler(new DBusMatchRule(type), (DBusSigHandler<? extends DBusSignal>) handler);
     }

◆ addSigHandler() [2/5]

public<T extends DBusSignal> void org.freedesktop.dbus.AbstractConnection.addSigHandler	(	Class< T >	type,
		DBusInterface	object,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackageinherited

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

引数

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.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                           {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         String objectpath = importedObjects.get(object).objectpath;
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
         addSigHandler(new DBusMatchRule(type, null, objectpath), (DBusSigHandler<? extends DBusSignal>) handler);
     }

◆ addSigHandler() [3/5]

public<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.addSigHandler	(	Class< T >	type,
		String	source,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

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

引数

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.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                    {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         if (source.matches(BUSNAME_REGEX)) throw new DBusException(getString("cannotWatchSignalsWellKnownBussName"));
         if (!source.matches(CONNID_REGEX) || source.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + source);
         addSigHandler(new DBusMatchRule(type, source, null), (DBusSigHandler<? extends DBusSignal>) handler);
     }

◆ addSigHandler() [4/5]

public<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.addSigHandler	(	Class< T >	type,
		String	source,
		DBusInterface	object,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

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

引数

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.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                                          {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         if (source.matches(BUSNAME_REGEX)) throw new DBusException(getString("cannotWatchSignalsWellKnownBussName"));
         if (!source.matches(CONNID_REGEX) || source.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + source);
         String objectpath = importedObjects.get(object).objectpath;
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
         addSigHandler(new DBusMatchRule(type, source, objectpath), (DBusSigHandler<? extends DBusSignal>) handler);
     }

◆ addSigHandler() [5/5]

protected<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.addSigHandler	(	DBusMatchRule	rule,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

                                                                                                                             {
         try {
             _dbus.AddMatch(rule.toString());
         } catch (DBusExecutionException DBEe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
             throw new DBusException(DBEe.getMessage());
         }
         SignalTuple key = new SignalTuple(rule.getInterface(), rule.getMember(), rule.getObject(), rule.getSource());
         synchronized (handledSignals) {
             Vector<DBusSigHandler<? extends DBusSignal>> v = handledSignals.get(key);
             if (null == v) {
                 v = new Vector<DBusSigHandler<? extends DBusSignal>>();
                 v.add(handler);
                 handledSignals.put(key, v);
             } else
                 v.add(handler);
         }
     }

◆ addSigHandlerWithoutMatch()

protected<T extends DBusSignal> void org.freedesktop.dbus.AbstractConnection.addSigHandlerWithoutMatch	(	Class<? extends DBusSignal >	signal,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackageinherited

                                                                                                                                                         {
         DBusMatchRule rule = new DBusMatchRule(signal);
         SignalTuple key = new SignalTuple(rule.getInterface(), rule.getMember(), rule.getObject(), rule.getSource());
         synchronized (handledSignals) {
             Vector<DBusSigHandler<? extends DBusSignal>> v = handledSignals.get(key);
             if (null == v) {
                 v = new Vector<DBusSigHandler<? extends DBusSignal>>();
                 v.add(handler);
                 handledSignals.put(key, v);
             } else
                 v.add(handler);
         }
     }

◆ callMethodAsync()

DBusAsyncReply org.freedesktop.dbus.AbstractConnection.callMethodAsync	(	DBusInterface	object,
		String	m,
		Object...	parameters
	)

inlineinherited

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

引数

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.

戻り値: A handle to the call.

                                                                                                 {
         Class<?>[] types = new Class[parameters.length];
         for (int i = 0; i < parameters.length; i++)
             types[i] = parameters[i].getClass();
         RemoteObject ro = importedObjects.get(object);
 
         try {
             Method me;
             if (null == ro.iface)
                 me = object.getClass().getMethod(m, types);
             else
                 me = ro.iface.getMethod(m, types);
             return (DBusAsyncReply) RemoteInvocationHandler.executeRemoteMethod(ro, me, this, RemoteInvocationHandler.CALL_TYPE_ASYNC, null, parameters);
         } catch (DBusExecutionException DBEe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
             throw DBEe;
         } catch (Exception e) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
             throw new DBusExecutionException(e.getMessage());
         }
     }

◆ callWithCallback()

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

inlinepackageinherited

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

引数

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.

                                                                                                                         {
         if (Debug.debug) Debug.print(Debug.VERBOSE, "callWithCallback(" + object + "," + m + ", " + callback);
         Class[] types = new Class[parameters.length];
         for (int i = 0; i < parameters.length; i++)
             types[i] = parameters[i].getClass();
         RemoteObject ro = importedObjects.get(object);
 
         try {
             Method me;
             if (null == ro.iface)
                 me = object.getClass().getMethod(m, types);
             else
                 me = ro.iface.getMethod(m, types);
             RemoteInvocationHandler.executeRemoteMethod(ro, me, this, RemoteInvocationHandler.CALL_TYPE_CALLBACK, callback, parameters);
         } catch (DBusExecutionException DBEe) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
             throw DBEe;
         } catch (Exception e) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
             throw new DBusExecutionException(e.getMessage());
         }
     }

◆ changeThreadCount()

void org.freedesktop.dbus.AbstractConnection.changeThreadCount ( byte newcount )

inlineinherited

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

引数

newcount The new number of worker Threads to use.

                                                  {
         synchronized (workers) {
             if (workers.size() > newcount) {
                 int n = workers.size() - newcount;
                 for (int i = 0; i < n; i++) {
                     _workerthread t = workers.removeFirst();
                     t.halt();
                 }
             } else if (workers.size() < newcount) {
                 int n = newcount - workers.size();
                 for (int i = 0; i < n; i++) {
                     _workerthread t = new _workerthread();
                     t.start();
                     workers.add(t);
                 }
             }
         }
     }

◆ disconnect()

void org.freedesktop.dbus.DBusConnection.disconnect ( )

inline

Disconnect from the Bus. This only disconnects when the last reference to the bus has disconnect called on it or has been destroyed.

                              {
         synchronized (conn) {
             synchronized (_reflock) {
                 if (0 == --_refcount) {
                     if (Debug.debug) Debug.print(Debug.INFO, "Disconnecting DBusConnection");
                     // Set all pending messages to have an error.
                     try {
                         Error err = new Error(
                                 "org.freedesktop.DBus.Local", "org.freedesktop.DBus.Local.disconnected", 0, "s", new Object[]{getString("disconnected")});
                         synchronized (pendingCalls) {
                             long[] set = pendingCalls.getKeys();
                             for (long l : set)
                                 if (-1 != l) {
                                     MethodCall m = pendingCalls.remove(l);
                                     if (null != m)
                                         m.setReply(err);
                                 }
                             pendingCalls = null;
                         }
                         synchronized (pendingErrors) {
                             pendingErrors.add(err);
                         }
                     } catch (DBusException DBe) {
                     }
 
                     conn.remove(addr);
                     super.disconnect();
                 }
             }
         }
     }

◆ dynamicProxy()

DBusInterface org.freedesktop.dbus.DBusConnection.dynamicProxy	(	String	source,
		String	path
	)		throws DBusException

inlinepackage

                                                                                 {
         if (Debug.debug)
             Debug.print(Debug.INFO, "Introspecting " + path + " on " + source + " for dynamic proxy creation");
         try {
             DBus.Introspectable intro = getRemoteObject(source, path, DBus.Introspectable.class);
             String data = intro.Introspect();
             if (Debug.debug) Debug.print(Debug.VERBOSE, "Got introspection data: " + data);
             String[] tags = data.split("[<>]");
             Vector<String> ifaces = new Vector<String>();
             for (String tag : tags) {
                 if (tag.startsWith("interface")) {
                     ifaces.add(tag.replaceAll("^interface *name *= *['\"]([^'\"]*)['\"].*$", "$1"));
                 }
             }
             Vector<Class<? extends Object>> ifcs = new Vector<Class<? extends Object>>();
             for (String iface : ifaces) {
                 if (Debug.debug) Debug.print(Debug.DEBUG, "Trying interface " + iface);
                 int j = 0;
                 while (j >= 0) {
                     try {
                         Class ifclass = Class.forName(iface);
                         if (!ifcs.contains(ifclass))
                             ifcs.add(ifclass);
                         break;
                     } catch (Exception e) {
                     }
                     j = iface.lastIndexOf(".");
                     char[] cs = iface.toCharArray();
                     if (j >= 0) {
                         cs[j] = '$';
                         iface = String.valueOf(cs);
                     }
                 }
             }
 
             if (ifcs.size() == 0) throw new DBusException(getString("interfaceToCastNotFound"));
 
             RemoteObject ro = new RemoteObject(source, path, null, false);
             DBusInterface newi = (DBusInterface)
                     Proxy.newProxyInstance(ifcs.get(0).getClassLoader(),
                             ifcs.toArray(new Class[0]),
                             new RemoteInvocationHandler(this, ro));
             importedObjects.put(newi, ro);
             return newi;
         } catch (Exception e) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
             throw new DBusException(MessageFormat.format(getString("createProxyExportFailure"), new Object[]{path, source, e.getMessage()}));
         }
     }

◆ exportObject()

void org.freedesktop.dbus.AbstractConnection.exportObject	(	String	objectpath,
		DBusInterface	object
	)		throws DBusException

inlineinherited

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

引数

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.

例外

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

                                                                                            {
         if (null == objectpath || "".equals(objectpath))
             throw new DBusException(getString("missingObjectPath"));
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
         synchronized (exportedObjects) {
             if (null != exportedObjects.get(objectpath))
                 throw new DBusException(getString("objectAlreadyExported"));
             ExportedObject eo = new ExportedObject(object, weakreferences);
             exportedObjects.put(objectpath, eo);
             objectTree.add(objectpath, eo, eo.introspectiondata);
         }
     }

◆ finalize()

void org.freedesktop.dbus.AbstractConnection.finalize ( )

inlineinherited

                            {
         disconnect();
     }

◆ getAddress()

BusAddress org.freedesktop.dbus.AbstractConnection.getAddress ( ) throws ParseException

inlineinherited

Returns the address this connection is connected to.

                                                          {
         return new BusAddress(addr);
     }

◆ getCallInfo()

static DBusCallInfo org.freedesktop.dbus.AbstractConnection.getCallInfo ( )

inlinestaticinherited

Returns a structure with information on the current method call.

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

                                              {
         DBusCallInfo info;
         synchronized (infomap) {
             info = infomap.get(Thread.currentThread());
         }
         return info;
     }

◆ getConnection() [1/2]

static DBusConnection org.freedesktop.dbus.DBusConnection.getConnection ( String address ) throws DBusException

inlinestatic

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

引数

address The address of the bus to connect to

例外

DBusException If there is a problem connecting to the Bus.

                                                                                     {
         synchronized (conn) {
             DBusConnection c = conn.get(address);
             if (null != c) {
                 synchronized (c._reflock) {
                     c._refcount++;
                 }
                 return c;
             } else {
                 c = new DBusConnection(address);
                 conn.put(address, c);
                 return c;
             }
         }
     }

◆ getConnection() [2/2]

static DBusConnection org.freedesktop.dbus.DBusConnection.getConnection ( int bustype ) throws DBusException

inlinestatic

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

引数

bustype The Bus to connect to.

例外

DBusException If there is a problem connecting to the Bus.

参照: SYSTEM; SESSION

                                                                                  {
         synchronized (conn) {
             String s = null;
             switch (bustype) {
                 case SYSTEM:
                     s = System.getenv("DBUS_SYSTEM_BUS_ADDRESS");
                     if (null == s) s = DEFAULT_SYSTEM_BUS_ADDRESS;
                     break;
                 case SESSION:
                     s = System.getenv("DBUS_SESSION_BUS_ADDRESS");
                     if (null == s) {
                         // address gets stashed in $HOME/.dbus/session-bus/`dbus-uuidgen --get`-`sed 's/:\(.\)\..*/\1/' <<< $DISPLAY`
                         String display = System.getenv("DISPLAY");
                         if (null == display) throw new DBusException(getString("cannotResolveSessionBusAddress"));
                         File uuidfile = new File("/var/lib/dbus/machine-id");
                         if (!uuidfile.exists()) throw new DBusException(getString("cannotResolveSessionBusAddress"));
                         try {
                             BufferedReader r = new BufferedReader(new FileReader(uuidfile));
                             String uuid = r.readLine();
                             String homedir = System.getProperty("user.home");
                             File addressfile = new File(homedir + "/.dbus/session-bus",
                                     uuid + "-" + display.replaceAll(":([0-9]*)\\..*", "$1"));
                             if (!addressfile.exists())
                                 throw new DBusException(getString("cannotResolveSessionBusAddress"));
                             r = new BufferedReader(new FileReader(addressfile));
                             String l;
                             while (null != (l = r.readLine())) {
                                 if (Debug.debug) Debug.print(Debug.VERBOSE, "Reading D-Bus session data: " + l);
                                 if (l.matches("DBUS_SESSION_BUS_ADDRESS.*")) {
                                     s = l.replaceAll("^[^=]*=", "");
                                     if (Debug.debug) Debug.print(Debug.VERBOSE, "Parsing " + l + " to " + s);
                                 }
                             }
                             if (null == s || "".equals(s))
                                 throw new DBusException(getString("cannotResolveSessionBusAddress"));
                             if (Debug.debug)
                                 Debug.print(Debug.INFO, "Read bus address " + s + " from file " + addressfile.toString());
                         } catch (Exception e) {
                             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
                             throw new DBusException(getString("cannotResolveSessionBusAddress"));
                         }
                     }
                     break;
                 default:
                     throw new DBusException(getString("invalidBusType") + bustype);
             }
             DBusConnection c = conn.get(s);
             if (Debug.debug) Debug.print(Debug.VERBOSE, "Getting bus connection for " + s + ": " + c);
             if (null != c) {
                 synchronized (c._reflock) {
                     c._refcount++;
                 }
                 return c;
             } else {
                 if (Debug.debug) Debug.print(Debug.DEBUG, "Creating new bus connection to: " + s);
                 c = new DBusConnection(s);
                 conn.put(s, c);
                 return c;
             }
         }
     }

◆ getError()

DBusExecutionException org.freedesktop.dbus.AbstractConnection.getError ( )

inlineinherited

Return any DBus error which has been received.

戻り値: A DBusExecutionException, or null if no error is pending.

                                              {
         synchronized (pendingErrors) {
             if (pendingErrors.size() == 0) return null;
             else
                 return pendingErrors.removeFirst().getException();
         }
     }

◆ getExportedObject() [1/2]

String org.freedesktop.dbus.AbstractConnection.getExportedObject ( DBusInterface i ) throws DBusException

inlinepackageinherited

                                                                    {
         synchronized (exportedObjects) {
             for (String s : exportedObjects.keySet())
                 if (i.equals(exportedObjects.get(s).object.get()))
                     return s;
         }
 
         String s = importedObjects.get(i).objectpath;
         if (null != s) return s;
 
         throw new DBusException("Not an object exported or imported by this connection");
     }

◆ getExportedObject() [2/2]

DBusInterface org.freedesktop.dbus.DBusConnection.getExportedObject	(	String	source,
		String	path
	)		throws DBusException

inlinepackage

                                                                                      {
         ExportedObject o = null;
         synchronized (exportedObjects) {
             o = exportedObjects.get(path);
         }
         if (null != o && null == o.object.get()) {
             unExportObject(path);
             o = null;
         }
         if (null != o) return o.object.get();
         if (null == source) throw new DBusException(getString("objectNotExportedNoRemoteSpecified"));
         return dynamicProxy(source, path);
     }

◆ getNames()

String [] org.freedesktop.dbus.DBusConnection.getNames ( )

inline

Returns all the names owned by this connection.

                                {
         Set<String> names = new TreeSet<String>();
         names.addAll(busnames);
         return names.toArray(new String[0]);
     }

◆ getPeerRemoteObject() [1/3]

public<I extends DBusInterface> I org.freedesktop.dbus.DBusConnection.getPeerRemoteObject	(	String	busname,
		String	objectpath,
		Class< I >	type
	)		throws DBusException

inlinepackage

                                                                                                                                   {
         return getPeerRemoteObject(busname, objectpath, type, true);
     }

◆ getPeerRemoteObject() [2/3]

DBusInterface org.freedesktop.dbus.DBusConnection.getPeerRemoteObject	(	String	busname,
		String	objectpath
	)		throws DBusException

inline

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.

引数

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.$

戻り値: A reference to a remote object.

例外

ClassCastException	If type is not a sub-type of DBusInterface
DBusException	If busname or objectpath are incorrectly formatted.

                                                                                                      {
         if (null == busname) throw new DBusException(getString("nullBusName"));
 
         if ((!busname.matches(BUSNAME_REGEX) && !busname.matches(CONNID_REGEX))
                 || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + busname);
 
         String unique = _dbus.GetNameOwner(busname);
 
         return dynamicProxy(unique, objectpath);
     }

◆ getPeerRemoteObject() [3/3]

public<I extends DBusInterface> I org.freedesktop.dbus.DBusConnection.getPeerRemoteObject	(	String	busname,
		String	objectpath,
		Class< I >	type,
		boolean	autostart
	)		throws DBusException

inlinepackage

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.

引数

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.

戻り値: A reference to a remote object.

例外

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.

                                                                                                                                                      {
         if (null == busname) throw new DBusException(getString("nullBusName"));
 
         if ((!busname.matches(BUSNAME_REGEX) && !busname.matches(CONNID_REGEX))
                 || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + busname);
 
         String unique = _dbus.GetNameOwner(busname);
 
         return getRemoteObject(unique, objectpath, type, autostart);
     }

◆ getRemoteObject() [1/3]

DBusInterface org.freedesktop.dbus.DBusConnection.getRemoteObject	(	String	busname,
		String	objectpath
	)		throws DBusException

inline

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.

引数

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.

戻り値: A reference to a remote object.

例外

ClassCastException	If type is not a sub-type of DBusInterface
DBusException	If busname or objectpath are incorrectly formatted.

                                                                                                  {
         if (null == busname) throw new DBusException(getString("nullBusName"));
         if (null == objectpath) throw new DBusException(getString("nullObjectPath"));
 
         if ((!busname.matches(BUSNAME_REGEX) && !busname.matches(CONNID_REGEX))
                 || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + busname);
 
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
 
         return dynamicProxy(busname, objectpath);
     }

◆ getRemoteObject() [2/3]

public<I extends DBusInterface> I org.freedesktop.dbus.DBusConnection.getRemoteObject	(	String	busname,
		String	objectpath,
		Class< I >	type
	)		throws DBusException

inlinepackage

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.

引数

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.

戻り値: A reference to a remote object.

例外

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.

                                                                                                                               {
         return getRemoteObject(busname, objectpath, type, true);
     }

◆ getRemoteObject() [3/3]

public<I extends DBusInterface> I org.freedesktop.dbus.DBusConnection.getRemoteObject	(	String	busname,
		String	objectpath,
		Class< I >	type,
		boolean	autostart
	)		throws DBusException

inlinepackage

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.

引数

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.

戻り値: A reference to a remote object.

例外

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.

                                                                                                                                                  {
         if (null == busname) throw new DBusException(getString("nullBusName"));
         if (null == objectpath) throw new DBusException(getString("nullObjectPath"));
         if (null == type) throw new ClassCastException(getString("notDBusInterface"));
 
         if ((!busname.matches(BUSNAME_REGEX) && !busname.matches(CONNID_REGEX))
                 || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + busname);
 
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
 
         if (!DBusInterface.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusInterface"));
 
         // don't let people import things which don't have a
         // valid D-Bus interface name
         if (type.getName().equals(type.getSimpleName()))
             throw new DBusException(getString("interfaceNotAllowedOutsidePackage"));
 
         RemoteObject ro = new RemoteObject(busname, objectpath, type, autostart);
         I i = (I) Proxy.newProxyInstance(type.getClassLoader(),
                 new Class[]{type}, new RemoteInvocationHandler(this, ro));
         importedObjects.put(i, ro);
         return i;
     }

◆ getUniqueName()

String org.freedesktop.dbus.DBusConnection.getUniqueName ( )

inline

Returns the unique name of this connection.

                                   {
         return busnames.get(0);
     }

◆ listen()

void org.freedesktop.dbus.AbstractConnection.listen ( )

inlineprotectedinherited

                             {
         // start listening
         thread = new _thread();
         thread.start();
         sender = new _sender();
         sender.start();
     }

◆ queueOutgoing()

void org.freedesktop.dbus.AbstractConnection.queueOutgoing ( Message m )

inlinepackageinherited

                                   {
         synchronized (outgoing) {
             if (null == outgoing) return;
             outgoing.add(m);
             if (Debug.debug) Debug.print(Debug.DEBUG, "Notifying outgoing thread");
             outgoing.notifyAll();
         }
     }

◆ releaseBusName()

void org.freedesktop.dbus.DBusConnection.releaseBusName ( String busname ) throws DBusException

inline

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

引数

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

例外

DBusException If the busname is incorrectly formatted.

                                                                     {
         if (!busname.matches(BUSNAME_REGEX) || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName"));
         synchronized (this.busnames) {
             UInt32 rv;
             try {
                 rv = _dbus.ReleaseName(busname);
             } catch (DBusExecutionException DBEe) {
                 if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
                 throw new DBusException(DBEe.getMessage());
             }
             this.busnames.remove(busname);
         }
     }

◆ removeFallback()

void org.freedesktop.dbus.AbstractConnection.removeFallback ( String objectprefix )

inlineinherited

Remove a fallback

引数

objectprefix The prefix to remove the fallback for.

                                                     {
         fallbackcontainer.remove(objectprefix);
     }

◆ removeSigHandler() [1/5]

public<T extends DBusSignal> void org.freedesktop.dbus.AbstractConnection.removeSigHandler	(	Class< T >	type,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackageinherited

Remove a Signal Handler. Stops listening for this signal.

引数

type	The signal to watch for.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                        {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         removeSigHandler(new DBusMatchRule(type), handler);
     }

◆ removeSigHandler() [2/5]

public<T extends DBusSignal> void org.freedesktop.dbus.AbstractConnection.removeSigHandler	(	Class< T >	type,
		DBusInterface	object,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackageinherited

Remove a Signal Handler. Stops listening for this signal.

引数

type	The signal to watch for.
object	The object emitting the signal.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                              {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         String objectpath = importedObjects.get(object).objectpath;
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
         removeSigHandler(new DBusMatchRule(type, null, objectpath), handler);
     }

◆ removeSigHandler() [3/5]

public<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.removeSigHandler	(	Class< T >	type,
		String	source,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

Remove a Signal Handler. Stops listening for this signal.

引数

type	The signal to watch for.
source	The source of the signal.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                       {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         if (source.matches(BUSNAME_REGEX)) throw new DBusException(getString("cannotWatchSignalsWellKnownBussName"));
         if (!source.matches(CONNID_REGEX) || source.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + source);
         removeSigHandler(new DBusMatchRule(type, source, null), handler);
     }

◆ removeSigHandler() [4/5]

public<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.removeSigHandler	(	Class< T >	type,
		String	source,
		DBusInterface	object,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

Remove a Signal Handler. Stops listening for this signal.

引数

type	The signal to watch for.
source	The source of the signal.
object	The object emitting the signal.

例外

DBusException	If listening for the signal on the bus failed.
ClassCastException	If type is not a sub-type of DBusSignal.

                                                                                                                                                             {
         if (!DBusSignal.class.isAssignableFrom(type)) throw new ClassCastException(getString("notDBusSignal"));
         if (source.matches(BUSNAME_REGEX)) throw new DBusException(getString("cannotWatchSignalsWellKnownBussName"));
         if (!source.matches(CONNID_REGEX) || source.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName") + source);
         String objectpath = importedObjects.get(object).objectpath;
         if (!objectpath.matches(OBJECT_REGEX) || objectpath.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidObjectPath") + objectpath);
         removeSigHandler(new DBusMatchRule(type, source, objectpath), handler);
     }

◆ removeSigHandler() [5/5]

protected<T extends DBusSignal> void org.freedesktop.dbus.DBusConnection.removeSigHandler	(	DBusMatchRule	rule,
		DBusSigHandler< T >	handler
	)		throws DBusException

inlinepackage

                                                                                                                                {
 
         SignalTuple key = new SignalTuple(rule.getInterface(), rule.getMember(), rule.getObject(), rule.getSource());
         synchronized (handledSignals) {
             Vector<DBusSigHandler<? extends DBusSignal>> v = handledSignals.get(key);
             if (null != v) {
                 v.remove(handler);
                 if (0 == v.size()) {
                     handledSignals.remove(key);
                     try {
                         _dbus.RemoveMatch(rule.toString());
                     } catch (NotConnected NC) {
                         if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, NC);
                     } catch (DBusExecutionException DBEe) {
                         if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
                         throw new DBusException(DBEe.getMessage());
                     }
                 }
             }
         }
     }

◆ requestBusName()

void org.freedesktop.dbus.DBusConnection.requestBusName ( String busname ) throws DBusException

inline

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

引数

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

例外

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

                                                                     {
         if (!busname.matches(BUSNAME_REGEX) || busname.length() > MAX_NAME_LENGTH)
             throw new DBusException(getString("invalidBusName"));
         synchronized (this.busnames) {
             UInt32 rv;
             try {
                 rv = _dbus.RequestName(busname,
                         new UInt32(DBus.DBUS_NAME_FLAG_REPLACE_EXISTING |
                                 DBus.DBUS_NAME_FLAG_DO_NOT_QUEUE));
             } catch (DBusExecutionException DBEe) {
                 if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, DBEe);
                 throw new DBusException(DBEe.getMessage());
             }
             switch (rv.intValue()) {
                 case DBus.DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER:
                     break;
                 case DBus.DBUS_REQUEST_NAME_REPLY_IN_QUEUE:
                     throw new DBusException(getString("dbusRegistrationFailure"));
                 case DBus.DBUS_REQUEST_NAME_REPLY_EXISTS:
                     throw new DBusException(getString("dbusRegistrationFailure"));
                 case DBus.DBUS_REQUEST_NAME_REPLY_ALREADY_OWNER:
                     break;
                 default:
                     break;
             }
             this.busnames.add(busname);
         }
     }

◆ sendMessage()

void org.freedesktop.dbus.AbstractConnection.sendMessage ( Message m )

inlineprotectedinherited

                                           {
         try {
             if (!connected) throw new NotConnected(getString("disconnected"));
             if (m instanceof DBusSignal)
                 ((DBusSignal) m).appendbody(this);
 
             if (m instanceof MethodCall) {
                 if (0 == (m.getFlags() & Message.Flags.NO_REPLY_EXPECTED))
                     if (null == pendingCalls)
                         ((MethodCall) m).setReply(new Error("org.freedesktop.DBus.Local", "org.freedesktop.DBus.Local.disconnected", 0, "s", new Object[]{getString("disconnected")}));
                     else synchronized (pendingCalls) {
                         pendingCalls.put(m.getSerial(), (MethodCall) m);
                     }
             }
 
             transport.mout.writeMessage(m);
 
         } catch (Exception e) {
             if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
             if (m instanceof MethodCall && e instanceof NotConnected)
                 try {
                     ((MethodCall) m).setReply(new Error("org.freedesktop.DBus.Local", "org.freedesktop.DBus.Local.disconnected", 0, "s", new Object[]{getString("disconnected")}));
                 } catch (DBusException DBe) {
                 }
             if (m instanceof MethodCall && e instanceof DBusExecutionException)
                 try {
                     ((MethodCall) m).setReply(new Error(m, e));
                 } catch (DBusException DBe) {
                 }
             else if (m instanceof MethodCall)
                 try {
                     if (Debug.debug) Debug.print(Debug.INFO, "Setting reply to " + m + " as an error");
                     ((MethodCall) m).setReply(new Error(m, new DBusExecutionException(getString("messageFailedSend") + e.getMessage())));
                 } catch (DBusException DBe) {
                 }
             else if (m instanceof MethodReturn)
                 try {
                     transport.mout.writeMessage(new Error(m, e));
                 } catch (IOException IOe) {
                     if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, IOe);
                 } catch (DBusException IOe) {
                     if (EXCEPTION_DEBUG && Debug.debug) Debug.print(Debug.ERR, e);
                 }
             if (e instanceof IOException) disconnect();
         }
     }

◆ sendSignal()

void org.freedesktop.dbus.AbstractConnection.sendSignal ( DBusSignal signal )

inlineinherited

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.

引数

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.

戻り値: A reference to a remote object.

例外

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. Send a signal.

引数

signal The signal to send.

                                               {
         queueOutgoing(signal);
     }

◆ setWeakReferences()

void org.freedesktop.dbus.AbstractConnection.setWeakReferences ( boolean weakreferences )

inlineinherited

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.

                                                           {
         this.weakreferences = weakreferences;
     }

◆ unExportObject()

void org.freedesktop.dbus.AbstractConnection.unExportObject ( String objectpath )

inlineinherited

Stop Exporting an object

引数

objectpath The objectpath to stop exporting.

                                                   {
         synchronized (exportedObjects) {
             exportedObjects.remove(objectpath);
             objectTree.remove(objectpath);
         }
     }

protectedinherited

◆ SESSION

final int org.freedesktop.dbus.DBusConnection.SESSION = 1

static

Session Bus

◆ SYSTEM

final int org.freedesktop.dbus.DBusConnection.SYSTEM = 0

static

System Bus

◆ thread

_thread org.freedesktop.dbus.AbstractConnection.thread

protectedinherited

◆ THREADCOUNT

final byte org.freedesktop.dbus.AbstractConnection.THREADCOUNT = 4

staticpackageinherited

◆ TIMEOUT

final int org.freedesktop.dbus.AbstractConnection.TIMEOUT = 100000

staticprotectedinherited

Timeout in us on checking the BUS for incoming messages and sending outgoing messages

◆ transport

Transport org.freedesktop.dbus.AbstractConnection.transport

protectedinherited

◆ weakreferences

boolean org.freedesktop.dbus.AbstractConnection.weakreferences = false

protectedinherited

◆ workers

LinkedList<_workerthread> org.freedesktop.dbus.AbstractConnection.workers

protectedinherited

このクラス詳解は次のファイルから抽出されました:

D:/AppData/doxygen/keycloak/federation/src/federation/sssd/src/main/java/org/freedesktop/dbus/DBusConnection.java

クラス

公開メンバ関数

静的公開メンバ関数

静的公開変数類

限定公開メンバ関数

限定公開変数類

静的限定公開変数類

関数

静的関数

変数

静的変数

非公開メンバ関数

非公開変数類

静的非公開変数類

詳解

構築子と解体子

◆ DBusConnection()

関数詳解

◆ [static initializer]()

◆ addFallback()

◆ addSigHandler() [1/5]

◆ addSigHandler() [2/5]

◆ addSigHandler() [3/5]

◆ addSigHandler() [4/5]

◆ addSigHandler() [5/5]

◆ addSigHandlerWithoutMatch()

◆ callMethodAsync()

◆ callWithCallback()

◆ changeThreadCount()

◆ disconnect()

◆ dynamicProxy()

◆ exportObject()

◆ finalize()

◆ getAddress()

◆ getCallInfo()

◆ getConnection() [1/2]

◆ getConnection() [2/2]

◆ getError()

◆ getExportedObject() [1/2]

◆ getExportedObject() [2/2]

◆ getNames()

◆ getPeerRemoteObject() [1/3]

◆ getPeerRemoteObject() [2/3]

◆ getPeerRemoteObject() [3/3]

◆ getRemoteObject() [1/3]

◆ getRemoteObject() [2/3]

◆ getRemoteObject() [3/3]

◆ getUniqueName()

◆ listen()

◆ queueOutgoing()

◆ releaseBusName()

◆ removeFallback()

◆ removeSigHandler() [1/5]

◆ removeSigHandler() [2/5]

◆ removeSigHandler() [3/5]

◆ removeSigHandler() [4/5]

◆ removeSigHandler() [5/5]

◆ requestBusName()

◆ sendMessage()

◆ sendSignal()

◆ setWeakReferences()

◆ unExportObject()

メンバ詳解

◆ _dbus

◆ _refcount

◆ _reflock

◆ _run

◆ addr

◆ BUSNAME_REGEX

◆ busnames

◆ conn

◆ connected

◆ CONNID_REGEX

◆ DEFAULT_SYSTEM_BUS_ADDRESS

◆ dollar_pattern

◆ EXCEPTION_DEBUG

◆ exportedObjects

◆ fallbackcontainer

◆ FLOAT_SUPPORT

◆ handledSignals