Quartz Job Scheduling Framework[翻译]第八章. 使用 Quartz 插件 (第二部分)

二. 创建 Quartz 插件

创建一个新的插件很简单。你所有要做的就是创建一个 Java 类(或重用一个现有的类),让它实现 org.quartz.spi.SchedulerPlugin 接口。Scheduler 将会在启动期间创建这个插件的实例。这个插必须有一个无参的构造方法,很显然它不能是抽象的。

·JobInitializationPlugin
 
Quartz 框架有一个用来从 XML 文件中加载 Job 和 Trigger 信息的插件。这个插件就是 org.quartz.plugins.xml.JobInitializationPlugin,并且它在前面第三章 "Hello, Quartz" 中简略的讨论过。当你使用这个插件的时候,Quartz 框架就会搜寻一个叫做 quartz_jobs.xml 的文件并试图从中加载 Job 和 Trigger 信息。

改变 JobInitializtionPlugin 加载的 XML 文件

插件允许你改变它要查找来加载 Job 和 Trigger 信息的文件的名字。你可以通过在 quartz.properties 文件中设置一个别的文件名。我们会在本章后续中讲到更多的关于设置插件参数的内容。

如第三章所解释的,这个插件在你的应用需求不涉及到从数据库中加载 Job 信息时是很方便的。它在开发和测试期间也是很有用的,因为你可以快速的配置哪些 Job 和 Trigger 要被触发。就是说,无可争辩的,修改一个 XML 总比一系列的数据库表要简单。

对于从一个 XML 文件中加载 Job 和 Trigger 信息做法的一个很好的延展就是可以有一个目录来存储 Job XML 文件,然后过使用一个插件,Scheduler 就会加载任何存在的 Job 文件了。这允许你在 Scheduler 启动时简单从指定的目录中添加或移除 Job 文件来方便的增加或删除 Job。在本章剩下的部分,我们向你展示如何构建这个插件。
 
·创建 JobLoaderPlugin

我们把这个新插件命名为 JobLoaderPlugin。代码 8.2 中显示了这个 JobLoaderPlugin 类。

代码 8.2. 从一个目录中加载多个 Job 文件的 Quartz SchedulerPlugin

代码 8.2 中 JobLoaderPlugin 的实际工作仅是由两个方法:initialize()start() 来完成的。它们是 SchedulerPlugin 接口所必须的。其他的方法只是 setXXXgetXXX 方法是用于实现 JavaBean 规范的,因为声明了私有属性。

·JobLoaderPlugin initialize() 方法

正如你看到的,由 Scheduler 调用的 initialize() 方法会调用 loadJobs() 方法。loadJobs() 方法使用从 quartz.properties 文件传入的 jobsDirectory 所指示的目录中获取所有的 XML 文件。这个插件还不会试图部署 Job,因为在插件的 initialize() 方法被调用的时候 Scheduler 还没有完全初始化好。JobLoaderPlugin 只简单的持有一个 File 对象的数组,直等 start() 方法被调用。我们还持有了一个 Scheduler 实例,以便我们在 start() 方法在调用时能访问它。

·JobLoaderPlugin start() 方法

当 Scheduler 调用 JobLoaderPluginstart() 方法时,start() 方法就调用 processJobs()processJobs() 方法遍历那个 Job 文件的数组并把每个都加载到 Scheduler 实例中。

对 Job 文件的处理是通过一个 org.quartz.xml.JobSchedulingDataProcessor 实例来完成的。调用 processFileAndScheduleJobs() 方法并传入文件名,Scheduler 实例和一个布尔值告诉它是否覆盖已有的 Job。

processJobs() 方法完成后,这个指定 jobsDirectory 下的所有 Job 文件就已经被加载并被部署了。

类别: Quartz. 标签: , . 阅读(237). 订阅评论. TrackBack.

Leave a Reply

3 Comments on "Quartz Job Scheduling Framework[翻译]第八章. 使用 Quartz 插件 (第二部分)"

avatar
Unmi
Guest

到了 Quartz 1.8.4 的版本请使用 org.quartz.plugins.xml.XMLSchedulingDataProcessorPluginorg.quartz.xml.XMLSchedulingDataProcessor 这两个类来加载 Job 定义 XML 文件的。请了解下这两个类的功能。

Zack
Guest
Zack

隔叶黄莺 :你好.
我使用的是  quartz-1.8.4

在看着这个地方的时候,我发现在1.84的版本中是没有
org.quartz.xml.JobSchedulingDataProcessor
这个类的.
请问  JobLoaderPlugin 中我要如何解决错误.
随便问下那个 JobSchedulingDataProcessor 是干嘛的?

联系方式:longjianmin@sina.com

隔叶黄莺
Guest

补上 XMLFileOnlyFilter 的实现代码,这个过滤器可以随意实现 FileFilter 和 FilenameFilter 中的一个,它们都可以用在本例中,如下:

1) 实现 FileFilter:

package com.unmi;

import java.io.File;
import java.io.FileFilter;

/**
 * XML 文件过滤器
 * 
@author Unmi
 
*/
public class XMLFileOnlyFilter implements FileFilter {

    //接受 XML 文件
    public boolean accept(File pathname) {
        
        
//是文件并且扩展名为 xml 时则返回 true
        if(pathname.isFile() 
                
&& pathname.getName().toLowerCase().endsWith(".xml")){
            
return true;
        }
        
return false;
    }
}

2) 实现 FilenameFilter: 

package com.unmi;

import java.io.File;
import java.io.FilenameFilter;

/**
 * XML 文件过滤器
 * 
@author Unmi
 
*/
class XMLFileOnlyFilter implements FilenameFilter{

    //接受 XML 文件
    public boolean accept(File dir, String name) {
        
        
//是文件并且扩展名为 xml 时则返回 true
        if(new File(dir,name).isFile() &&
                name.toLowerCase().endsWith(
".xml")){
            
return true;
        }
        
return false;
    }
}