简介
dbus 介绍： 维基百科
glibmm: glibmm 是 glib 库的 C++ 封装。它的一个子项目 giomm 实现了 dbus 协议。通过 giomm 我们可以实现 dbus 服务，也可以实现一个 dbus 客户端。
glibmm dbus 服务端
Gio::DBus::own_name
实现服务端的一个入口 API 是： Gio::DBus::own_name ，它的原型如下：
1
2
3
4
5
6
7
| guint Gio::DBus::own_name(BusType bus_type,
const Glib::ustring& name,
const SlotBusAcquired& bus_acquired_slot = SlotBusAcquired(),
const SlotNameAcquired& name_acquired_slot = SlotNameAcquired(),
const SlotNameLost& name_lost_slot = SlotNameLost(),
BusNameOwnerFlags flags = Gio::DBus::BUS_NAME_OWNER_FLAGS_NONE
)
|
own_name 在指定的 bus_type 请求 一个 name, 当 name 被 acquire 时，name_acquired_slot 被调用，当 name lost 时，name_lost_slot 被调用。如果不再使用这个 name, 调用 unown_name 。
对于同一个 name, 在调用 unown_name 之前不要多次调用 own_name ，只有第一次调用有效。
我们必须在 bus_acquired_slot 中注册 dbus 对象。
Gio::DBus::Connection::register_object
注册一个 dbus 对象，必须在 own_name 的 bus_acquired_slot 中调用，它的原型如下：
1
2
3
4
5
6
|
guint Gio::DBus::Connection::register_object(
const Glib::ustring& object_path,
const Glib::RefPtr< InterfaceInfo >& interface_info,
const InterfaceVTable& vtable
)
|
object_path 是对象路径interface_info 是接口信息，有 xml 文件声明；vtable 是用于处理 D-Bus 接口的属性和方法调用的虚拟表。
Gio::DBus::InterfaceInfo
存储 dbus 接口信息，一般从 xml 文件获取
Gio::DBus::InterfaceVTable
InterfaceVTable 的实例必须是全局的，即它的生命周期和程序的生命周期一样长。其它的任何使用方法都有可能导致内存泄漏，如声明一个局部的对象。
构造函数：
1
2
3
4
| Gio::DBus::InterfaceVTable::InterfaceVTable(const SlotInterfaceMethodCall& slot_method_call,
const SlotInterfaceGetProperty& slot_get_property = SlotInterfaceGetProperty(),
const SlotInterfaceSetProperty& slot_set_property = SlotInterfaceSetProperty()
)
|
slot_method_call ： 当方法被调用时。slot_get_property ：当获取属性时。slot-set_property ：当设置属性时。
例子
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
| #include <giomm.h>
#include <glibmm.h>
// 接口声明的 xml 文件
static const char interfaceXml0[] = R"XML_DELIMITER(<?xml version="1.0" encoding="UTF-8" ?>
<node name="/org/foo/Bar">
<interface name="org.foo.Bar">
<method name="Baz">
<arg name="state" type="u" direction="out"/>
</method>
</interface>
</node>
)XML_DELIMITER";
// 方法调用
void OnInterfaceMethodCall(
const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& sender, const Glib::ustring& object_path,
const Glib::ustring& interface_name, const Glib::ustring& method_name,
const Glib::VariantContainerBase& parameters,
const Glib::RefPtr<Gio::DBus::MethodInvocation>& invocation) {
// 调用 Baz 方法
if (method_name.compare("Baz") == 0) {
// 方法的实现
std::vector<Glib::VariantBase> vlist;
auto var0 = Glib::Variant<guint32>::create(30);
vlist.push_back(var0);
// 返回一个 30
invocation->return_value(
Glib::Variant<Glib::VariantBase>::create_tuple(vlist));
}
}
// 设置属性
bool OnInterfaceSetProperty(
const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& sender, const Glib::ustring& object_path,
const Glib::ustring& interface_name, const Glib::ustring& property_name,
const Glib::VariantBase& value) {
return true;
}
// 获取属性
void OnInterfaceGetProperty(
Glib::VariantBase& property,
const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& sender, const Glib::ustring& object_path,
const Glib::ustring& interface_name,
const Glib::ustring& property_name) {}
int main(int argc, char** argv) {
// 初始化 giomm 和 glibmm, 不需要再调用 Glib::init()
Gio::init();
// 创建一个事件循环
Glib::RefPtr<Glib::MainLoop> ml = Glib::MainLoop::create();
Glib::RefPtr<Gio::DBus::NodeInfo> introspection_data;
guint registered_object_id = 0;
// 请求 name ”org.foo.Bar"
guint connection_id = Gio::DBus::own_name(
Gio::DBus::BUS_TYPE_SESSION, "org.foo.Bar",
[&](const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& /* name */) {
// 在这里注册对象
try {
// 根据 xml 获取 dbus 接口数据
introspection_data =
Gio::DBus::NodeInfo::create_for_xml(interfaceXml0);
} catch (const Glib::Error& ex) {
g_warning("Unable to create introspection data for %s",
ex.what().c_str());
ml->quit();
}
// 定义虚拟的表
// 由于必须要定义全局的实例，可以只 new, 不 delete ，程序结束后会释放内存
Gio::DBus::InterfaceVTable* interface_vtable =
new Gio::DBus::InterfaceVTable(
sigc::ptr_fun(&OnInterfaceMethodCall),
sigc::ptr_fun(&OnInterfaceGetProperty),
sigc::ptr_fun(&OnInterfaceSetProperty));
try {
// 注册对象
registered_object_id = connection->register_object(
"/org/foo/Bar",
introspection_data->lookup_interface("org.foo.Bar"),
*interface_vtable);
} catch (const Glib::Error& ex) {
g_warning("Unable to create introspection data for %s",
ex.what().c_str());
ml->quit();
}
},
[&](const Glib::RefPtr<Gio::DBus::Connection>& /* connection */,
const Glib::ustring& /* name */) {
g_print("Name acquired.\n");
},
[&](const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& /* name */) {
g_print("Name lost.\n");
// 取消注册
connection->unregister_object(registered_object_id);
ml->quit();
});
// 跑起事件循环
ml->run();
// 不再使用
Gio::DBus::unown_name(connection_id);
return 0;
}
|
glibmm dbus 客户端
调用 dbus 方法可以 用 Gio::DBus::Proxy ，用这个类很简单，这里直接给个带注释的例子。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
| #include <giomm.h>
#include <glibmm.h>
Glib::RefPtr<Gio::DBus::Proxy> proxy;
void OnBazFinished(const Glib::RefPtr<Gio::AsyncResult>& result) {
// 调用完成，从 result 中返回值
auto wrapped = proxy->call_finish(result);
Glib::Variant<guint32> v;
wrapped.get_child(v, 0);
g_print("result: %d\n", v.get());
}
// Proxy 创建成功
void ProxyCreated(const Glib::RefPtr<Gio::AsyncResult> result) {
g_print("Proxy created\n");
// 获取 proxy
proxy = Gio::DBus::Proxy::create_for_bus_finish(result);
// 调用 Baz 方法
// 异步调用，返回时回调 OnBazFinished
proxy->call("Baz", sigc::ptr_fun(OnBazFinished));
}
int main() {
// 初始化 gio 和 glib
Gio::init();
// 创建一个 dbus proxy, 创建成功后回调 ProxyCreated
Gio::DBus::Proxy::create_for_bus(Gio::DBus::BUS_TYPE_SESSION,
"org.foo.Bar",
"/org/foo/Bar",
"org.foo.Bar",
sigc::ptr_fun(&ProxyCreated));
Glib::RefPtr<Glib::MainLoop> ml = Glib::MainLoop::create();
ml->run();
return 0;
}
|
代码生成工具 gdbus-codegen-glibmm3
我们每写一个 dbus 服务，都要写很多的重复代码，gdbus-codegen-glibmm3 可以从 xml 中生成一些代码，我们只需要继承类并实现业务方法就可以写出 dbus 服务。
生成代码
首先写一个 xml 文件声明 dbus 接口
1
2
3
4
5
6
7
8
| <?xml version="1.0" encoding="UTF-8" ?>
<node name="/org/foo/Bar">
<interface name="org.foo.Bar">
<method name="Baz">
<arg name="state" type="u" direction="out"/>
</method>
</interface>
</node>
|
用 gdbus-codegen-glibmm3 生成代码。
1
| gdbus-codegen-glibmm3 --generate-cpp-code=gen/bar bar.xml
|
它会生成下面的几个文件：
bar_common.cpp bar_common.h
bar_proxy.cpp bar_proxy.h
bar_stub.cpp bar_stub.h
stub 结尾的是写服务端需要。
proxy 结尾的是写客户端需要。
common 结尾的是服务端和客户端都需要。
根据生成的代码写服务端
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
| #include "gen/bar_stub.h"
// 继承桩代码，实现 Bar 方法
class BarImpl : public org::foo::BarStub {
public:
void Baz(MethodInvocation& invocation) override {
// 返回 30
invocation.ret(30);
}
};
int main() {
Gio::init();
Glib::RefPtr<Glib::MainLoop> ml = Glib::MainLoop::create();
// 定义对象
BarImpl bi;
guint connection_id = Gio::DBus::own_name(
Gio::DBus::BUS_TYPE_SESSION, "org.foo.Bar",
[&](const Glib::RefPtr<Gio::DBus::Connection>& connection,
const Glib::ustring& /* name */) {
g_print("Connected to bus.\n");
// 注册对象
if (bi.register_object(connection, "/org/foo/Bar") == 0)
ml->quit();
},
[&](const Glib::RefPtr<Gio::DBus::Connection>& /* connection */,
const Glib::ustring& /* name */) {
g_print("Name acquired.\n");
},
[&](const Glib::RefPtr<Gio::DBus::Connection>& /* connection */,
const Glib::ustring& /* name */) {
g_print("Name lost.\n");
ml->quit();
});
ml->run();
Gio::DBus::unown_name(connection_id);
return 0;
}
|
用生成的代码写客户端
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
| #include "gen/bar_proxy.h"
Glib::RefPtr<org::foo::BarProxy> proxy;
void OnBazFinished(const Glib::RefPtr<Gio::AsyncResult> &result) {
guint32 value;
proxy->Baz_finish(value, result);
g_print("value: %d\n", value);
}
void ProxyCreated(const Glib::RefPtr<Gio::AsyncResult> result) {
proxy = org::foo::BarProxy::createForBusFinish(result);
proxy->Baz(sigc::ptr_fun(&OnBazFinished));
}
int main(int argc, char **argv) {
Gio::init();
org::foo::BarProxy::createForBus(Gio::DBus::BUS_TYPE_SESSION,
Gio::DBus::PROXY_FLAGS_NONE,
"org.foo.Bar",
"/org/foo/Bar",
sigc::ptr_fun(&ProxyCreated));
Glib::RefPtr<Glib::MainLoop> ml = Glib::MainLoop::create();
ml->run();
return 0;
}
|