Dbus简介与简单的收发示例程序

http://linux.chinaunix.net/techdoc/beginner/2009/08/11/1129569.shtml

Dbus简介与简单的收发示例程序。                                                                                                                                                  D-BUS 是一个大有前途的消息总线和活动系统，正开始深入地渗透到 Linux® 桌面之中。了解创建它的原因、它的用途以及发展前景。  D-BUS 本质上是 进程间通信（inter-process communication）（IPC）的一个实现。不过，有一些特性使得 D-BUS 远远不是“只是另一个 IPC 实现”。有很多不同的 IPC 实现，因为每一个都定位于解决特定的明确定义的问题。CORBA 是用于面向对象编程中复杂的 IPC 的一个强大的解决方案。DCOP 是一个较轻量级的 IPC 框架，功能较少，但是可以很好地集成到 K 桌面环境中。SOAP 和 XML-RPC 设计用于 Web 服务，因而使用 HTTP 作为其传输协议。D-BUS 设计用于桌面应用程序和 OS 通信。  桌面应用程序通信  典型的桌面都会有多个应用程序在运行，而且，它们经常需要彼此进行通信。DCOP 是一个用于 KDE 的解决方案，但是它依赖于 Qt，所以不能用于其他桌面环境之中。类似的，Bonobo 是一个用于 GNOME 的解决方案，但是非常笨重，因为它是基于 CORBA 的。它还依赖于 GObject，所以也不能用于 GNOME 之外。 D-BUS 的目标是将 DCOP 和 Bonobo 替换为简单的 IPC，并集成这两种桌面环境。由于尽可能地减少了 D-BUS 所需的依赖，所以其他可能会使用 D-BUS 的应用程序不用担心引入过多依赖。  桌面/操作系统通信  术语“操作系统”在这里不仅包括内核，还包括系统后台进程。例如，通过使用 D-BUS 的 udev（Linux 2.6 中取代 devfs 的，提供动态 /dev 目录），当设备（比如一个 USB 照相机）插入时会发放出一个信号。这样可以更紧密地将硬件集成到桌面中，从而改善用户体验。  D-BUS 特性  D-BUS 有一些有趣的特性，使其像是一个非常有前途的选择。  协议是低延迟而且低开销的，设计得小而高效，以便最小化传送的往返时间。另外，协议 是二进制的，而不是文本的，这样就排除了费时的序列化过程。由于只面向本地机器处理的使用情形，所以所有的消息都以其自然字节次序发送。字节次序在每个消 息中声明，所以如果一个 D-BUS 消息通过网络传输到远程的主机，它仍可以被正确地识别出来。  从开发者的角度来看，D-BUS 是易于使用的。有线协议容易理解，客户机程序库以直观的方式对其进行包装。  程序库还设计用于为其他系统所包装。预期，GNOME 将使用 GObject 创建包装 D-BUS 的包装器（实际上这些已经部分存在了，将 D-BUS 集成入它们的事件循环），KDE 将使用 Qt 创建类似的包装器。由于 Python 具有面向对象特性和灵活的类型，已经有了具备类似接口的 Python 包装器。  最后，D-BUS 正在 freedesktop.org 的保护下进行开发，在那里，来自 GNOME、KDE 以及其他组织的对此感兴趣的成员参与了设计与实现。  D-BUS 的内部工作方式  典型的 D-BUS 设置将由几个总线构成。将有一个持久的 系统总线（system bus），它在引导时就会启动。这个总线由操作系统和后台进程使用，安全性非常好，以使得任意的应用程序不能欺骗系统事件。还将有很多 会话总线（session buses），这些总线当用户登录后启动，属于那个用户私有。它是用户的应用程序用来通信的一个会话总线。当然，如果一个应用程序需要接收来自系统总线的 消息，它不如直接连接到系统总线 —— 不过，它可以发送的消息将是受限的。  一旦应用程序连接到了一个总线，它们就必须通过添加 匹配器（matchers） 来声明它们希望收到哪种消息。匹配器为可以基于接口、对象路径和方法进行接收的消息指定一组规则（见后）。这样就使得应用程序可以集中精力去处理它们想处 理的内容，以实现消息的高效路由，并保持总线上消息的预期数量，以使得不会因为这些消息导致所有应用程序的性能下降并变得很慢。 对象  本质上，D-BUS 是一个对等（peer-to-peer）的协议 —— 每个消息都有一个源和一个目的。这些地址被指定为 对象路径。概念上，所有使用 D-BUS 的应用程序都包括一组 对象，消息发送到或者发送自特定对象 —— 不是应用程序 —— 这些对象由对象路径来标识。  另外，每个对象都可以支持一个或多个 接口（interfaces）。这些接口看起来类似于 Java 中的接口或者 C++ 中的纯粹的虚类（pure virtual classes）。不过，没有选项来检查对象是否实现了它们所声明的接口，而且也没有办法可以调查对象内部以使列出其支持的接口。接口用于名称空间和方法 名称，因此一个单独的对象可以有名称相同而接口不同的多个方法。  消息  在 D-BUS 中有四种类型的消息：方法调用（method calls）、方法返回（method returns）、信号（signals）和错误（errors）。要执行 D-BUS 对象的方法，您需要向对象发送一个方法调用消息。它将完成一些处理并返回一个方法返回消息或者错误消息。信号的不同之处在于它们不返回任何内容：既没有 “信号返回”消息，也没有任何类型的错误消息。  消息也可以有任意的参数。参数是强类型的，类型的范围是从基本的非派生类型（布尔（booleans）、字节（bytes）、整型（integers））到高层次数据结构（字符串（strings）、数组（ arrays）和字典（dictionaries））。  服务  服务（Services） 是 D-BUS 的最高层次抽象，它们的实现当前还在不断发展变化。应用程序可以通过一个总线来注册一个服务，如果成功，则应用程序就已经 获得 了那个服务。其他应用程序可以检查在总线上是否已经存在一个特定的服务，如果没有可以要求总线启动它。服务抽象的细节 —— 尤其是服务活化 —— 当前正处于发展之中，应该会有变化。  用例  尽管 D-BUS 相对较新，但是却迅速地得到了采用。如前所述，可以构建具有 D-BUS 支持的 udev 以使得当热插拔（hot-plug）设备时它可以发送一个信号。任何应用程序都可以侦听这些事件并当接收到这些事件时执行动作。例如，gnome- volume-manager 可以检测到 USB 存储棒的插入并自动挂载它；或者，当插入一个数码相机时它可以自动下载照片。  一个更为有趣但很不实用的例子是 Jamboree 和 Ringaling 的结合。Jamboree 是一个简单的音乐播放器，它具有 D-BUS 接口，以使得它可以被告知播放、到下一首歌、改变音量等等。Ringaling 是一个小程序，它打开 /dev/ttyS0（一个串行端口）并观察接收到的内容。当 Ringaling 发现文本“RING”时，就通过 D-BUS 告知 Jamboree 减小音量。最终的结果是，如果您的计算机上插入了一个调制解调器，而且电话铃响，则音乐音量就会为您减小。这 正是计算机所追求的! 代码示例  现在，让我们来接触一些使用 D-BUS 代码的示例。  dbus-ping-send.c 每秒通过会话总线发送一个参数为字符串“Ping!”的信号。我使用 Glib 来管理总线，以使得我不需要自己来处理总线的连接细节。  清单 1. dbus-ping-send.c  #include  　　#include  　　 　　static gboolean send_ping (DBusConnection *bus); 　　 　　int 　　main (int argc, char **argv) 　　{ 　　　GMainLoop *loop; 　　　DBusConnection *bus; 　　　DBusError error; 　　 　　　/* Create a new event loop to run in */ 　　　loop = g_main_loop_new (NULL, FALSE); 　　 　　　/* Get a connection to the session bus */ 　　　dbus_error_init (&error); 　　　bus = dbus_bus_get (DBUS_BUS_SESSION, &error); 　　　if (!bus) { 　　　　g_warning ("Failed to connect to the D-BUS daemon: %s", error.message); 　　　　dbus_error_free (&error); 　　　　return 1; 　　　} 　　 　　　/* Set up this connection to work in a GLib event loop */ 　　　dbus_connection_setup_with_g_main (bus, NULL); 　　　/* Every second call send_ping() with the bus as an argument*/ 　　　g_timeout_add (1000, (GSourceFunc)send_ping, bus); 　　 　　　/* Start the event loop */ 　　　g_main_loop_run (loop); 　　　return 0; 　　} 　　 　　static gboolean 　　send_ping (DBusConnection *bus) 　　{ 　　　DBusMessage *message; 　　 　　　/* Create a new signal "Ping" on the  "com.burtonini.dbus.Signal" interface, 　　　 * from the object "/com/burtonini/dbus/ping". */ 　　　message = dbus_message_new_signal  ("/com/burtonini/dbus/ping", 　　　　　　"com.burtonini.dbus.Signal", "Ping"); 　　　/* Append the string "Ping!" to the signal */ 　　　dbus_message_append_args (message, 　　　　　　　　　　　　　　　　DBUS_TYPE_STRING, "Ping!", 　　　　　　　　　　　　　　　　DBUS_TYPE_INVALID); 　　　/* Send the signal */ 　　　dbus_connection_send (bus, message, NULL); 　　　/* Free the signal now we have finished with it */ 　　　dbus_message_unref (message); 　　　/* Tell the user we send a signal */ 　　　g_print("Ping!\n"); 　　　/* Return TRUE to tell the event loop  we want to be called again */ 　　　return TRUE; 　　} main 函数创建一个 GLib 事件循环，获得会话总线的一个连接，并将 D-BUS 事件处理集成到 Glib 事件循环之中。然后它创建了一个名为 send_ping 间隔为一秒的计时器，并启动事件循环。 //filename : send.c #include  #include  #include  #define  DBUS_INTERFACE_COM_BBKTEL_LOCAL "com.bbktel.DBus.Local" #define  BBK_IME_SIGNAL_OBJECT "/bbk_ime/signal/object" #define  BBK_IME_SIGNAL_TYPE  "bbk_ime.signal.type" #define  BBK_IME_SIGNAL_NAME  "bbk_ime" #define  BBK_IME_SHOW_PANEL 1 #define  BBK_IME_SHOW_SUB_PANEL 2 #define  BBK_IME_HIDE_PANEL 10 static gboolean send_ping (DBusConnection *bus); int main (int argc, char **argv) {     GMainLoop *loop;     DBusConnection *bus;     DBusError error;     /* Create a new event loop to run in */     loop = g_main_loop_new (NULL, FALSE);     /* Get a connection to the session bus */     dbus_error_init (&error);     bus = dbus_bus_get (DBUS_BUS_SESSION, &error);     if (!bus) {         g_warning ("Failed to connect to the D-BUS daemon: %s", error.message);         dbus_error_free (&error);         return 1;     }     /* Set up this connection to work in a GLib event loop */     dbus_connection_setup_with_g_main (bus, NULL);     /* Every second call send_ping() with the bus as an argument*/     g_timeout_add (1000, (GSourceFunc)send_ping, bus);     /* Start the event loop */     g_main_loop_run (loop);     return 0; } static gboolean send_ping (DBusConnection *bus) {     DBusMessage *message;     gchar *str;     static i=0;     str =  g_strdup_printf("PING123!");     /* Create a new signal "Ping" on the "com.burtonini.dbus.Signal" interface,      * from the object "/com/burtonini/dbus/ping". */     message = dbus_message_new_signal (BBK_IME_SIGNAL_OBJECT,             BBK_IME_SIGNAL_TYPE, BBK_IME_SIGNAL_NAME);     /* Append the string "Ping!" to the signal */     dbus_message_append_args (message,             DBUS_TYPE_UINT32, &i,             DBUS_TYPE_INVALID);     i++;     if (i== 20) i=0;     g_free(str);     /* Send the signal */     dbus_connection_send (bus, message, NULL);     /* Free the signal now we have finished with it */     dbus_message_unref (message);     /* Tell the user we send a signal */     g_print("Ping!\n");     /* Return TRUE to tell the event loop we want to be called again */     return TRUE; }     static DBusHandlerResult                                                                  signal_filter (DBusConnection *connection, DBusMessage *message, void *user_data)             {                                                                                                                                                                                               /* User data is the event loop we are running in */                                           GMainLoop *loop = user_data;                                                                                                                                                                /* A signal from the bus saying we are about to be disconnected */                            if (dbus_message_is_signal                                                                            (message, DBUS_INTERFACE_COM_BBKTEL_LOCAL, "Disconnected")) {                                                                                                                           /* Tell the main loop to quit */                                                              g_main_loop_quit (loop);                                                                      /* We have handled this message, don't pass it on */                                          return DBUS_HANDLER_RESULT_HANDLED;                                                       }                                                                                             /* A Ping signal on the com.burtonini.dbus.Signal interface */                                else if (dbus_message_is_signal (message, BBK_IME_SIGNAL_TYPE, BBK_IME_SIGNAL_NAME)) {                                                                                                          DBusError error;                                                                              char *s;                                                                                      int iGetValue;                                                                                                                                                                              dbus_error_init (&error);                                                                     if (dbus_message_get_args                                                                             (message, &error, DBUS_TYPE_UINT32, &iGetValue, DBUS_TYPE_INVALID)) {                                                                                                               //    g_print("Ping received: %s\n", s);                                                          g_print("Get number : %d\n", iGetValue);                                                      switch (iGetValue)                                                                            {                                                                                                 case BBK_IME_SHOW_PANEL:                                                                          bbk_show_main_panel();                      break;                                                                                    case BBK_IME_SHOW_SUB_PANEL:                                                                      break;                case BBK_IME_HIDE_PANEL:                                                                      on_clicked_hide_panel(NULL, NULL);                                                      break;                                                                                default:                                                                                      g_print("Not define number.\n");                                                          break;                                                                                                                                                                      }                                                                             //            dbus_free (s);                                                                      } else {                                                                                                                                                                                g_print("Ping received, but error getting message: %s\n", error.message);                 dbus_error_free (&error);                                                             }                                                                                         return DBUS_HANDLER_RESULT_HANDLED;                                                   }                                                                                         return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;                                           }  void main(int argc, char *argv[])                                                                       {                                                                                                  GMainLoop *loop;                                                                               DBusConnection *bus;                                                                           DBusError error;                                                                               gchar *interface_str;                                                                                                                                                                         loop = g_main_loop_new (NULL, FALSE);                                                          dbus_error_init (&error);                                                                      bus = dbus_bus_get (DBUS_BUS_SESSION, &error  );                                               if (!bus) {                                                                                        g_warning ("Failed to connect to the D-BUS daemon: %s", error.message);                        dbus_error_free (&error);                                                                      exit(1);                                                                                   }                                                                                              dbus_connection_setup_with_g_main (bus, NULL);                                                 /* listening to messages from all objects as no path is specified */                           interface_str =  g_strdup_printf("type='signal',interface='%s'", BBK_IME_SIGNAL_TYPE);         dbus_bus_add_match (bus, interface_str, &error);                                               g_free(interface_str);                                                                         dbus_connection_add_filter (bus, signal_filter, loop, NULL);                                   //g_main_loop_run (loop);                                                                      return ;                                                                                   }