Bech: Category:Documentation in English

Bech — Sat, 24 Mar 2012 11:29:36 GMT

Category:Documentation in English

Wynand.winterbach: Moved this out from D-Bus_examples

Wynand.winterbach — Wed, 19 Dec 2007 12:55:32 GMT

Moved this out from D-Bus_examples

New page

''Read the guide to [[Installing_the_Java_D-Bus_bindings|installing the Java D-Bus bindings]] if you don't have the library installed already.''

Since both D-Bus and Java use statically typed systems, Java needs to have the D-Bus interface descriptions of the objects it will use available at compile time. The 'CreateInterface' program in the Java D-Bus distribution creates Java interfaces by introspecting D-Bus objects.

We will create a Java interface corresponding to the info.apertium.Info interface and we will store it under the file org/apertium/Info.java. To do this, execute:
<pre>CreateInterface org.apertium.info / > org/apertium/Info.java</pre>
(and remember to use <code>dbus-launch --exit-with-session</code> if this does not work).

The contents out the newly created file should look something like:
<pre>
/* File: org/apertium/Info.java */
package org.apertium;
import java.util.List;
import org.freedesktop.dbus.DBusInterface;
public interface Info extends DBusInterface
{

public String directory();
public List<List<String>> get_pipeline(String mode);
public List<String> get_filters(String _type);
public List<String> modes();
public String mode_directory();

}
</pre>

The next step is to create our minimal Java program. Create a file called <code>TestDBus</code> with the following contents:
{{Java D-Bus snippet}}

To compile this program, we need to include the current path on the class path as well as the jar files needed by the Java D-Bus binding. To compile, execute (you should modify the directories to suit your installation):
<pre>
javac -cp .:/usr/local/share/java/dbus.jar:/usr/local/share/java/unix.jar:\
/usr/local/share/java/debug-disable.jar TestDBus.java
</pre>

To run the program, you need to specify the class paths specified above, as well as the JNI code (which installs to <code>/usr/local/lib/jni</code> by default (if you are using TCP instead of UNIX domain sockets for transport, then this won't be needed). You can run the program using:
<pre>
java -cp .:/usr/local/share/java/dbus.jar:\
/usr/local/share/java/unix.jar:/usr/local/share/java/debug-disable.jar\
-Djava.library.path=/usr/local/lib/jni TestDBus
</pre>
(and if it does not work, prefix the command with <code>dbus-launch --exit-with-session</code>).

Of course, if you are writing an application, you would hide all of these flags in a wrapper script.

[[Category:Development]]

← Older revision		Revision as of 11:29, 24 March 2012
Line 45:		Line 45:

	[[Category:Development]]		[[Category:Development]]
			[[Category:Documentation in English]]

Compiling a Java D-Bus program - Revision history

Bech: Category:Documentation in English

Wynand.winterbach: Moved this out from D-Bus_examples