第三十四篇：在SOUI中使用异步通知

概述

异步通知是客户端开发中常见的需求，比如在一个网络处理线程中要通知UI线程更新等等。

通常在Windows编程中，为了方便，我们一般会向UI线程的窗口句柄Post/Send一个窗口消息从而达到将非UI线程的事件切换到UI线程处理的目的。

在SOUI引入通知中心以前要在SOUI中处理非UI线程事件我也推荐用上面的方法。

使用窗口消息至少有以下两个不足：

1、需要在线程中持有一个窗口句柄。

2、发出的消息只能在该窗口句柄的消息处理函数里处理。

SNotifyCenter

最新的SOUI引入了一个新的单例对象：SNotifyCenter，专门用来处理这类问题。

新的SNotifyCenter解决了窗口消息存在的上面的两个问题：

1、通过使用全局单例，SNotifyCenter可以在代码任意位置获取它的指针（前提当然是要在它的生命周期内）；

2、使用SNotifyCenter产生的通知采用SOUI的事件系统来派发，通过结合SOUI的事件订阅系统，用户可以在任意位置处理发出的事件。

在介绍如何使用SNotifyCenter前，先看一下NotifyCenter.h的代码：

#pragma once

#include <core/SSingleton.h>

namespace SOUI
{
template<class T>
class TAutoEventMapReg
{
typedef TAutoEventMapReg<T> _thisClass;
public:
TAutoEventMapReg()
{
SNotifyCenter::getSingleton().RegisterEventMap(Subscriber(&_thisClass::OnEvent,this));
}

~TAutoEventMapReg()
{
SNotifyCenter::getSingleton().UnregisterEventMap(Subscriber(&_thisClass::OnEvent,this));
}

protected:
bool OnEvent(EventArgs *e){
T * pThis = static_cast<T*>(this);
return !!pThis->_HandleEvent(e);
}
};

class SOUI_EXP SNotifyCenter : public SSingleton<SNotifyCenter>
, public SEventSet
{
public:
SNotifyCenter(void);
~SNotifyCenter(void);

/**
* FireEventSync
* @brief    触发一个同步通知事件
* @param    EventArgs *e -- 事件对象
* @return
*
* Describe  只能在UI线程中调用
*/
void FireEventSync(EventArgs *e);

/**
* FireEventAsync
* @brief    触发一个异步通知事件
* @param    EventArgs *e -- 事件对象
* @return
*
* Describe  可以在非UI线程中调用，EventArgs *e必须是从堆上分配的内存，调用后使用Release释放引用计数
*/
void FireEventAsync(EventArgs *e);

/**
* RegisterEventMap
* @brief    注册一个处理通知的对象
* @param    const ISlotFunctor &slot -- 事件处理对象
* @return
*
* Describe
*/
bool RegisterEventMap(const ISlotFunctor &slot);

/**
* RegisterEventMap
* @brief    注销一个处理通知的对象
* @param    const ISlotFunctor &slot -- 事件处理对象
* @return
*
* Describe
*/
bool UnregisterEventMap(const ISlotFunctor & slot);
protected:
void OnFireEvent(EventArgs *e);

void ExecutePendingEvents();

static VOID CALLBACK OnTimer( HWND hwnd,
UINT uMsg,
UINT_PTR idEvent,
DWORD dwTime
);

SCriticalSection    m_cs;            //线程同步对象
SList<EventArgs*>    *m_evtPending;//挂起的等待执行的事件
DWORD                m_dwMainTrdID;//主线程ID

UINT_PTR            m_timerID;    //定时器ID，用来执行异步事件

SList<ISlotFunctor*>    m_evtHandlerMap;
};
}

在这个文件中提供了两个类，一个就是SNotifyCenter，另一个是TAutoEventMapReg<T>。

可以看到SNotifyCenter中除构造外只有4个public方法:

FireEventSync, FireEventAsync用来触发事件。

RegisterEventMap，UnregisterEventMap则用来提供事件处理订阅。

如何使用SNotifyCenter?

1、在main中实例化SNotifyCenter。（不明白可以参考demo)

2、定义需要通过通知中心分发的事件类型，首先定义事件，然后向通知中心注册，参见下面代码：

void CMainDlg::OnBtnStartNotifyThread()
{
if(IsRunning()) return;
SNotifyCenter::getSingleton().addEvent(EVENTID(EventThreadStart));
SNotifyCenter::getSingleton().addEvent(EVENTID(EventThreadStop));
SNotifyCenter::getSingleton().addEvent(EVENTID(EventThread));

EventThreadStart evt(this);
SNotifyCenter::getSingleton().FireEventSync(&evt);
BeginThread();
}

void CMainDlg::OnBtnStopNotifyThread()
{
if(!IsRunning()) return;

EndThread();
EventThreadStop evt(this);
SNotifyCenter::getSingleton().FireEventSync(&evt);

SNotifyCenter::getSingleton().removeEvent(EventThreadStart::EventID);
SNotifyCenter::getSingleton().removeEvent(EventThreadStop::EventID);
SNotifyCenter::getSingleton().removeEvent(EventThread::EventID);
}

3、使需要处理通知中心分发的事件的对象从TAutoEventMapReg继承，实现事件的自动订阅（方便在事件映射表中统一处理事件)，这一步是可选的，你也可以直接使用SOUI提供的事件订阅机制向通知中心订阅特定事件。

4、在事件映射表里处理事件（没有第3步时，则同样没有这一步）。

具体用法参见SOUI的demo。