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 ;                                                                                  
}                                                                                             
                  

你可能感兴趣的:(Dbus简介与简单的收发示例程序)