QDBus与gdbus的数据传递详解

    xiaoxiao2026-08-26  0

    QDBus与gdbus的数据传递详解

    感谢大神分享,原文链接:http://blog.csdn.net/kentonwu/article/details/47281101

    在Linux平台的进程间通信多了一个dbus技术,应用还是非常广的,其中有一个应用模式是采用gdbus实现相关业务逻辑,采用QtService调用qdbus暴露出服务给客户使用。这种模式还是非常便捷的。不过QDBus和gdbus相关资料还请自行查找。这里只是针对他们的数据传递(函数的参数)进行详解。

    1,框架的建立

    首先我们需要根据业务需要建议一个xml文件hello.xml,描述interface以及包含的函数等信息,比如:

    [html]  view plain  copy <?xml version="1.0" encoding="UTF-8"?>   <?xml-stylesheet type="text/xsl" href="introspect.xsl"?>   <node xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" name="/org/alibaba/kenton" xsi:noNamespaceSchemaLocation="introspect.xsd">     <interface name="org.alibaba.kenton.hello">       <version>1.0.0</version>       <doc>         <line>This is a test interface</line>       </doc>       <method name="GetVersion">         <doc>           <line>GetVersion = This method returns the API version implemented by the server application</line>         </doc>         <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="SVersion"/>         <arg name="version" type="(qqqs)" direction="out">           <doc>             <line>version = struct(major,minor,micro,date)</line>             <line>major = major</line>             <line>minor = minor</line>             <line>micro = micro</line>             <line>date = release date</line>           </doc>         </arg>       </method>     </interface>   </node>  

    a,QDBus端

    这里,我们只是随便弄个interface以及一个函数名为GetVersion。有这个XML我们就可以利用工具qdbusxml2cpp创建对应的cpp文件。

    [plain]  view plain  copy qdbusxml2cpp hello.xml -i hello_type.h HelloInterface  

    这条命令用于创建qdbus对应的接口,HelloInterface.cpp/.h,供QtService接口调用。其中-i hello_type.h表明创建出来的HelloInterface.h需要include hello_type.h。不过当前目前是不需要这个头文件的。只需要在实际项目目录底下有这个文件即可。那问题来了,我们要这个文件干嘛?因为在xml文件,我们GetVersion的参数是个结构体,对于这种复杂类型(包括结构体,类,QList,QMap等)我们需要在一个头文件里定义。同时还需要实现相应的流操作符,这里只列出头文件的内容:

    [cpp]  view plain  copy struct SVersion   {      quint16 mMajor;      quint16 mMinor;      quint16 mMicro;      QString mDate;            SVersion() : mMajor(0), mMinor(0), mMicro(0), mDate("")     {     }     bool operator==(const SVersion &other) const     {        return (mMajor == other.mMajor) && (mMinor == other.mMinor) && (mMicro == other.mMicro) && (mDate == other.mDate);     }   };         QDBusArgument& operator<<(QDBusArgument& arg, const SVersion& version);   const QDBusArgument& operator>>(const QDBusArgument& arg, SVersion& version);  

    同时需要在使用HelloInterface之前注册为qDBus的元类型:qDBusRegisterMetaType<navigationcore::session::SVersion>();

    有了这些QDBus端,算是大功告成了。

    b,gdbus端

    同样,我们需要使用gdbusxml2cpp创建gdbus相关c文件,(这里不列出创建出来的文件了):

    [plain]  view plain  copy gdbus-codegen --generate-c-code gdbusHello hello.xml  

    之后,我们需要创建一个具体显示相关业务的c文件,其中内容有:

    [cpp]  view plain  copy void connectHelloInterface(OrgAlibabaKentonHello* helloServerObject,GDBusConnection *connection)   {       GError* err = NULL;             /*接口的连接*/       g_signal_connect(sessionServerObject, "handle_get_version", G_CALLBACK(&gdbus_get_version), NULL);             /*接口的输出*/       if(true != g_dbus_interface_skeleton_export(G_DBUS_INTERFACE_SKELETON(sessionServerObject), connection, PHELLOSERVER_KENTON_DBUS_OBJECT_PATH, &err))       {           LOG("export interface failed");       }       else       {           LOG("export interface success");       }   }   其中GetVersion对应的具体业务逻辑的实现如下:

    [cpp]  view plain  copy void gdbus_get_version (     OrgAlibabaKentonHello *object,     GDBusMethodInvocation *invocation)   {       LOG_DEBUG(CTX_ID_GUD, "#FI#: gdbus_get_version");          GVariant * version;       GVariantBuilder* builder = g_variant_builder_new(G_VARIANT_TYPE("(qqqs)"));       g_variant_builder_add(builder, "q", 1);       g_variant_builder_add(builder, "q", 1);       g_variant_builder_add(builder, "q", 0);       g_variant_builder_add(builder, "s""hello");       version = g_variant_builder_end(builder);          org_alibaba_kenton_hello_complete_get_version(object, invocation, version);   }   这里我们通过glib函数g_variant_builder_new创建一个和xml里参数类型一致的variant type:

    G_VARIANT_TYPE("(qqqs)") 然后添加相应的值。

    至此,大概的框架就都有了。让我们回到本问的核心,各种数据传递。

    2,数据传递详解

    a,glib数据类型,从glib官网https://developer.gnome.org/glib/stable/gvariant-format-strings.html

    b,基本数据类型

    在xml文件里指定glib对应的gvariant数据类型,具体查看上面的数据类型对应表。

    在QDBus端,qdbusxml2cpp已经创建出c/c++对应的数据类型,可直接使用。

    c,结构体

    在xml文件里,就是上面的例子。我们需要在xml里指定(qqqs),由一个括号包围相应数据类型

    <arg name="version" type="(qqqs)" direction="out">

    在QDbus端,我们需要有个头文件,头文件里声明一个对应数据类型的结构体,同时要实现对应的流操作运算符,参考上面的例子,这里不再说明。

    在gdbus端,我们需要把数据传回给QDBus端,如下:

    [cpp]  view plain  copy GVariant * version;   GVariantBuilder* builder = g_variant_builder_new(G_VARIANT_TYPE("(qqqs)"));   g_variant_builder_add(builder, "q", 1);   g_variant_builder_add(builder, "q", 1);   g_variant_builder_add(builder, "q", 0);   g_variant_builder_add(builder, "s""hello");   version = g_variant_builder_end(builder);      org_alibaba_kenton_hello_complete_get_version(object, invocation, version);   d,QList

    在xml文件里,QList对应到glib里是a(q),就是一个数组,其中数据类型可以是任意。

    在QDBus端,我们可以typedef QList<quint16> QShortList; 把ShortList放在xml文件函数参数的annotation中,如下:

    [html]  view plain  copy <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QShortList"/>   在glib端,对应的代码:

    [cpp]  view plain  copy GVariant * version;   GVariantBuilder* builder = g_variant_builder_new(G_VARIANT_TYPE("a(q)"));   g_variant_builder_add(builder, "q", 1);   g_variant_builder_add(builder, "q", 2);   g_variant_builder_add(builder, "q", 3);   version = g_variant_builder_end(builder);      org_alibaba_kenton_hello_complete_get_xxxx(object, invocation, version);  

    e,QMap

    在xml文件里,QList对应到glib里是a{qv},就是一个字典数组。

    在QDBus端,我们可以typedef QMap<quint16, QDBusVariant> QShortMap; 把ShortList放在xml文件函数参数的annotation中,如下:

    [html]  view plain  copy <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QShortMap"/>  

    [cpp]  view plain  copy <span style="white-space:pre">    </span>GVariant* map_item;           GVariantBuilder* builder = g_variant_builder_new(G_VARIANT_TYPE("a{qv}"));              g_variant_builder_add(builder, "{qv}", 1, g_variant_new_uint16(11));   <span style="white-space:pre">    </span>g_variant_builder_add(builder, "{qv}", 2, g_variant_new_uint16(22));              map_item = g_variant_builder_end(builder);           g_variant_builder_unref(builder);   f,QList<QMap<uint16, QDBusVariant> >

    QList和QMap我们都已经会那,那QList的元素是个QMap呢,其实也一样,variant type 是“aa{qv}",只是在添加数据的时候需要注意一下。

    这里就只是列出gdbus中的代码:

    [cpp]  view plain  copy GVariant* points_list;   GVariantBuilder* points_builder = g_variant_builder_new(G_VARIANT_TYPE("aa{qv}"));      for (int i = 0; i < nJnyPointNum; i++)   {       GVariant* points_item;       GVariantBuilder* builder = g_variant_builder_new(G_VARIANT_TYPE("a{qv}"));          g_variant_builder_add(builder, "{qv}", 1, g_variant_new_uint16(11));        g_variant_builder_add(builder, "{qv}", 2, g_variant_new_double(22.22));           points_item = g_variant_builder_end(builder);       g_variant_builder_unref(builder);       <span style="color:#ff0000;">g_variant_builder_add_value(points_builder, points_item);// 关键是这行,需要调用add_value来添加一个QMap</span>   }   points_list = g_variant_builder_end(way_points_builder);   g_variant_builder_unref(points_builder);  

    g,结构体

    对于结构体中只包含基本数据类型,可以批量添加,如下:

    [cpp]  view plain  copy g_variant_builder_add(pvBuilder, "(uiqnnb)",                                     u32Param,                                     n32Param,                                     u16Param,                                     n16Param,                                     bParam);   h,结构体中包含复杂数据类型,比如QMap,如下:

    对于结构体中包含复杂数据类型,则需先构造出复杂数据类型,然后再添加各个数据;同时通过

    [cpp]  view plain  copy g_variant_builder_add_value   [cpp]  view plain  copy 来添加复杂数据类型。  

    [cpp]  view plain  copy GVariant* pvMapItem = ...   GVariantBuilder* pvBuilder = g_variant_builder_new(G_VARIANT_TYPE("(uiqa{qv})"));               g_variant_builder_add(pvBuilder, "u", u32);               g_variant_builder_add(pvBuilder, "i", n32);               g_variant_builder_add(pvBuilder, "q", u16);               g_variant_builder_add_value(pvBuilder, pvMapItem);  

    有了支持以上数据类型,我想基本是够用了。这里没有想太详细介绍所有涉及的知识点,但是有了这些知识就有助于实际开发当中的用例。否则一开始用还是比较不方便的。

    转载请注明原文地址: https://ju.6miu.com/read-1311567.html
    最新回复(0)