D-Bus utilisation en Java - Appel de méthode

Après avoir présenté l'installation de D-Bus aussi bien sous Unix que sous Windows, nous allons voir comment l'utiliser avec quelques exemples simples.

 

Application HelloWorld

Cette première application va simplement recevoir une chaine de caractère et la renvoyer à son émetteur précédée de la chaine "Hello world :".
L'application est exposée sur D-Bus par les commandes dbusConnection.requestName("mon.premier.bus") qui indiquera le nom à utiliser pour dialoguer avec elle.
La commande dbusConnection.exportObject("/Main", this) indique les objets qui seront exposés. L'objet exposé ici exposera la méthode "helloWorld" héritée de l'interface DBusHelloWorldInterface. Les méthodes, ainsi que les paramètres sont découverts dynamiquement.

Déclaration de l'interface

 package example;  
 import org.freedesktop.dbus.DBusInterface;  
   
 public interface DBusHelloWorldInterface extends DBusInterface {  
      public String helloWorld(String nom);  
 }  

Implémentation de l'interface

 package example;  
 import org.freedesktop.dbus.*;

 public class DBusHelloWorldClass implements DBusHelloWorldInterface {  
      private DBusConnection dbusConnection;  
      private boolean stop = false;  

      @Override  
      public String helloWorld(String name) {  
           stop = true;  
           return "Hello world : " + name;  
      }  

      public boolean isRemote() {  
           return false;  
      }  

      public void start() {  
           try {  
                dbusConnection = DBusConnection.getConnection(DBusConnection.SESSION);  
                dbusConnection.requestBusName("mon.premier.bus");  
                dbusConnection.exportObject("/Main", this);  
                while (!stop) {  
                     try {  
                          Thread.sleep(1000);  
                     } catch (Exception e) {  
                     }  
                }  
                dbusConnection.disconnect();  
           } catch (Exception e) {  
                e.printStackTrace();  
           }  
      }  

      /**  
       * @param args  
       */  
      public static void main(String[] args) {  
           new DBusHelloWorldClass().start();  
      }       
 }  

Envoi d'un message à l'application

D-Bus fournit une commande qui permet d'appeler une méthode à partir de la ligne de commande.
La commande suivante va appeler la méthode helloWorld décrite précédemment et afficher la réponse  string "Hello world : Marco".

 dbus-send --print-reply --dest='mon.premier.bus' /Main mon.premier.bus.helloWorld string:'Marco'  

Les échanges peuvent être suivis à l'aide de la commande dbus-monitor qui affiche tous les messages échangés sur D-BUS. Cette commande permet également de retrouver les données nécessaires à transmettre par la commande dbus-send.