dbus的入门于应用--dbus的C编程接口

2023-11-21 18:38
文章标签 接口 入门 应用 编程 dbus

本文主要是介绍dbus的入门于应用--dbus的C编程接口，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！


大部分资料都讲了很多东西却最终没有让我搞清楚怎么用 DBus，不就是一个 IPC 通信的工具么？就没有一点实用些的资料么？看了很多资料之后还是觉得只见树木不见森林。仔细整理下思路，觉得还是应该从最基本的方面入门，先从 DBus 的 C API 入手学习，有了这些知识，就算麻烦，也可以先在完成一个基本功能的例子程序的同时大概的知道 DBus 的运行机制。


在网上找到这么一篇文章：http://www.matthew.ath.cx/misc/dbus， 正合我意，下面的内容基本是对这篇文章的翻译和扩充。


注意：


翻译没有得到原文作者同意，原文也很简单易懂，最好去读原文。如果收到投诉，我会立即撤掉本文的。
本文不是一篇好的 DBus 入门，有很多基本的东西不在记述之内。
一般情况下不会直接使用 C API 进行 DBus 的编程，而是使用某种 DBus-binding，但我觉得理解 DBus 的 C API 对完整地理解 DBus 是非常重要的。

虽然 DBus 是用 C 写的，而且本文写的是 C API，但是 DBus 设计中充满的面向对象的思想，请注意。


一、共通部分的代码
在使用 DBus 进行通信的时候，有一些代码是无论如何都会使用到的。首先，你必须要连接上 Dbus，一般来说，系统中会有一个 System Bus 和一个 Session Bus（他们的差别，请参考我另外的笔记）。其次，你需要在 Dbus 中注册一个名字，用于标识自己。为了简单起见，这里先不考虑重名的情况：

DBusError err;
DBusConnection* conn;
int ret;
// initialise the errors
dbus_error_init(&err);// connect to the bus
conn = dbus_bus_get(DBUS_BUS_SESSION, &err);
if (dbus_error_is_set(&err)) {fprintf(stderr, "Connection Error (%s)\n", err.message);dbus_error_free(&err);
}
if (NULL == conn) {exit(1);
}
// request a name on the bus
ret = dbus_bus_request_name(conn, "test.method.server",DBUS_NAME_FLAG_REPLACE_EXISTING, &err);
if (dbus_error_is_set(&err)) {fprintf(stderr, "Name Error (%s)\n", err.message);dbus_error_free(&err);
}
if (DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER != ret) {exit(1);
}
一般来说，连接上 Dbus 和注册一个名称，应该是在程序最开始运行的时候就会进行的操作。


当然，在程序的结束的时候，需要关闭掉与 Dbus 的连接。使用下面的函数：

dbus_connection_close(conn);

二、发送信号（Sending Signal）
信号是一种广播的消息，你可以简单的发出一个信号，这样，所有连接在 DBus 总线上并注册了接受对应信号的进程，都会收到这个信号。为了发出一个信号，需要的只是创建一个 DBusMessage 对象来代表信号，然后追加上一些需要发出的参数，就可以发向总线了。发完之后还需要释放掉 Message。如果内存不足的话，这下面不少函数都会返回 false，所以一般情况下你都需要处理这些情况的返回值。

dbus_uint32_t serial = 0; // unique number to associate replies with requests
DBusMessage* msg;
DBusMessageIter args;// create a signal and check for errors
msg = dbus_message_new_signal("/test/signal/Object", // object name of the signal"test.signal.Type", // interface name of the signal"Test"); // name of the signal
if (NULL == msg)
{fprintf(stderr, "Message Null\n");exit(1);
}// append arguments onto signal
dbus_message_iter_init_append(msg, &args);
if (!dbus_message_iter_append_basic(&args, DBUS_TYPE_STRING, &sigvalue)) {fprintf(stderr, "Out Of Memory!\n");exit(1);
}// send the message and flush the connection
if (!dbus_connection_send(conn, msg, &serial)) {fprintf(stderr, "Out Of Memory!\n");exit(1);
}
dbus_connection_flush(conn);// free the message
dbus_message_unref(msg);

三、调用方法（Calling a Method）
调用一个远程方法（remote method）与发送一个信号（sending a signal）是很类似的。需要创建一个 DBusMessage，然后通过注册在 DBus 上的名称指定发送的对象。然后追加相应的参数，但调用方法分为两种，一种是阻塞式的，另一种则可以异步调用。异步调用的时候会得到一个 DBusMessage* 的返回，从这个 DBusMessage 中可以获取一些返回的参数。

调用方法1：

DBusMessage* msg;
DBusMessageIter args;
DBusPendingCall* pending;msg = dbus_message_new_method_call("test.method.server", // target for the method call"/test/method/Object", // object to call on"test.method.Type", // interface to call on"Method"); // method name
if (NULL == msg) {fprintf(stderr, "Message Null\n");exit(1);
}// append arguments
dbus_message_iter_init_append(msg, &args);
if (!dbus_message_iter_append_basic(&args, DBUS_TYPE_STRING, ¶m)) {fprintf(stderr, "Out Of Memory!\n");exit(1);
}// send message and get a handle for a reply
if (!dbus_connection_send_with_reply (conn, msg, &pending, -1)) { // -1 is default timeoutfprintf(stderr, "Out Of Memory!\n");exit(1);
}
if (NULL == pending) {fprintf(stderr, "Pending Call Null\n");exit(1);
}
dbus_connection_flush(conn);// free message
dbus_message_unref(msg);
调用方法2： 
bool stat;
dbus_uint32_t level;// block until we receive a reply
dbus_pending_call_block(pending);// get the reply message
msg = dbus_pending_call_steal_reply(pending);
if (NULL == msg) {fprintf(stderr, "Reply Null\n");exit(1);
}
// free the pending message handle
dbus_pending_call_unref(pending);// read the parameters
if (!dbus_message_iter_init(msg, &args))fprintf(stderr, "Message has no arguments!\n");
else if (DBUS_TYPE_BOOLEAN != dbus_message_iter_get_arg_type(&args))fprintf(stderr, "Argument is not boolean!\n");
elsedbus_message_iter_get_basic(&args, &stat);if (!dbus_message_iter_next(&args))fprintf(stderr, "Message has too few arguments!\n");
else if (DBUS_TYPE_UINT32 != dbus_message_iter_get_arg_type(&args))fprintf(stderr, "Argument is not int!\n");
elsedbus_message_iter_get_basic(&args, &level);printf("Got Reply: %d, %d\n", stat, level);// free reply and close connection
dbus_message_unref(msg);

四、接收消息（Receiving a Signal）
接下来的两种操作主要是从总线从读取消息并处理这些消息。
要接收一个消息，你首先需要告诉 DBus 你对什么样的消息感兴趣： 

// add a rule for which messages we want to see
dbus_bus_add_match(conn,"type='signal',interface='test.signal.Type'",&err); // see signals from the given interface
dbus_connection_flush(conn);
if (dbus_error_is_set(&err)) {fprintf(stderr, "Match Error (%s)\n", err.message);exit(1);
}

然后，进程就可以在一个循环中等待这类消息的发生了： 

/ loop listening for signals being emmitted
while (true) {// non blocking read of the next available messagedbus_connection_read_write(conn, 0);msg = dbus_connection_pop_message(conn);// loop again if we haven't read a messageif (NULL == msg) {sleep(1);continue;}// check if the message is a signal from the correct interface and with the correct nameif (dbus_message_is_signal(msg, "test.signal.Type", "Test")) {// read the parametersif (!dbus_message_iter_init(msg, &args))fprintf(stderr, "Message has no arguments!\n");else if (DBUS_TYPE_STRING != dbus_message_iter_get_arg_type(&args))fprintf(stderr, "Argument is not string!\n");else {dbus_message_iter_get_basic(&args, &sigvalue);printf("Got Signal with value %s\n", sigvalue);}}// free the messagedbus_message_unref(msg);
}

五、提供被远程调用的方法（Exposing a Method to be called）
在第二节中，我们看到了调用一个远程方法，这节就是告诉我们怎么样提供一个方法让别的应用程序调用。用下面的程序，就可以把方法关联在那些提供给外部的方法上，并解析出相应的参数，最后构建一个消息返回给调用方法的应用程序。

提供被远程调用的方法1：

// loop, testing for new messages
while (true) {// non blocking read of the next available messagedbus_connection_read_write(conn, 0);msg = dbus_connection_pop_message(conn);// loop again if we haven't got a messageif (NULL == msg) {sleep(1);continue;}// check this is a method call for the right interface and methodif (dbus_message_is_method_call(msg, "test.method.Type", "Method"))reply_to_method_call(msg, conn);// free the messagedbus_message_unref(msg);
}
提供被远程调用的方法2： 
void reply_to_method_call(DBusMessage* msg, DBusConnection* conn)
{DBusMessage* reply;DBusMessageIter args;DBusConnection* conn;bool stat = true;dbus_uint32_t level = 21614;dbus_uint32_t serial = 0;char* param = "";// read the argumentsif (!dbus_message_iter_init(msg, &args))fprintf(stderr, "Message has no arguments!\n");else if (DBUS_TYPE_STRING != dbus_message_iter_get_arg_type(&args))fprintf(stderr, "Argument is not string!\n");elsedbus_message_iter_get_basic(&args, ¶m);printf("Method called with %s\n", param);// create a reply from the messagereply = dbus_message_new_method_return(msg);// add the arguments to the replydbus_message_iter_init_append(reply, &args);if (!dbus_message_iter_append_basic(&args, DBUS_TYPE_BOOLEAN, &stat)) {fprintf(stderr, "Out Of Memory!\n");exit(1);}if (!dbus_message_iter_append_basic(&args, DBUS_TYPE_UINT32, &level)) {fprintf(stderr, "Out Of Memory!\n");exit(1);}// send the reply && flush the connectionif (!dbus_connection_send(conn, reply, &serial)) {fprintf(stderr, "Out Of Memory!\n");exit(1);}dbus_connection_flush(conn);// free the replydbus_message_unref(reply);
}

这就基本上全部了。但用这些来理解 DBus 显然还远远不够。接下来，就要对这些程序以及背后的理念进行具体的探究了。

转载自：http://www.cnblogs.com/liyiwen/archive/2012/12/02/2798876.html

参考资料：

  1. http://dbus.freedesktop.org/doc/dbus-specification.html  这当然是最权威最重要的资料，但我觉得不是一个很好的入门资料。
  2. http://dbus.freedesktop.org/doc/dbus-tutorial.html 这里面有一些不错的例子，对Names 的解释也很好，但用的是 glib 的 binding，不能探究更底层的动作一度还是让我云里雾里。
  3. http://dbus.freedesktop.org/doc/api/html/group__DBusMessage.html  DBus 的 C 编程接口的在线文档，非常棒也非常有用

这篇关于dbus的入门于应用--dbus的C编程接口的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/404284。

相关文章

详解Java如何向http/https接口发出请求

详解Java如何向http/https接口发出请求

《详解Java如何向http/https接口发出请求》这篇文章主要为大家详细介绍了Java如何实现向http/https接口发出请求,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 用Java发送web请求所用到的包都在java.net下，在具体使用时可以用如下代码，你可以把它封装成一
阅读更多...
Java后端接口中提取请求头中的Cookie和Token的方法

Java后端接口中提取请求头中的Cookie和Token的方法

《Java后端接口中提取请求头中的Cookie和Token的方法》在现代Web开发中,HTTP请求头（Header）是客户端与服务器之间传递信息的重要方式之一,本文将详细介绍如何在Java后端（以Sp... 目录引言1. 背景1.1 什么是 HTTP 请求头？1.2 为什么需要提取请求头？2. 使用 Spr
阅读更多...
将Python应用部署到生产环境的小技巧分享

将Python应用部署到生产环境的小技巧分享

《将Python应用部署到生产环境的小技巧分享》文章主要讲述了在将Python应用程序部署到生产环境之前,需要进行的准备工作和最佳实践,包括心态调整、代码审查、测试覆盖率提升、配置文件优化、日志记录完... 目录部署前夜：从开发到生产的心理准备与检查清单环境搭建：打造稳固的应用运行平台自动化流水线：让部署像
阅读更多...
Linux中Curl参数详解实践应用

Linux中Curl参数详解实践应用

《Linux中Curl参数详解实践应用》在现代网络开发和运维工作中,curl命令是一个不可或缺的工具,它是一个利用URL语法在命令行下工作的文件传输工具,支持多种协议,如HTTP、HTTPS、FTP等... 目录引言一、基础请求参数1. -X 或 --request2. -d 或 --data3. -H 或
阅读更多...
在Ubuntu上部署SpringBoot应用的操作步骤

在Ubuntu上部署SpringBoot应用的操作步骤

《在Ubuntu上部署SpringBoot应用的操作步骤》随着云计算和容器化技术的普及,Linux服务器已成为部署Web应用程序的主流平台之一,Java作为一种跨平台的编程语言,具有广泛的应用场景,本... 目录一、部署准备二、安装 Java 环境1. 安装 JDK2. 验证 Java 安装三、安装 mys
阅读更多...
Python中构建终端应用界面利器Blessed模块的使用

Python中构建终端应用界面利器Blessed模块的使用

《Python中构建终端应用界面利器Blessed模块的使用》Blessed库作为一个轻量级且功能强大的解决方案,开始在开发者中赢得口碑,今天,我们就一起来探索一下它是如何让终端UI开发变得轻松而高... 目录一、安装与配置：简单、快速、无障碍二、基本功能：从彩色文本到动态交互1. 显示基本内容2. 创建链
阅读更多...
Node.js 中 http 模块的深度剖析与实战应用小结

Node.js 中 http 模块的深度剖析与实战应用小结

《Node.js中http模块的深度剖析与实战应用小结》本文详细介绍了Node.js中的http模块,从创建HTTP服务器、处理请求与响应,到获取请求参数,每个环节都通过代码示例进行解析,旨在帮... 目录Node.js 中 http 模块的深度剖析与实战应用一、引言二、创建 HTTP 服务器：基石搭建（一
阅读更多...
java中VO PO DTO POJO BO DO对象的应用场景及使用方式

java中VO PO DTO POJO BO DO对象的应用场景及使用方式

《java中VOPODTOPOJOBODO对象的应用场景及使用方式》文章介绍了Java开发中常用的几种对象类型及其应用场景,包括VO、PO、DTO、POJO、BO和DO等,并通过示例说明了它... 目录Java中VO PO DTO POJO BO DO对象的应用VO (View Object) - 视图对象
阅读更多...
Go信号处理如何优雅地关闭你的应用

Go信号处理如何优雅地关闭你的应用

《Go信号处理如何优雅地关闭你的应用》Go中的优雅关闭机制使得在应用程序接收到终止信号时,能够进行平滑的资源清理,通过使用context来管理goroutine的生命周期,结合signal... 目录1. 什么是信号处理？2. 如何优雅地关闭 Go 应用？3. 代码实现3.1 基本的信号捕获和优雅关闭3.2
阅读更多...
正则表达式高级应用与性能优化记录

正则表达式高级应用与性能优化记录

《正则表达式高级应用与性能优化记录》本文介绍了正则表达式的高级应用和性能优化技巧,包括文本拆分、合并、XML/HTML解析、数据分析、以及性能优化方法,通过这些技巧,可以更高效地利用正则表达式进行复杂... 目录第6章：正则表达式的高级应用6.1 模式匹配与文本处理6.1.1 文本拆分6.1.2 文本合并6
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2