• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

C++消息框架-基于sigslot

原作者: [db:作者] 来自: [db:来源] 收藏 邀请

一、简介

上一篇文章Qt信号槽-原理分析主要讲述了Qt的信号槽实现原理,当然除了Qt的信号槽以外,还有boost的signals,sigslot和sigc++等等,都是非常不错的信号槽学习资料

  • boost的信号槽机制很强大,但是依赖了其他模块,而且对于大多数人来说,标准C++已经够用
  • sigc++功能也不错,但是文件数量比较多
  • sigslot只有一个头文件,非常轻量,而且现有功能够我们使用

了解sigslot用法可以参考sigslots的简单例子这篇文章,使用起来还是相对简单

本篇文章我们主要是使用sigslots来做一个简单的消息框架,主要是进行多个模块之间消息通信,当然也可以是插件之间通信。

我们的框架总的来说是一个简化版的消息通信机制,学习起来也比较轻松,如果用于实际的工程项目的话,还需要进一步的优化。

如下图所示,是我自己画的类图,我们通过signal1来发送消息,并传递给所有的Receiver,这里的接收者简单来说可以是一个类,如果是想复杂一些,也可以是一个插件,后边我会单独讲述怎么加载插件dll

二、消息

通常不同模块之间传递消息时我们需要定义一个消息结构,他可以作为函数回调时的参数,然后我们会根据参数中的唯一标识,来区分不同的消息,或者判断是不是我们想要处理的消息。

/** 消息结构*/
struct Message
{
    std::string m_strMessage; ///消息类型  唯一ID
    void *      m_pUserData;  ///发送的数据
};

如Message结构中的m_strMessage变量,他唯一标识了消息的类型,我们只需要判断是我们想处理的消息类型时,执行处理代码即可。

sigslot库中的信号最多支持8个参数,可是在我门日常的开发工作中,可能会存在一些特殊的场景,超过8个参数;除此之外,根据参数类型的不同,往复杂里写我们可能需要写大量的适配工作。在这里我们使用一个简单的小技巧,通过void *来转发我们的数据,也就是m_pUserData,这样不管多少数据,我们都可以封装到一个变量中。

m_pUserData里边我们可以存储任意类型的数据,只要我们在处理事件的时候知道怎么取出数据即可。

三、发送者

知道观察者模式的同学应该都知道,被观察的对象(Subject)维护了一个观察者(Observer)列表,当我们的被观察者发生变化的时候,被观察者可以遍历自己维护的观察者列表,然后将变化通知给观察者。同样的我们这个框架也类似于这样的设计,只不过我们的发送者没有维护接收者列表,而是通过信号槽的绑定机制,把发送者的发送函数绑定到了接收者的接收函数,而且是一对多绑定,也就是说我们的信号可以对多个槽。

这样的设计下,发送者和接收者还是有一定的耦合,后边有时间优化的话,我会引入一个第三方的管理者,帮助我们让发送者和接收者进行关联,这样也能提供最大的灵活性。

如下是发送者的代码

class Sender
{
public:
    void sendMessage(const std::string & = "", void * = 0);
    virtual void addReceiver(Receiver *);
    virtual void removeReceiver(Receiver *);

private:
    sigslot::signal1<Message *> m_pSender;
};

发送者包含3个接口,发送消息、添加接收者和移除接收者。而最重要的地方当属我们的m_pSender变量,他是sigslot库封装的信号,这个库总共提供了8种信号,但是我们只使用参数为1个的信号,因为我们把参数封装成了一个结构,也就是说我们的参数被包装成了一个对象。

下面我们来分析下这三个函数

1、发送消息函数

发送消息时,我们需要指定消息的id和消息的内容,并构造为一个Message对象,作为信号参数发送出去,这样槽函数就可以收到我们发送的内容。

特别注意,Message对象的销毁是在所有槽函数执行完毕以后

void Sender::sendMessage(const std::string & msgID, void * data)
{
    Message msg;
    msg.m_strMessage = msgID;
    msg.m_pUserData = data;

    m_pSender(&msg);//消息的接收者执行完后  msg被销毁
}

2、新增一个接收者函数

新增接收者时,我们只需要使用connect把接收者的函数绑定到我们的信号上即可。是不是特别简单呢!

void Sender::addReceiver(Receiver * receiver)
{
    m_pSender.connect(receiver, &Receiver::onMessage);
}

3、移除一个接收者函数

移除接受者时,我们只需要使用disconnect把接收者从绑定的接收者列表中移除即可。

void Sender::removeReceiver(Receiver * receiver)
{
    m_pSender.disconnect(receiver);
}

四、接收者

sigslot库要求我们,如果想要被signals信号连接,则我们的类必须从sigslot::has_slots<>继承,这里我们封装了一个Receiver类,方便后续我们写更多的功能类。这个类里我添加了一个onMessage函数,这个函数就是我们处理信号的回调函数,当signals发送信号时,onMessage函数就会被调用,我们在这里处理自己关注的事件即可。

class Receiver : public sigslot::has_slots<>
{
public:
    virtual void onMessage(Message *) = 0;
};

我们在写新功能时,只需要继承Receiver类,并实现onMessage函数即可。

Message就是我们发送信号时构造的对象,里边包含了消息的类型ID和用户数据,我们只需要根据消息ID就可以知道,这个消失是否是我们需要处理的,如果需要处理,那我们将需要小心翼翼的从void *中取出相关用户数据,进行处理。

例如下面代码,是一个简单的消息页面,当我们收到消息回调时,我们通过判断消息ID,他就是我们需要处理的消息NEW_ITEM_REPORT,然后我们打印了一句话,

这里只是简单举了一个例子,实际开发中,代码复杂度往往都比较高

class newsPage : public Receiver{
public:
    newsPage(Sender * sender) {
        sender->addReceiver(this);//把自己加入到消息接收者队列中
    }
    virtual void onMessage(Message * msg)    {
        if (msg->m_strMessage == "NEW_ITEM_REPORT")        {
            std::cout << "收到一条新消息:";
        }
    }
};

五、功能测试

下面我们写两个实际的消息接收类,来测试下消息框架

1、消息接收类

a、测试类1

消息接收类我们必须从Receiver来继承,并且需要把自己添加到信号对象的消息接收列表中。

处理消息时,当我们发现消息ID是字符串“1”时,是我们要处理的消息,则打印消息内容

class testReceiver1 : public Receiver{
public:
    testReceiver1(Sender * sender) {
        sender->addReceiver(this);//把自己加入到消息接收者队列中
    }
    virtual void onMessage(Message * msg)    {
        if (msg->m_strMessage == "1")        {
            std::cout << "testReceiver1:" << (char *)msg->m_pUserData << "\n";
        }
    }
};

b、测试类2

消息接收类2同类1一样,只是处理消息时,判断的消息ID不一样,这里不做解释,

class testReceiver2 : public Receiver{
public:
    testReceiver2(Sender * sender) {
        sender->addReceiver(this);//把自己加入到消息接收者队列中
    }
    virtual void onMessage(Message * msg)    {
        if (msg->m_strMessage == "2")        {
            std::cout << "testReceiver2:" << (char *)msg->m_pUserData << "\n";
        }
    }
};

2、测试代码

测试代码如下,我们构造了一个Sender发送者,并声明了两个消息接收对象,然后直接使用send对象开始发送消息

实际使用过程中,Sender可能不会这样直接暴露出来,通常是通过一个单例来进行管理

int main()
{
    Sender send;
    testReceiver1 rece1(&send);
    testReceiver2 rece2(&send);

    send.sendMessage("1", "Receiver1 deal");
    send.sendMessage("2", "Receiver2 deal");

    getchar();

    return 0;
}

3、测试结果

最终测试结果如下

  • 接收者1处理了消息类型为“1”的事件,并打印了testReceiver1:send2Receiver1
  • 接收者2处理了消息类型为“2”的事件,并打印了testReceiver2:send2Receiver2

六、源码

需要源码的留邮箱,现在的csdn简直太坑爹了。。。


如果您觉得文章不错,不妨给个打赏,写作不易,感谢各位的支持。您的支持是我最大的动力,谢谢!!!




很重要--转载声明

  1. 本站文章无特别说明,皆为原创,版权所有,转载时请用链接的方式,给出原文出处。同时写上原作者:朝十晚八 or Twowords

  2. 如要转载,请原文转载,如在转载时修改本文,请事先告知,谢绝在转载时通过修改本文达到有利于转载者的目的。



鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
C++编译的基本知识发布时间:2022-07-14
下一篇:
C/C++通用Makefile发布时间:2022-07-14
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap