Qt小技巧12.QObject子类D指针的使用

1 前言

D指针可以隐藏类的实现细节，对于需要发布库文件的项目来说屏蔽实现细节尤为重要，具体有哪些优点自行查阅下吧，文章太多了，不再重复了，下面介绍下如何使用Qt的方式将D指针应用于自定义类中。

2 举个例子

按照Qt的惯用方法，例如有个自定义的QObject子类叫MyObject（文件myobject.h），需要定义一个辅助类MyObjectPrivate（文件myobject_p.h），实现细节封装。

2.1 myobject.h

#ifndef MYOBJECT_H
#define MYOBJECT_H

#include <QObject>

class MyObjectPrivate;
class MyObject : public QObject
{
    Q_OBJECT
public:
    explicit MyObject(QObject *parent = 0);

    void showName();
    int getNum() {return 20;}

private:
    Q_DECLARE_PRIVATE(MyObject)
};

#endif // MYOBJECT_H

前置声明下MyObjectPrivate类型，同时使用Q_DECLARE_PRIVATE(MyObject)声明下。

2.2 myobject_p.h

#ifndef MYOBJECTPRIVATE_H
#define MYOBJECTPRIVATE_H

#include "private/qobject_p.h"

class MyObjectPrivate : public QObjectPrivate
{
    Q_DECLARE_PUBLIC(MyObject)

public:
    MyObjectPrivate(int version = QObjectPrivateVersion);
    virtual ~MyObjectPrivate();

    int num();

    QString name{"Qt Xiao Luo"};
};

#endif // MYOBJECTPRIVATE_H

辅助类MyObjectPrivate的定义，使用Q_DECLARE_PUBLIC(MyObject)声明下，由于使用了QObjectPrivate作为基类，需要在工程文件中QT += gui-private引入下。

2.3 myobject.cpp

#include "myobject.h"
#include "myobject_p.h"

#include <QDebug>

MyObject::MyObject(QObject *parent) : QObject(*(new MyObjectPrivate), parent)
{
}

void MyObject::showName()
{
    Q_D(MyObject);
    qDebug() << d->name << d->num();
}

MyObjectPrivate::MyObjectPrivate(int version) : QObjectPrivate(version)
{
}

MyObjectPrivate::~MyObjectPrivate()
{
}

int MyObjectPrivate::num()
{
    Q_Q(MyObject);
    return q->getNum();
}

构造函数主要使用了QObject受保护的构造函数进行的初始化：

然后就可以通过Q_D、Q_Q使用D指针和Q指针啦，具体的原理需要大家自己查看Qt源码了。

3 建议

如果是要发布动态库，要对外提供接口，这种方式就很合适了，Qt就是；如果只是普通软件，不需要对外暴露接口，就没必要了。