SOUI中TaskLoop组件介绍

SOUI是一套开源（MIT协议）的Windows平台下的DirectUI框架，它提供了大量的高效控件，也提供了很多扩展组件，目前已经持续维护近10年，在大量的项目中证明稳定可靠。

GIT地址：

国内：https://gitee.com/setoutsoft/soui

国外：https://github.com/soui2/soui

下面介绍一个最近增加的组件：TaskLoop.

TaskLoop是一个异步任务模块。对于有网络请求的情况，异步任务是常规需求。

和使用其它SOUI组件一样，要使用异步任务模块，先完成组件的编译，然后就可以通过SComMgr来创建TaskLoop对象。

打开soui.08.sln可以看到上面工程组织结构。使用其它版本VS的朋友，可以用build.bat来生成自己需要的VS版本。

我们先看一看staskloop-i.h中的接口定义。

 #pragma once
 #include <unknown/obj-ref-i.h>

 namespace SOUI
 {
     struct IRunnable
     {
         virtual ~IRunnable() {}
         virtual IRunnable* clone() const = ;
         virtual void run() = ;
         virtual void *getObject() = ;
         virtual const char *getClassInfo() const = ;
     };

     struct ITaskLoop : public IObjRef
     {
         enum Priority
         {
             High = ,
             Normal = ,
             Low = -,
         };

         virtual bool getName(char *pszBuf, int nBufLen) = ;

         /**
         * Start a thread to run.
         * @param priority the thread priority
         */
         virtual void start(const char * pszName,Priority priority) = ;

         /**
         * Stop thread synchronized.
         */
         virtual void stop() = ;

         /**
         * postTask post or send a tasks to this task manager.
         * @param runnable the to be run task object.
         * @param waitUntilDone, true for send and false for post.
         * @param priority, the task priority.
         * @return the task id, can be used by cancelTask.
         */
         virtual long postTask(const IRunnable *runnable, bool waitUntilDone, int priority=) = ;

         /**
         * Remove tasks for a specific object from task loop pending task list
         * @param object the specific object wants pending functors to be removed
         */
         virtual void cancelTasksForObject(void *object) = ;

         /**
         * Cancel tasks for a specific task ID list
         * @param taskList the task ID list to be canceled
         * @return the removed task list.
         */
         virtual bool cancelTask(long taskId) = ;

         /**
         * get the total task number in the task loop queue.
         * @return total task number in task loop queue
         */
         virtual int getTaskCount() const = ;

         /**
         * get the run loop status.
         * @return the running status
         */
         virtual bool isRunning() = ;

         /**
         * get the running task info.
         * @param buf, to receive task info buf.
         * @param bufLen, buffer length
         * @return false - no task is running; true - succeed.
         */
         virtual bool getRunningTaskInfo(char *buf, int bufLen) = ;
     };
 }

创建出ITaskLoop接口后，先调用start来启动，再调用postTask来添加一个异步任务。添加到同一个TaskLoop对象中的任务顺序在同一个线程中执行。

任务的优先级默认是0，如果很多任务在排除，新加入的任务希望优先执行，则将nPriority这个参数设置为一个更大的值，任务插入队列的时候，自动根据nPriority排序，nPriority越大，排序越前。

postTask需要提供一个IRunnable对象来运行。

使用SOUI/helper/sfunctor.hpp可以方便的将一个对象的成员函数或者全局函数转换成为一个IRunnable对象。

下面看一下demo中如何使用ITaskLoop.

//演示异步任务。
class CAsyncTaskObj
{
public:
    void task1(int a)
    {
        SLOG_INFO("task1,a:" << a);
    }

    void task2(int a, const std::string & b)
    {
        SLOG_INFO("task2,a:" << a<<" b:"<<b.c_str());
    }
};

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, LPTSTR /*lpstrCmdLine*/, int /*nCmdShow*/)
{

    //必须要调用OleInitialize来初始化运行环境
    HRESULT hRes = OleInitialize(NULL);
    SASSERT(SUCCEEDED(hRes));

    //使用imgdecoder-png图片解码模块演示apng动画
    SComMgr2 *pComMgr = new SComMgr2(_T("imgdecoder-png"));

    {

        //演示异步任务。
        CAutoRefPtr<ITaskLoop>  pTaskLoop;
        if (pComMgr->CreateTaskLoop((IObjRef**)&pTaskLoop))
        {
            CAsyncTaskObj obj;
            pTaskLoop->start("test", ITaskLoop::Low);
            STaskHelper::post(pTaskLoop, &obj, &CAsyncTaskObj::task1, ,true);
            STaskHelper::post(pTaskLoop, &obj, &CAsyncTaskObj::task2, ,"abc", true);
            pTaskLoop->stop();
            pTaskLoop = NULL;
        }
      }
     //....
     return ;
}

注：

demo为了方便演示实际上是在工作线程中使用了同步等待。

使用TaskLoop最好结合SOUI的NotifyCenter对象一起使用，在异步任务中需要通知UI层，使用NotifyCenter是最简单有效的。

更多用法参考SOUI的壁纸demo: https://github.com/soui-demo/SouiWallPaper

启程软件 2019-02-03