CTK框架(九):插件间通信

编译EventAdmin库 ：确保eventadmin.dll（或其他平台对应的库文件）已经编译成功。
创建发送插件 ：
- 新建一个插件项目，编写发送类（如BlogManager），在该类中实现发布事件的方法（如publishBlog）。
- 在发送类的构造函数中，通过ctkPluginContext获取EventAdmin服务的引用，并保存为成员变量。
- 在发布事件的方法中，创建ctkEvent对象，设置事件的属性和数据，然后通过EventAdmin服务的sendEvent或postEvent方法发送事件。
创建接收插件 ：
- 新建一个插件项目，编写接收类（如BlogEventHandler），实现ctkEventHandler接口中的handleEvent方法。
- 在接收类的激活类中，通过ctkPluginContext注册服务，并订阅相应主题的事件。
- 在handleEvent方法中编写处理事件的逻辑。
启用插件 ：
- 在主程序中加载并启动发送插件和接收插件。
- 发送插件发布事件后，接收插件将接收到该事件，并执行相应的处理逻辑。

5.实现示例

5.1.类通信

代码结构：

插件结构说明：

cn.qtio.publisher：发送【发布者】

cn.qtio.subscriber：接收【订阅类】

发送【发布者】

publisheractivator.h

cpp 复制代码

#ifndef TESTPLUGINACTIVATOR_H
#define TESTPLUGINACTIVATOR_H

#include <QObject>
#include <ctkPluginActivator.h>

class PublisherActivator : public QObject, public ctkPluginActivator
{
    Q_OBJECT
    Q_INTERFACES(ctkPluginActivator)
    Q_PLUGIN_METADATA(IID "Publisher")

public:
    void start(ctkPluginContext* context) Q_DECL_OVERRIDE;
    void stop(ctkPluginContext* context) Q_DECL_OVERRIDE;
};

#endif // TESTPLUGINACTIVATOR_H

publisheractivator.cpp

cpp 复制代码

#include "publisheractivator.h"

#include <QDebug>
#include <QThread>
#include <service/event/ctkEventAdmin.h>

void PublisherActivator::start(ctkPluginContext *context)
{
    ctkServiceReference ref = context->getServiceReference<ctkEventAdmin>();
    ctkEventAdmin *eventAdmin = qobject_cast<ctkEventAdmin*>(context->getService(ref));
    ctkProperties props;
    props.insert("type", "消息类型");
    ctkEvent event("cn/qtio/eventAdmin/subscriber/handleEvent", props);
    if(eventAdmin){
        //sendEvent:同步通信
        eventAdmin->sendEvent(event);
    }
}

void PublisherActivator::stop(ctkPluginContext *context)
{
    Q_UNUSED(context)
}
#if (QT_VERSION < QT_VERSION_CHECK(5,0,0))
Q_EXPORT_PLUGIN2(Publisher, PublisherActivator)
#endif

接收【订阅类】

subscriberactivator.h

cpp 复制代码

#ifndef SUBSCRIBERACTIVATOR_H
#define SUBSCRIBERACTIVATOR_H

#include <QObject>
#include <ctkPluginActivator.h>
#include <service/event/ctkEventAdmin.h>
#include <service/event/ctkEventHandler.h>

class SubscriberActivator :
        public QObject,
        public ctkPluginActivator,
        public ctkEventHandler
{
    Q_OBJECT
    Q_INTERFACES(ctkPluginActivator)
    Q_INTERFACES(ctkEventHandler)
    Q_PLUGIN_METADATA(IID "Subscriber")

public:
    void start(ctkPluginContext* context) Q_DECL_OVERRIDE;
    void stop(ctkPluginContext* context) Q_DECL_OVERRIDE;

private:
    void handleEvent(const ctkEvent &event) Q_DECL_OVERRIDE;

private:
    ctkEventAdmin *m_eventAdmin;
};

#endif // SUBSCRIBERACTIVATOR_H

subscriberactivator.cpp

cpp 复制代码

#include "subscriberactivator.h"

#include <QDebug>
#include <service/event/ctkEventConstants.h>

void SubscriberActivator::start(ctkPluginContext* context)
{
	//事件管理服务
	ctkServiceReference eventAdminRef = context->getServiceReference<ctkEventAdmin>();
	m_eventAdmin = qobject_cast<ctkEventAdmin*>(context->getService(eventAdminRef));
	if (!m_eventAdmin) {
		qDebug() << "事件管理服务获取失败！";
	}

	//消息订阅
	ctkDictionary props;
	props.insert(ctkEventConstants::EVENT_TOPIC, "cn/qtio/eventAdmin/subscriber/handleEvent");
	context->registerService<ctkEventHandler>(this, props);
}

void SubscriberActivator::stop(ctkPluginContext* context)
{
	Q_UNUSED(context)
}

void SubscriberActivator::handleEvent(const ctkEvent& event)
{
	//查看消息包所有信息
	foreach(QString propertyName, event.getPropertyNames()) {
		qDebug() << "SubscriberActivator key:"
			<< propertyName
			<< "value:"
			<< event.getProperty(propertyName);
	}
}
#if (QT_VERSION < QT_VERSION_CHECK(5,0,0))
Q_EXPORT_PLUGIN2(Subscriber, SubscriberActivator)
#endif

5.2.信号槽通信

信号槽通信和Qt的信号槽绑定类似，就不在这里赘述了。

6.类通信和信号槽通信的区别

通过event事件通信，是直接调用CTK的接口，把数据发送到CTK框架；通过信号槽方式，会先在Qt的信号槽机制中转一次，再发送到CTK框架。故效率上来讲，event方式性能高于信号槽方式。
两种方式发送数据到CTK框架，这个数据包含：主题+属性。主题就是topic，属性就是ctkDictionary。一定要注意signal方式的信号定义，参数不能是自定义的，一定要是ctkDictionary，不然会报信号槽参数异常错误。
两种方式可以混用，如发送event事件，再通过槽去接收；发送signal事件，再通过event是接收。
同步：sendEvent、Qt::DirectConnection；异步：postEvent、Qt::QueuedConnection

这里的同步是指：发送事件之后，订阅了这个主题的数据便会处理数据【handleEvent、slot】，处理的过程是在发送者的线程完成的。可以理解为在发送了某个事件之后，会立即执行所有订阅此事件的回调函数。

异步：发送事件之后，发送者便会返回不管，订阅了此事件的所有插件会根据自己的消息循环，轮到了处理事件后才会去处理。不过如果长时间没处理，CTK也有自己的超时机制。如果事件处理程序花费的时间比配置的超时时间长，那么就会被列入黑名单。一旦处理程序被列入黑名单，它就不会再被发送任何事件。

handleEvent里是线程池里运行的，可以通过打印线程id测试出。

7.注意事项

在进行插件间通信时，需要确保所有相关的库文件都已经正确编译并链接到项目中。
订阅事件时，可以指定事件过滤器来过滤不需要处理的事件。
发送事件时，需要确保事件的主题和数据已经正确设置，以便接收插件能够正确解析和处理。