【Darwin学习笔记】之TaskThread

【转载请注明出处】：http://blog.csdn.net/longlong530

学习TaskThread主要有三个类要关注：

TaskTreadPool： 任务线程池

TaskThread：任务线程

Task: 任务

1. TaskThreadPool
Darwin运行着一个或者多个任务（Task）线程，并将他们统一在线程池TaskThreadPool中管理。任务线程从事件线程中接收RTSP和RTP请求，然后把请求传递到恰当的服务器模块进行处理，把数据包发送给客户端。
缺省情况下，核心服务器为每一个处理器创建一个任务线程。（numProcessors = OS::GetNumProcessors();）     

1.  
   TaskThreadPool::SetNumShortTaskThreads(numShortTaskThreads);
2.  
   TaskThreadPool::SetNumBlockingTaskThreads(numBlockingThreads);
3.  
   TaskThreadPool::AddThreads(numThreads);
4.  
   sServer->InitNumThreads(numThreads);

2. TaskThread

所有的Task对象都将在TaskThread中运行,TaskThread通过运行Task类型对象的Run方法来完成相应Task的处理。TaskThread的个数是可配置的，缺省情况下TaskThread的个数与处理器的个数一致。等待被TaskThread调用并运行的Task放在队列或者堆中。

1.  
   void TaskThread::Entry()
2.  
   {
3.  
   Task* theTask = NULL;
4.  
    
5.  
   while (true)
6.  
   {
7.  
   //不停的从内部的队列中取到Task才返回;,此时的Task既不在堆中，也不在队列中;
8.  
   theTask = this->WaitForTask();
9.  
   /*此处省略，主要是对调用task的Run方法的返回值做不同的分支处理，详细分析在Task章节介绍*/
10.  
    }
11.  
     

我们还是仔细分析下WaitForTask方法吧：

1.  
   Task* TaskThread::WaitForTask()
2.  
   {
3.  
   while (true)
4.  
   {
5.  
   SInt64 theCurrentTime = OS::Milliseconds();
6.  
   /*如果堆中有任务，且任务已经到执行时间，返回该任务。
7.  
   PeekMin函数见OSHeap.h，窃听堆中第一个元素（但不取出）*/
8.  
   if ((fHeap.PeekMin() != NULL) && (fHeap.PeekMin()->GetValue() <= theCurrentTime))
9.  
   {
10.  
    if (TASK_DEBUG) qtss_printf("TaskThread::WaitForTask found timer-task=%s thread %p fHeap.CurrentHeapSize(%"_U32BITARG_") taskElem = %p enclose=%p ",((Task*)fHeap.PeekMin()->GetEnclosingObject())->fTaskName, (void *) this, fHeap.CurrentHeapSize(), (void *) fHeap.PeekMin(), (void *) fHeap.PeekMin()->GetEnclosingObject());
11.  
    return (Task*)fHeap.ExtractMin()->GetEnclosingObject();//从堆中取出第一个任务返回
12.  
    }
13.  
    //如果堆中有任务，但是尚未到执行时间，计算需要等待的时间
14.  
    //if there is an element waiting for a timeout, figure out how long we should wait.
15.  
    SInt64 theTimeout = 0;
16.  
    if (fHeap.PeekMin() != NULL)
17.  
    theTimeout = fHeap.PeekMin()->GetValue() - theCurrentTime;
18.  
    Assert(theTimeout >= 0);
19.  
     
20.  
    //
21.  
    // Make sure we can't go to sleep for some ridiculously short
22.  
    // period of time
23.  
    // Do not allow a timeout below 10 ms without first verifying reliable udp 1-2mbit live streams.
24.  
    // Test with streamingserver.xml pref reliablUDP printfs enabled and look for packet loss and check client for buffer ahead recovery.
25.  
    if (theTimeout < 10)
26.  
    theTimeout = 10;
27.  
     
28.  
    //wait...
29.  
    //如果任务队列为空，就等待theTimeout时间后从堆中取出任务返回;
30.  
    //如果任务队列不为空，就不等待，直接取队列中的任务;
31.  
    OSQueueElem* theElem = fTaskQueue.DeQueueBlocking(this, (SInt32) theTimeout);
32.  
    if (theElem != NULL)
33.  
    {
34.  
    if (TASK_DEBUG) qtss_printf("TaskThread::WaitForTask found signal-task=%s thread %p fTaskQueue.GetLength(%"_U32BITARG_") taskElem = %p enclose=%p ", ((Task*)theElem->GetEnclosingObject())->fTaskName, (void *) this, fTaskQueue.GetQueue()->GetLength(), (void *) theElem, (void *)theElem->GetEnclosingObject() );
35.  
    return (Task*)theElem->GetEnclosingObject();
36.  
    }
37.  
     
38.  
    //
39.  
    // If we are supposed to stop, return NULL, which signals the caller to stop
40.  
    if (OSThread::GetCurrent()->IsStopRequested())
41.  
    return NULL;
42.  
    }
43.  
    }

3. Task
每个Task对象有两个主要的方法：Signal和Run。

3.1 Run()

Run()方法是在Task对象获得处理该事件的时间片后运行的，Darwin中的大部分工作都是在不同Task对象的Run()函数中进行的。
比如常见的Task类型是RTSPSession和RTPSession。
在这里程序的返回值是一个重要的信息:
当返回-1时,表明任务已经完全结束,程序会直接删除该Task指针;
当返回0时，线程接着执行下一个Task，表明任务希望在下次传信时被再次立即执行;
当返回一个正数n时，线程会在 n毫秒后再次调用这个Task的Run函数。将该任务加入到Heap中，并且纪录它希望等待的时间。Entry()函数将通过waitfortask()函数进行检测，如果等待的时间到了，就再次运行该任务
(注意; 在我们继承Task类，而重写Run虚函数时，我们第一件要作的事情是运行Task类的GetEvent（）函数。)

virtual SInt64 Run() = 0;

       

3.2 Signal()

当服务器希望发送一个事件给某个Task对象时，就会调用Signal()方法;
将该任务加入到指定任务线程的任务队列中，如果不存在指定的任务线程，就在线程池中随机选择一个任务线程运行该任务

 void  Signal(EventFlags eventFlags);