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

时间:2023-03-08 23:50:55
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 触发

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

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);
}