Qt D-Bus的数据类型系统

前言：

众所周知，在高级语言编程中绕不开的就是数据结构和数据类型，D-Bus就具有一个可扩展的类型系统，它是基于数组和基本数据类型的组合。可以通过QDBusArgument类实现自定义数据结构的的接口，它允许用户通过总线发送和接收几乎所有的C++数据类型。且Qt D-Bus对C++的基本数据类型进行了底层封装，不需要自己实现基本数据类型的接口。本文根据Qt帮助文档翻译损益而成，具体细节可查看Qt帮助文档。

Qt与D-Bus基本数据类型对应表如下：

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本身还支持两种非基本类型，因为它们在Qt应用程序中广泛使用:QStringList和QByteArray

复合类型：

D-Bus指定了三种基本类型的聚合，允许创建复合类型。它们是数组、结构体和映射/字典。

数组是由相同类型的0个或多个元素组成的集合，而结构是由固定数量的元素组成的集合，每种元素都属于任何类型。映射或字典被实现为一对元素的数组，因此在一个映射中可以有零个或多个元素。

扩展类型系统：

Qt允许用户使用自定义数据结构，为此，Qt D-Bus提供了自动类型的扩展功能，要使用自己的Qt D-Bus类型，必须使用Q_DECLARE_METATYPE()宏声明该类型为Qt元类型，并使用qDBusRegisterMetaType()函数注册。流操作符>>和操作符<<将被注册系统自动找到。Qt D-Bus为数组和映射提供专门化模板，以便与Qt的容器类(如QMap和QList)一起使用，因此没有必要为它们编写流操作符函数。对于其他类型，特别是实现结构体的类型，必须显式地实现操作符。

例：

struct MyStructure
{
    int count;
    QString name;
};
Q_DECLARE_METATYPE(MyStructure)

// 将MyStructure 数据编码到 D-Bus argument中
QDBusArgument &operator<<(QDBusArgument &argument, const MyStructure &mystruct)
{
    argument.beginStructure();
    argument << mystruct.count << mystruct.name;
    argument.endStructure();
    return argument;
}

// 从D-Bus argumentj解码数据到MyStructure data 中
const QDBusArgument &operator>>(const QDBusArgument &argument, MyStructure &mystruct)
{
    argument.beginStructure();
    argument >> mystruct.count >> mystruct.name;
    argument.endStructure();
    return argument;
}
           

注：通常的在使用自定义数据时,需要使用qDBusRegisterMetaType()注册，例：qDBusRegisterMetaType<MyStructure>();

一旦注册，该类型就可以用于传出方法调用(放置在QDBusAbstractInterface::call()中)、接收来自注册对象的信号发射或来自远程应用程序的传入调用中。需要注意的是，操作符<<和操作符>>流函数必须始终生成相同数量的条目，以防出现读写结构(编组和demarshalling)，否则调用和信号可能开始无声地失败。

注：Qt D-Bus为常见容器提供了通用模板来完成数据的编组工作，您不需要为它声明一个操作符<< function，如：QList、QVector、QMap或QHash，STL的序列容器也是如此，例如std::list、std::vector等。

虽然，所有Qt D-Bus类型(基本类型和用户定义的类似)都可以用于通过总线发送和接收所有类型的消息。但是不能使用上面列表之外的任何类型，包括列出的类型的typedefs。这还包括QList<QVariant>和QMap<QString,QVariant>。

PS：Qt帮助文档是最好的教材