From 95b17300b6ea8c5ff7c8641559f7cb6f3b81285a Mon Sep 17 00:00:00 2001 From: Matthew Johnson Date: Wed, 22 Nov 2006 17:31:46 +0000 Subject: documentation for Path --- TODO | 1 - dbus-java.tex | 9 +++++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/TODO b/TODO index e723e8b..322cdab 100644 --- a/TODO +++ b/TODO @@ -1,4 +1,3 @@ - * add Path to documentation * support Enums as UInt32s * use native java backend * allow 'virtual' object handlers, so that all object paths under a certain hierarchy are handled by the same object diff --git a/dbus-java.tex b/dbus-java.tex index 400f956..f30bd12 100644 --- a/dbus-java.tex +++ b/dbus-java.tex @@ -540,6 +540,14 @@ receive an object path they will automatically convert it into the object you are exporting with that object path. You can pass remote objects back to their processes in a similar fashion. +Using a parameter of type {\tt DBusInterface} can cause the automatic creation +of a proxy object using introspection. If the remote app does not support +introspection, or the object does not exist at the time you receive the message +then this will fail. In that case the parameter can be declared to be of type +{\tt Path}. In this case no automatic creation will be performed and you can +get the path as a string with either the {\tt getPath} or {\tt toString} methods +on the {\tt Path} object. + \subsection{Multiple Return Values} @@ -609,6 +617,7 @@ UInt64 & DBUS\_TYPE\_UINT64 \\ double & DBUS\_TYPE\_DOUBLE \\ Double & DBUS\_TYPE\_DOUBLE \\ String & DBUS\_TYPE\_STRING \\ +Path & DBUS\_TYPE\_OBJECT\_PATH \\ $<$T$>$ & DBUS\_TYPE\_VARIANT \\ Variant & DBUS\_TYPE\_VARIANT \\ ? extends Struct & DBUS\_TYPE\_STRUCT \\ -- cgit v1.2.3