diff options
Diffstat (limited to 'dbus-java.tex')
| -rw-r--r-- | dbus-java.tex | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/dbus-java.tex b/dbus-java.tex index 8900128..abc1e46 100644 --- a/dbus-java.tex +++ b/dbus-java.tex @@ -290,6 +290,36 @@ public class DBusImpl implements DBus \label{fig:class} \end{figure} +\subsection{Interface name overriding} + +It is highly recommended that the Java interface and package name match the +D-Bus interface. However, if, for some reason, this is not possible then the +name can be overridden by use of an Annotation. + +To override the Java interface name you should add an annotation to the +interface of {\tt +DBusInterfaceName\footnote{\url{\javadocroot/org/freedesktop/dbus/DBusInterfaceName.html}}} +with a value of the desired D-Bus interface name. An example of this can be seen in +figure \ref{fig:interfacename}. + +\begin{figure}[htb] +\begin{center} +\begin{verbatim} +package my.package; +import org.freedesktop.dbus.DBusInterface; +import org.freedesktop.dbus.DBusInterfaceName; + +@DBusInterfaceName("my.otherpackage.Remote") +public interface Remote extends DBusInterface +{ + ... +} +\end{verbatim} +\end{center} +\caption{Overloading the name of an interface.} +\label{fig:interfacename} +\end{figure} + \section{DBusSignal} Signals are also declared as part of an interface. The Java API |