插件问题回答第2题 另解

问题贴：[url]http://cloverprince.iteye.com/blog/481307[/url]

[quote]
2. 现有一个主程序用C++语言写成。现在要允许第三方开发人员编写扩展的类，约定第三方开发的类必须包含一个继承自某个已知类（如class FooPlugin）的子类，名称不限。如果要求第三方的类必须与主程序的二进制代码分开发布，把dll或so丢在某个文件夹内即可被动态装载使用，应如何实现？
[/quote]


回答：

除了直接使用操作系统提供的接口以外，还可以使用Qt提供的插件系统。我们需要一个纯虚类，并用Q_DECLARE_INTERFACE宏声明该接口。插件模块中，具体类继承该接口，并用Q_EXPORT_PLUGIN2输出该具体类。主程序中，用QPluginLoader装载该模块，用QPluginLoader::instance()获得实例，用qobject_cast<>()转换成接口类型。


适用范围：

Qt 4.x


实现：

接口定义：hellointerface.h

#ifndef HELLOINTERFACE_H
#define HELLOINTERFACE_H

#include <QtPlugin>

class HelloInterface
{
public:
    virtual ~HelloInterface() {}

    virtual QString getName() const = 0; // 取得名字
    virtual void setName(QString name) = 0; // 设置名字

    virtual void greet() = 0; // 打招呼
};

 Q_DECLARE_INTERFACE(HelloInterface,
                     "com.trolltech.PlugAndPaint.BrushInterface/1.0")

#endif // HELLOINTERFACE_H

这里只做一个插件
helloworldplugin.h

#ifndef HELLOWORLDPLUGIN_H
#define HELLOWORLDPLUGIN_H

#include "HelloWorldPlugin_global.h"
#include "../hellointerface.h"

class HELLOWORLDPLUGINSHARED_EXPORT HelloWorldPlugin :
        public QObject,
        public HelloInterface
{
    Q_OBJECT
    Q_INTERFACES(HelloInterface)

private:
    QString name;

public:
    virtual QString getName() const;
    virtual void setName(QString name);

    virtual void greet();


};

#endif // HELLOWORLDPLUGIN_H

helloworldplugin.c:

#include "helloworldplugin.h"

#include <cstdio>

QString HelloWorldPlugin::getName() const
{
    return this->name;
}

void HelloWorldPlugin::setName(QString name)
{
    this->name = name;
}

void HelloWorldPlugin::greet()
{
    std::printf("Hello, %s\n",this->name.toStdString().c_str());
}

Q_EXPORT_PLUGIN2(helloworldplugin, HelloWorldPlugin)

这里的Q_EXPORT_PLUGIN2宏输出HelloWorldPlugin具体类。第一个参数需要和.pro文件中的TARGET字段相同。


以上是插件。下面是主程序
main.cpp:

#include <QtCore/QCoreApplication>
#include <QPluginLoader>
#include <QDir>

#include "hellointerface.h"

#include <cstdio>

const char* PLUGINS_PATH="plugins";

int main(int argc, char *argv[])
{

    QDir pluginsDir(PLUGINS_PATH);

    foreach(QString fileName, pluginsDir.entryList()) {
        if(fileName.endsWith(".so")) {
            printf("Loading %s\n",fileName.toStdString().c_str());

            QPluginLoader loader(pluginsDir.absoluteFilePath(fileName));
            HelloInterface *plugin =
                    qobject_cast<HelloInterface*>(loader.instance());

            plugin->setName("wks");
            plugin->greet();
        }
    }
    return 0;
}

编译：

插件按照Qt Library的方式编译；主程序按照Qt Application方式编译即可。


运行：

文件结构：

[quote].
|-- PluginTest
`-- plugins
`-- libhelloworldplugin.so
[/quote]


执行结果：
[quote]Loading libhelloworldplugin.so
Hello, wks
[/quote]


总结：
1. main程序并不了解plugins目录中有多少插件。在运行时列举目录。
2. main程序对每个plugins文件（比如叫libhelloworldplugin.so）的了解只有：
- libhelloworldplugin.so定义了一个类，实现了那个已知接口，并用Q_EXPORT_PLUGIN2输出。