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 |
复合类型
D-Bus指定了三种基本类型的组合类型以支持增加复合类型。他们是数组(ARRAY
),结构体(STRUCT)
和映射/字典 (maps/dictionaries)。
数组是0个或多个相同类型元素的集合,而结构体是固定数目元素的集合,每个元素可以是任何类型。映射或字典实现为一对元素(键-值对)的数组,因此,在一个映射中可以有0个或多个元素。
类型系统扩展
为了在Qt D-Bus上使用自定义类型,必须使用Q_DECLARE_METATYPE()宏将类型声明为Qt元类型并且使用qDBusRegisterMetaType()函数注册。流运算符operator>>
和 operator<<会自动在注册系统中找到。
使用Qt容器类,如QMap 和QList,Qt D-Bus会专门提供数组和映射的模板,因此,没必要为它们编写流运算符函数。对于其它类型,和特别为类型实现的结构,那么运算符必须显示实现。
有关数组,结构体和映射的例子详见关于QDBusArgument的文档。
类型系统使用
所有Qt D-Bus类型(基本类型和自定义类型类似)可用于总线上所有类型消息的收发。
警告:你可能没有使用上述的任何类型,包括所列类型的typedefs。这也包括QList<QVariant> 和QMap<QString,QVariant>。
英文原文地址: http://doc.qt.io/qt-5/qdbustypesystem.html