基本概念 下(C API 級別的使用觀點)
通信數(shù)據(jù)的設(shè)置和獲取
前篇主要是有講一些相對高層的概念,比如 object,interface,method 之類的,對于這些“C 本來沒有的東西”,如何在 DBus 中表現(xiàn)的確實很讓我迷惑了一陣。但通信數(shù)據(jù)的發(fā)送可能比前面那些名稱好理解得多。因為這些概念都是很本來就是底層的,很 C 的。
DBus 提供了一個 DBusMessageIter 的類型,使用這個類型的變量,我們就可以向 DBusMessage 中很容易地加入數(shù)據(jù),也可以很容易地從中取出數(shù)據(jù)。
DBusMessage* msg;DBusMessageIter args;?// msg...?dbus_message_iter_init_append(msg, &args);dbus_uint32_t my_data = 10;if(!dbus_message_iter_append_basic(&args, DBUS_TYPE_UINT32, &my_data)) {????printf("Out of memoryn");????return?RES_FAILED;}?dbus_connection_flush(conn);dbus_message_unref(msg);
第 2 行的代碼聲明了一個 DBusMessageIter 的對象 args,第 6 行的代碼處,對 args 進(jìn)行初始化,這可以讓一個 DBusMessageIter 對象與對應(yīng)的 DBusMessage 關(guān)聯(lián)起來,后面再對 DBusMessageIter的時候(設(shè)置或者取得數(shù)據(jù)),就是對相應(yīng)的 DBusMessage 進(jìn)行處理。然后使用第8行的函數(shù),將一個 uint32 的數(shù)據(jù) my_data 追加到 msg 中了。如果還要追加新的參數(shù)的話,只需要繼續(xù)調(diào)用該函數(shù),并傳入適當(dāng)?shù)膮?shù)就可以了。
dbus_bool_t dbus_message_iter_append_basic(DBusMessageIter * iter,??????????????????????????????????????????????????????????inttype,???????????????????????????????????????????const?void?*??????value???????????????????????????????????????????)
這個函數(shù)可以用來向 DBusMessageIter 中追加一些“基本類型”(basic)的數(shù)據(jù),所謂基本類型的數(shù)據(jù),在 DBus 中是這么定義的:
Conventional Name
Encoding
Alignment
BYTE
A single 8-bit byte.
1
BOOLEAN
As for?UINT32
, but only 0 and 1 are valid values.
4
INT16
16-bit signed integer in the message's byte order.
2
UINT16
16-bit unsigned integer in the message's byte order.
2
INT32
32-bit signed integer in the message's byte order.
4
UINT32
32-bit unsigned integer in the message's byte order.
4
INT64
64-bit signed integer in the message's byte order.
8
UINT64
64-bit unsigned integer in the message's byte order.
8
DOUBLE
64-bit IEEE 754 double in the message's byte order.
8
STRING
A?UINT32
?indicating the string's length in bytes excluding its terminating nul, followed by non-nul string data
of the given length, followed by a terminating nul byte.
4
(for the length)
OBJECT_PATH
Exactly the same as?STRING
?except the content must be a valid object path (see below).
4
(for the length)
(參考 DBus 的在線 API 的 Marshaling (Wire Format) 一節(jié))
有 basic type,當(dāng)然也就有更復(fù)雜的不是 basic 的類型,但這和基本概念的關(guān)系不大,在這篇文章中就不多介紹了。(請參考我其它的 DBus 博文)
到現(xiàn)在為止,我已經(jīng)知道如何把數(shù)據(jù)入到一個 DBusMessage 中了,那么,如何從一個 DBusMessage 中取出數(shù)據(jù)呢?比如,我在 A 進(jìn)程使用上面的代碼把 my_data 加到 DBusMessage 中了,現(xiàn)在 B 進(jìn)程取到了 DBusMessage,如何把數(shù)據(jù)取出來呢?
DBusMessage* msg;DBusMessageIter args;?// get a DBusMessage from process A?if(!dbus_message_iter_init(msg, &args)) {????printf("dbus_message_iter_init error, msg has no arguments!n");}else?if?(DBUS_TYPE_UINT32 != dbus_message_iter_get_arg_type(&args)){????printf("not a uint 32 type !n");}else?{????dbus_uint32_t my_age = 0;????dbus_message_iter_get_basic(&args, &my_age);????printf("Got signal with value %dn", my_age);}
很簡單,一樣的先使用 dbus_messge_iter_init 先把 DBusMessage 對象和從 DBus 總線中取到的 msg 關(guān)聯(lián)起來。這樣,使用第 9 行的函數(shù)先取得第一個通信數(shù)據(jù)中第一個參數(shù)的類型,如果類型無誤的話可以進(jìn)而使用第 14 行的函數(shù)取得參數(shù)值本身。
這樣,一個簡單的數(shù)據(jù)如何入到 DBusMessage 中,又如何從 DBusMessage 中取出來就明白了。那么如何將 DBusMessage 在進(jìn)程之間傳遞呢?
消息的發(fā)送和獲取
消息的發(fā)送其實比較簡單,當(dāng)進(jìn)程 A 準(zhǔn)備申請好一個 DBusMessage對象,設(shè)置好它的“類型”(就是各種名字),放好需要通信的數(shù)據(jù),之后,使用下面的代碼就可以將數(shù)據(jù)發(fā)送到總線上:
dbus_uint32_t serial = 0;?if(!dbus_connection_send(conn, msg, &serial)) {????printf("Out of memory");????return?RES_FAILED;}dbus_connection_flush(conn);
這很簡單,只是 dbus_connection_flush 這個函數(shù)有點突兀,它的作用是“Blocks until the outgoing message queue is empty.”,可以簡單地理解為調(diào)用這個函數(shù)可以使用得發(fā)送進(jìn)程一直等消息發(fā)送完了才能繼續(xù)運行。
接受方的代碼也很簡單:
dbus_connection_read_write(conn, 0);msg = dbus_connection_pop_message(conn);?if(NULL == msg) {????sleep(1);????continue;}
使用 1 和 2 行的代碼就可以取出發(fā)送到本進(jìn)程的消息,之后就可以使用 msg (如果 msg 不是 NULL 的話)來獲取通信數(shù)據(jù)了。
?
到這里,基本概念就有了。后面,應(yīng)該對 DBus 的細(xì)節(jié)再深入的探索。
?
Sample 代碼:
發(fā)送方進(jìn)程(my_client):
My_Client.cpp #include?