18 TaskScheduler任务调度器抽象基类——Live555源码阅读(一)任务调度相关类

这是Live555源码阅读的第二部分，包括了任务调度相关的三个类。任务调度是Live555源码中很重要的部分。

本文由乌合之众 lym瞎编，欢迎转载 http://www.cnblogs.com/oloroso/

本文由乌合之众 lym瞎编，欢迎转载 my.oschina.net/oloroso

TaskScheduler任务调度器抽象基类

TaskScheduler是一个抽象基类，其定义在live555sourcecontrol\UsageEnvironment\include\UsageEnvironment.hh文件中。

TaskScheduler声明了很多纯虚接口，其实现一般在class BasicTaskScheduler0中。这里简要介绍一下。

TaskScheduler的默认构造函数是protected权限的，也就是只能被其内部的或派生类的方法调用。

这里先列出三个类型定义，这个在后面就不介绍了。在前面AlarmHandler中提过。

typedef void TaskFunc(void* clientData);
typedef void* TaskToken;//token 标志
typedef u_int32_t EventTriggerId;//Trigger 触发


TaskScheduler的定义如下

//任务调度器
class TaskScheduler {
public:
virtual ~TaskScheduler();/* 这是一个纯虚接口，在BasicTaskScheduler0中有一个实现*/
virtual TaskToken scheduleDelayedTask(int64_t microseconds, TaskFunc* proc,
void* clientData) = 0;
/* 这是一个纯虚接口，在BasicTaskScheduler0中有一个实现*/
virtual void unscheduleDelayedTask(TaskToken& prevTask) = 0;
// 没有影响，如果 prevTask == NULL
// 完成之后将设置 prevTask 为NULL// 虚接口，重新调度延时任务
// 先调用unscheduleDelayedTask(task);
// 在调用task = scheduleDelayedTask(microseconds, proc, clientData);
virtual void rescheduleDelayedTask(TaskToken& task,
int64_t microseconds, TaskFunc* proc,
void* clientData);// For handling socket operations in the background (from the event loop):
// 后台处理套接字操作类型（从事件循环）：注意，这是一个类型定义
typedef void BackgroundHandlerProc(void* clientData, int mask);
// 设置掩码位为mask,这是特意这样定义的，为了符合Tcl接口的一致性
// Tcl 是“工具控制语言（Tool Control Language）”的缩写。Tk 是 Tcl“图形工具箱”的扩展
// 它提供各种标准的 GUI 接口项，以利于迅速进行高级应用程序开发#define SOCKET_READABLE (1<<1)//readable adj.易读的; 易懂的;
#define SOCKET_WRITABLE (1<<2)//writable adj.可写下的，能写成文的;
#define SOCKET_EXCEPTION (1<<3)//exception n.例外，除外; 反对，批评;[法律]异议，反对;//设置后台处理
virtual void setBackgroundHandling(int socketNum, int conditionSet, BackgroundHandlerProc* handlerProc, void* clientData) = 0;
//禁用后台处理
void disableBackgroundHandling(int socketNum) { setBackgroundHandling(socketNum, 0, NULL, NULL); }
virtual void moveSocketHandling(int oldSocketNum, int newSocketNum) = 0;
// Changes any socket handling for "oldSocketNum" so that occurs with "newSocketNum" instead.
// 改变任何套接字操作“oldsocketnum”，发生在“newsocketnum”代替。virtual void doEventLoop(char* watchVariable = NULL) = 0;//创建一个事件触发器
virtual EventTriggerId createEventTrigger(TaskFunc* eventHandlerProc) = 0;//删除一个事件触发器
virtual void deleteEventTrigger(EventTriggerId eventTriggerId) = 0;//触发事件
virtual void triggerEvent(EventTriggerId eventTriggerId, void* clientData = NULL) = 0;
//以下两个功能是过时的，并提供仅为了向后兼容
void turnOnBackgroundReadHandling(int socketNum, BackgroundHandlerProc* handlerProc, void* clientData) {
setBackgroundHandling(socketNum, SOCKET_READABLE, handlerProc, clientData);
}
void turnOffBackgroundReadHandling(int socketNum) { disableBackgroundHandling(socketNum); }
//内部错误
virtual void internalError(); // used to 'handle' a 'should not occur'-type error condition within the library.
protected:
TaskScheduler(); // abstract base class 抽象基类
};


---

virtual void internalError()方法

因为TaskScheduler只实现了两个方法，所以还是说一说了。这个方法调用了库函数abort()。abrot函数作用是引发不正常进程的终止。这是用于在发生了内部错误的情况下，不得作出终止当前进程的决定。

在这个函数的实现处，有一行注释，翻译为中文大概意思是：默认情况下，我们处理的不应该发生的错误的类型调用abort()库函数。子类可以重新定义，如果需要的话。

// By default, we handle 'should not occur'-type library errors by calling abort(). Subclasses can redefine this, if desired.
void TaskScheduler::internalError() {
abort();
}


---

rescheduleDelayedTask重新调度延时任务

这个方法确实是在TaskScheduler中实现的，但是其调用的两个方法都是在其派生类中实现的。这个方法先取消一个任务的调度，然后重新调度这个任务。

void TaskScheduler::rescheduleDelayedTask(TaskToken& task,
int64_t microseconds, TaskFunc* proc,
void* clientData) {
unscheduleDelayedTask(task);
task = scheduleDelayedTask(microseconds, proc, clientData);
}