基于quartz任务调度组件的使用

2.0
版本的
aop
框架中集成了
quartz
任务调度组件，该组件包含三部分：

1.

任务管理组件
:

用来启动和停止任务调度引擎，管理任务（新增，启动，修改，停止，挂起
/
继续，删除任务）

org.frameworkset.task.TaskService

2.

任务管理服务组件：按分组模式管理所有的
job
任务，并从相关的数据源加载作业任务

所有的任务管理组件都从抽象类
org.frameworkset.task. ScheduleService

继承

3.

任务配置文件：用来配置不同的作业服务和具体的作业
job
。对应的配置文件为：

/bbossaop/resources/org/frameworkset/task/quarts-task.xml

下面分别举例说明：

1.1

任务管理组件

任务管理控件：用来启动和停止任务调度引擎，管理任务（启动，修改，停止，删除任务）



org.frameworkset.task.TaskService

启动任务引擎

TaskService.getTaskService
().startService();

停止任务引擎

TaskService.getTaskService
().stopService();

删除任务

TaskService.getTaskService
().deleteJob(String jobname, String
groupid)

暂停任务

TaskService.getTaskService
().pauseJob(String jobname,
String groupid)

继续任务

TaskService.getTaskService
().
resumeJob(String name,
String groupid)

新增和启动任务

TaskService.getTaskService
().
startExecuteJob(String
groupid, SchedulejobInfo jobInfo)

更新任务

TaskService.getTaskService
()
.updateExecuteJob(String
groupid, SchedulejobInfo jobInfo)

1.2

任务管理服务组件

所有的任务管理组件都从抽象类
org.frameworkset.task. ScheduleService

继承，定义了一下抽象方法：

public


abstract


void

startService(Scheduler scheduler)
throws


ScheduleServiceException;

public


abstract


void


startExecuteJob(Scheduler scheduler,SchedulejobInfo jobInfo);

public


abstract


void


updateJob(Scheduler scheduler,SchedulejobInfo jobInfo);

public


abstract


void


updateTriger(Scheduler scheduler,SchedulejobInfo jobInfo);

public


abstract


void

updateJobAndTriger
(Scheduler
scheduler, SchedulejobInfo jobInfo);

系统中默认提供的任务管理组件

org.frameworkset.task.DefaultScheduleService

，用来加载系统中默认的静态的任务，可以配置多个作业任务

如果用户需要动态管理自己的作业任务，那么可以编写自己的
ScheduleService

，

实现
org.frameworkset.task.
ScheduleService

类的抽象方法：

public


class

DemoScheduleService

extends

ScheduleService {

@Override

public


void

startExecuteJob(Scheduler scheduler, SchedulejobInfo
jobInfo) {

//
执行新定义的任务

}

@Override

public


void

startService(Scheduler scheduler)

throws

ScheduleServiceException {

//
系统启动时，从资源库中获取所有的已经存在的任务，并加载到
scheduler
引擎中。

}

@Override

public


void

updateJob(Scheduler scheduler, SchedulejobInfo jobInfo)
{

更新一个已经加载的作业任务

}

@Override

public


void

updateJobAndTriger(Scheduler scheduler, SchedulejobInfo
jobInfo) {

更新作业任务，并触发任务的执行

}

@Override

public


void

updateTriger(Scheduler scheduler, SchedulejobInfo
jobInfo) {

更新任务触发器

}

}

编写好自定义的任务服务组件后就可以将其配置到
quarts-task.xml
文件中了，例如：

<
properties
>

<
property
name
=
"taskconfig"

enable
=
"true"

>

<
list
>

<
property
name
=
"demo

任务执行器

"

taskid
=
"

DemoScheduleService

"

class
=
"org.frameworkset.task.

DemoScheduleService

"

used
=
"true"

></
property
>

</
list
>

</
property
>

</
properties
>

必须指定唯一的
taskid
属性，
use
属性用来设置该任务组件是否生效。

1.3

任务管理配置文件

一个简单的配置文件

/bbossaop/resources/org/frameworkset/task/quarts-task.xml
的内容如下：

<
properties
>

<
property
name
=
"taskconfig"

enable
=
"true"

>

<
list
>

<
property
name
=
"

定时任务执行器

"

taskid
=
"default"

class
=
"org.frameworkset.task.DefaultScheduleService"

used
=
"true"

>

<!--

可执行的任务项

属性说明：

name
：任务项名称

id:
任务项标识

action:
具体的任务执行处理程序
,
实现
org.frameworkset.task.Execute
接口

cron_time
：

cron

格式的时间表达式，用来管理任务执行的生命周期，相关的规则请参照日期管理控件
quartz
的说明文档

used
是否使用

true
加载，缺省值

false
不加载

子元素说明：

Map
和
property
:
设置任务执行的参数，
name
标识参数名称，
value
指定参数的值

-->

<
list
>

<
property
name
=
"workbroker"

jobid
=
"workbroker"

class
=
"org.frameworkset.task.TestJob"

cronb_time
=
"0 56 14 * * ?"

used
=
"true"

>

<
map
>

<
property
name
=
"send_count"

value
=
"2"

/>

</
map
>

</
property
>

</
list
>

</
property
>

</
list
>

</
property
>

</
properties
>

说明：

org.frameworkset.task.DefaultScheduleService

是系统中默认提供的任务管理组件，用来加载系统中默认的静态的任务，可以配置多个，例如：

<
property
name
=
"workbroker"

jobid
=
"workbroker"

action
=
"org.frameworkset.task.TestJob"

cronb_time
=
"0 56 14 * * ?"

used
=
"true"

>

<
map
>

<
property
name
=
"send_count"

value
=
"2"

/>

</
map
>

</
property
>

属性说明：

Taskid
：用来区分任务组，可以作为任务组的唯一标识，系统中通过
Taskid
和
jobid
来区分唯一的一个作业任务，
TaskService
组件的很多方法中都有
groupid
和
jobname
两个参数，
taskid
就对应于
groupid
参数，
jobid
对应于
jobname
参数。

Name

任务的名称

Jobid

任务的标识

Action

任务执行的操作

cronb_time
任务执行的调度时间，具体需要参考
cronb_time
的语法。

use
：区分任务是否生效

内嵌的节点

<
map
>

<
property
name
=
"send_count"

value
=
"2"

/>

</
map
>

用来指定任务执行时需要的参数。

需要特别说明的是

Action

类必须实现

org.frameworkset.task.Execute
接口，例如：

public


class

TestJob

implements

Execute, Serializable {

public


void

execute(Map
parameters) {

System.
out

.println(
"send_count
= "
+parameters.get(
"send_count"
));

}

}

如果用户需要动态管理自己的作业任务，那么可以实现
org.frameworkset.task.
ScheduleService

类