{"id":26,"date":"2011-03-10T14:01:32","date_gmt":"2011-03-10T14:01:32","guid":{"rendered":"http:\/\/liberty.fdn.fr\/?p=26"},"modified":"2025-08-17T20:12:59","modified_gmt":"2025-08-17T20:12:59","slug":"introduction-a-dbus-avec-qt4","status":"publish","type":"post","link":"http:\/\/renaudguezennec.eu\/index.php\/2011\/03\/10\/introduction-a-dbus-avec-qt4\/","title":{"rendered":"Introduction \u00e0 Dbus avec Qt4"},"content":{"rendered":"
\n

Dbus<\/h2>\n

Dbus est un bus syst\u00e8me de messagerie. C’est un moyen simple pour des applications de communiquer entre elles. En plus de la communication interprocessus, Dbus est aussi un outil aidant au cycle de vie du processus. Il peut vous permettre de n’autoriser qu’une seule instance de votre application ou de votre daemon. Il peut vous permettre de d\u00e9marrer votre application ou daemon \u00e0 la demande quand elles sont n\u00e9cessaires. Il est possible d’\u00e9tablir deux types de connexions: point \u00e0 point ou point d’acc\u00e8s (daemon central). Gr\u00e2ce au daemon, vos applications peuvent \u00eatre pr\u00e9venues du branchement d’un nouvel composant mat\u00e9riel. Le bus de session (un par utilisateur connect\u00e9) est le canal g\u00e9n\u00e9rique de communication. Dbus est destin\u00e9 \u00e0 la communication entre application d’un m\u00eame ordinateur. Il est cependant possible de communiquer par TCP\/IP crypt\u00e9 avec un dossier home partag\u00e9 par NFS. Ce genre d’usage reste rare et exp\u00e9rimental.<\/p>\n

Il est possible d’utiliser Dbus dans de nombreux langages: C\/C++, python, ruby, perl, java, C#. Je vais me concenter sur l’impl\u00e9mentation de Dbus dans Qt4, dans cet article.<\/p>\n<\/div>\n

\n

<\/a><\/p>\n

Dbus dans Qt4<\/h2>\n

Qt4 implement sa propre API Dbus. Le support de Dbus sur windows \u00e9tant en cours (d’apr\u00e8s le site internet), Qt a \u00e9t\u00e9 sage de regrouper toutes les fonctionnalit\u00e9s dans un module. Pour des environnements linux, il suffit d’installer la biblioth\u00e8que et \u00e0 l’\u00e9dition des liens, ajouter<\/p>\n

QT += dbus<\/code><\/p>\n

Dans le fichier pro pour inclure le module dbus \u00e0 votre projet.<\/p>\n

Les deux classes importantes sont QDbusMessage et QDbusInterface. La premi\u00e8re permet d’envoyer facilement un message vers un service Dbus. C’est un moyen rapide pour communiquer une information vers une application dont vous ne maitrisez rien. Le QBusInterface permet une communication plus transparente, car tous les signaux\/slots de votre application (d’une classe, pour \u00eatre pr\u00e9cis) seront mis sur Dbus.<\/p>\n<\/div>\n

\n

<\/a><\/p>\n

Monitorer Dbus<\/h2>\n

Vous ne le savez peut-\u00eatre pas mais votre syst\u00e8me GNU\/Linux (s’il est assez moderne) utilise probablement DBUS en continue. Pour se donner une id\u00e9e, il existe deux utilitaires assez int\u00e9ressant: dbus-monitor et qdbusviewer.<\/p>\n

\"capture<\/a><\/p>\n<\/div>\n

\n

 <\/p>\n

Connexion \u00e0 un service : Pidgin<\/h2>\n

Nous allons maintenant impl\u00e9ment\u00e9 une solution pour utiliser un service d’une application. Nous voulons mettre \u00e0 jour la petite phrase de status de pidgin. Ainsi votre logiciel de lecture audio pourra mettre en petite phrase la chanson actuellement jou\u00e9e.<\/p>\n

La premi\u00e8re \u00e9tape est d’identifi\u00e9 la fonction (et son chemin) qui nous int\u00e9resse. En g\u00e9n\u00e9ral, les logiciels libres fournissent dans leur documentation l’API dbus qu’ils offrent. Cependant, l’outil qdbusviewer vous permet de voir toutes ces informations.<\/p>\n

En terme de code, cela reste tr\u00e8s simple. Vous d\u00e9clarez un message Dbus. Il faut d\u00e9finir les bonnes valeurs: chemin, destinataire, noms..<\/p>\n<\/div>\n

[pastacode lang=”cpp” message=”Connexion \u00e0 un service dbus” highlight=”” provider=”manual” manual=”QDBusConnection%20sessionbus%20%3D%20QDBusConnection%3A%3AsessionBus()%3B%0A%0Aif%20(%20!sessionbus.isConnected()%20)%0A%7B%0A%20%20%20%20qDebug()%20%3C%3C%20%22Could%20not%20connect%20to%20session%20bus%22%3B%0A%7D%0A%20%20%20%20QDBusMessage%20m%20%3D%20%0A%20%20%20%20QDBusMessage%3A%3AcreateMethodCall(%22im.pidgin.purple.PurpleService%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22%2Fim%2Fpidgin%2Fpurple%2FPurpleObject%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22im.pidgin.purple.PurpleInterface%22%2C%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%22PurpleUtilSetCurrentSong%22)%3B%0A%20%20%20%20QList%3CQVariant%3E%20args%3B%0A%20%20%20%20args%20%3C%3C%20m_p-%3ETitle%20%3C%3C%20m_p-%3EArtist%20%3C%3C%20m_p-%3Ealbum%3B%0A%20%20%20%20m.setArguments(args)%3B%0A%20%20%20%20QDBusMessage%20metadatamsg%20%3D%20sessionbus.call(m)%3B%0A%20%20%20%20if(metadatamsg.type()%20!%3D%20QDBusMessage%3A%3AReplyMessage)%0A%20%20%20%20%20%20%20%20qDebug()%20%3C%3C%20%22Error%20its%20not%20a%20message%20%22%20%3C%3C%20metadatamsg.type()%20%3C%3C%20metadatamsg.errorMessage%20()%3B”\/]<\/p>\n

La premi\u00e8re \u00e9tape est de d\u00e9finir quel bus vous allez utiliser : le sessionBus ou le systembus? Dans notre cas, c’est le sessionBus. On verifie que tout se passe bien niveau connection au bus. Il convient ensuite de cr\u00e9er un message. Les param\u00e8tres du messages sont les suivants :<\/p>\n
    \n
  • Le nom du service (la colonne de gauche de qdbusviewer)<\/li>\n
  • Le chemin vers l’objet (concat\u00e9nation de tous les noeuds de l’arbre sauf celui de l’interface).<\/li>\n
  • Le chemin vers l’interface (noeud en italique dans qdbusviewer).<\/li>\n
  • Une liste d’arguments peut \u00eatre pass\u00e9e \u00e0 l’appel de la m\u00e9thode du service. Dans notre cas, nous passons le titre de la chanson, l’artiste et le nom de l’album.<\/li>\n
  • Derni\u00e8re \u00e9tape, appel de la m\u00e9thode suivit d’une v\u00e9rification d’erreur.<\/li>\n<\/ul>\n

    La voie royale pour faire communiquer deux applications via dbus gr\u00e2ce \u00e0 Qt est l’utilisation des adaptors. Ils traduisent les signaux et slots d’une classe Qt en message Dbus. C’est totalement transparent. Pour faire un exemple simple, je vais faire une application qui propose un service “dbus_example_Service”, de d\u00e9finition de brigthness et les clients peuvent d\u00e9finir le nouveau de volume. Plusieurs applications peuvent envoyer le volume au service et elles peuvent \u00e9galement recevoir la brightness. Une seule et unique application peut faire office de service. Deux instance de l’application “dbus_example_Service” vont entrain\u00e9 des comportements inconnus.<\/p>\n

    qdbuscpp2xml -S -M mainwindow.h -o org.homelinux.renaudguezennec.xml\r\n\r\nqdbusxml2cpp -c GuiAdaptor -a guiadaptor.h:guiadaptor.cpp org.homelinux.renaudguezennec.xml\r\n\r\nqdbusxml2cpp -c GuiAdaptor -p test.h:test.cpp org.homelinux.renaudguezennec.xml\r\n<\/pre>\n
    La premi\u00e8re commande vous permet de g\u00e9n\u00e9rer un fichier xml: org.homelinux.renaudguezennec.xml qui contiendra l’ensemble de l’API de votre fichier .h.
    \nLe resultat est de la forme suivante:<\/p>\n<\/div>\n
    [pastacode lang=”markup” message=”Xml g\u00e9n\u00e9r\u00e9” highlight=”” provider=”manual” manual=”%3C!DOCTYPE%20node%20PUBLIC%20%22-%2F%2Ffreedesktop%2F%2FDTD%20D-BUS%20Object%20Introspection%201.0%2F%2FEN%22%20%22http%3A%2F%2Fwww.freedesktop.org%2Fstandards%2Fdbus%2F1.0%2Fintrospect.dtd%22%3E%0A%3Cnode%3E%0A%20%20%3Cinterface%20name%3D%22org.homelinux.renaudguezennec%22%3E%0A%20%20%20%20%3Csignal%20name%3D%22brightnessChanged%22%3E%0A%20%20%20%20%20%20%3Carg%20type%3D%22i%22%20direction%3D%22out%22%2F%3E%0A%20%20%20%20%3C%2Fsignal%3E%0A%20%20%20%20%3Cmethod%20name%3D%22setVolumeLevel%22%3E%0A%20%20%20%20%20%20%3Carg%20type%3D%22i%22%20direction%3D%22in%22%2F%3E%0A%20%20%20%20%3C%2Fmethod%3E%0A%20%20%3C%2Finterface%3E%0A%3C%2Fnode%3E”\/]<\/p>\n
    \n
    <\/pre>\n
    La deuxi\u00e8me commande cr\u00e9e une classe GuiAdaptor (dans les fichiers: guiadaptor.h et guiadaptor.cpp) qui expose l’API d’\u00e9crire dans le xml. Cette classe sera utile cot\u00e9 service.<\/p>\n
    La troisi\u00e8me commande cr\u00e9e une classe GuiAdaptor (dans les fichiers: test.h et test.cpp) que sera capable de contacter l’API d\u00e9crite dans le xml. Nous allons utiliser cette classe dans le client pour l’API d\u00e9crite dans le xml.<\/p>\n
    L’\u00e9tape suivante consiste \u00e0 g\u00e9n\u00e9rer une classe Adaptor qui transformera vos signaux\/Slots Qt en message dbus. Il est utilis\u00e9 c\u00f4t\u00e9 service. Dans le main de votre programme, il convient d’instancier un adaptor g\u00e9n\u00e9r\u00e9 (ici: ControlPanelAdaptor), comme cela:<\/p>\n
    [pastacode lang=”cpp” message=”Creation de service” highlight=”” provider=”manual” manual=”%23include%20%3CQtGui%2FQApplication%3E%0A%23include%20%22mainwindow.h%22%0A%23include%20%22guiadaptor.h%22%0Aint%20main(int%20argc%2C%20char%20*argv%5B%5D)%0A%7B%0A%20%20%20%20QApplication%20a(argc%2C%20argv)%3B%0A%20%20%20%20MainWindow%20w%3B%0A%20%20%20%20new%20GuiAdaptor(%26w)%3B%0A%20%20%20%20w.show()%3B%0A%0A%20%20%20%20QDBusConnection%20connection%20%3D%20QDBusConnection%3A%3AsessionBus()%3B%0A%20%20%20%20bool%20rel%20%3D%20connection.registerService(%22org.homelinux.renaudguezennec%22)%3B%0A%20%20%20%20rel%20%3D%20connection.registerObject(%22%2F%22%2C%26w)%3B%0A%0A%20%20%20%20return%20a.exec()%3B%0A%7D”\/]<\/p>\n
    <\/pre>\n
    A ce stade, votre application peut-\u00eatre un service dbus. Il fournit une API \u00e0 travers DBus. Nous allons voir maintenant comment cr\u00e9er des clients qui vont utiliser cette API.<\/p>\n
    Nous allons donc construire un nouveau projet : dbus_example_client. Il contiendra la r\u00e9ciproque du service. Le service est capable d’envoyer le signal brightnessChanged et re\u00e7oit son volume par l’appel \u00e0 setVolumeLevel. Le client lui sera capable d’appeler setVolumeLevel du service et de recevoir la valeur de brightnessChanged. Pour se faire, nous allons utilis\u00e9 la class GuiAdaptor (test.h et test.cpp) dans notre application cliente.<\/p>\n
    [pastacode lang=”cpp” message=”Client Qt” highlight=”” provider=”manual” manual=”%23include%20%3CQtGui%2FQApplication%3E%0A%23include%20%22mainwindow.h%22%0A%23include%20%22test.h%22%0A%0Aint%20main(int%20argc%2C%20char%20*argv%5B%5D)%0A%7B%0A%20%20%20QApplication%20a(argc%2C%20argv)%3B%0A%20%20%20MainWindow%20w%3B%0A%0A%20%20%20%20GuiAdaptor*%20adapteur%20%3D%20new%20GuiAdaptor(%22org.homelinux.renaudguezennec%22%2C%20%0A%20%20%20%20%22%2F%22%2CQDBusConnection%3A%3AsessionBus()%2C0)%3B%0A%0A%20%20%20%20QObject%3A%3Aconnect(%26w%2CSIGNAL(volumeChanged(int))%2Cadapteur%2C%0A%20%20%20%20SLOT(setVolumeLevel(int)))%3B%0A%0A%20%20%20%20QObject%3A%3Aconnect(adapteur%2CSIGNAL(brightnessChanged(int))%2C%26w%2C%0A%20%20%20%20SLOT(setBrightnessChanged(int)))%3B%0A%20%20%20%20w.show()%3B%0A%0A%20%20%20%20return%20a.exec()%3B%0A%7D”\/]<\/p>\n
    <\/pre>\n
    Comme vous pouvez le voir, il suffit d’instancier une classe GuiAdaptor (#include “test.h”) et de connecter les signals et les slots de notre application avec cette instance. En l’occurence, notre application emet le signal volumeChanged(int), nous le lions au slot setVolumeLevel(int) de notre adapteur. Le signal \u00e9mit par l’adapteur est r\u00e9cup\u00e9r\u00e9 dans un slot de notre application.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
    Dbus Dbus est un bus syst\u00e8me de messagerie. C’est un moyen simple pour des applications de communiquer entre elles. En plus de la communication interprocessus, Dbus est aussi un outil aidant au cycle de vie du processus. Il peut vous permettre de n’autoriser qu’une seule instance de votre application ou de votre daemon. Il peut […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[80,23],"tags":[24,22,10,11],"class_list":["post-26","post","type-post","status-publish","format-standard","hentry","category-fr","category-tutorial","tag-dbus","tag-linux","tag-qt","tag-qt4"],"_links":{"self":[{"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/posts\/26","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/comments?post=26"}],"version-history":[{"count":5,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/posts\/26\/revisions"}],"predecessor-version":[{"id":5079,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/posts\/26\/revisions\/5079"}],"wp:attachment":[{"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/media?parent=26"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/categories?post=26"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/renaudguezennec.eu\/index.php\/wp-json\/wp\/v2\/tags?post=26"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}