Qt D-Bus 类型系统

时间:2022-12-20 15:47:47

       D-Bus具有可扩展的类型系统,基于基本类型和基本类型的数组和结构体这样的组合类型。Qt D-Bus通过QDBusArgument类实现与类型系统的接口,允许用户程序在D-Bus总线上收发几乎所有的C++类型。

基本类型

       基本类型由QDBusArgument原生支持,不需要特别定制就可以收发。他们与相关的C++类型共同列于下表:

Qt 类型 D-Bus 等价类型
uchar BYTE
bool BOOLEAN
short INT16
ushort UINT16
int INT32
uint UINT32
qlonglong INT64
qulonglong UINT64
double DOUBLE
QString STRING
QDBusVariant VARIANT
QDBusObjectPath OBJECT_PATH
QDBusSignature SIGNATURE
       除了基本类型,QDBusArgument也原生支持两个非基本类型:QStringListQByteArray,因为他们广泛用于Qt应用程序。

复合类型

       D-Bus指定了三种基本类型的组合类型以支持增加复合类型。他们是数组(ARRAY),结构体(STRUCT) 和映射/字典 (maps/dictionaries)。

       数组是0个或多个相同类型元素的集合,而结构体是固定数目元素的集合,每个元素可以是任何类型。映射或字典实现为一对元素(键-值对)的数组,因此,在一个映射中可以有0个或多个元素。

类型系统扩展

       为了在Qt D-Bus上使用自定义类型,必须使用Q_DECLARE_METATYPE()宏将类型声明为Qt元类型并且使用qDBusRegisterMetaType()函数注册。流运算符operator>>operator<<会自动在注册系统中找到。

    使用Qt容器类,如QMapQList,Qt D-Bus会专门提供数组和映射的模板,因此,没必要为它们编写流运算符函数。对于其它类型,和特别为类型实现的结构,那么运算符必须显示实现。

       有关数组,结构体和映射的例子详见关于QDBusArgument的文档。

类型系统使用

       所有Qt D-Bus类型(基本类型和自定义类型类似)可用于总线上所有类型消息的收发。

       警告:你可能没有使用上述的任何类型,包括所列类型的typedefs。这也包括QList<QVariant> 和QMap<QString,QVariant>。

          英文原文地址: http://doc.qt.io/qt-5/qdbustypesystem.html