Quartz Job Scheduling Framework［翻译］第八章. 使用 Quartz 插件 (第三部分)

三. 注册你的插件

当 SchedulerFactory 首次初始化的时候，会从 quartz.properties 文件中搜寻你所配置的 Quartz 插件。它会通过 java.lang.Class 的 newInstance() 方法创建插件的实例。你的插件必须有一个无参的构造方法，像代码中 JobLoaderPlugin 所做的那样。

要在 quartz.properties 文件中注册你的插件的话，需在 quartz.properties 文件中使用如下的格式创建一个属性：

org.quartz.plugin.<pluginName>.class=<fully_qualified_class_name_of_plugin>

Quartz 找寻属性文件中所有含这个关键词的项：

org.quartz.plugin.<pluginName>.class

接着会试图创建等号右边的类的实例，并假定它是一个插件。你通过为 <pluginName> 字段提供一个唯一的名字来命你这个插件。

代码 8.3 展示了一个使用 JobLoaderPlugin 的 quartz.properties 文件。

代码 8.3. 在 quartz.properties 文件中注册 JobLoaderPlugin

你应该已经看过了在代码 8.3 的 quartz.properties 文中的大部分设置。最后一台就是用来注册 JobLoaderPlugin 的。

·在 quartz.properties 中指定插件

在初始化和启动期间，Quartz Scheduler 从 quartz.properties 文件中加载属性。你必须在 quartz.properties 文件中指定插件的时候遵循某一特定的格式。这一格式显示如下：

<plugin prefix>.<pluginName><.class>=<fully qualified Plugin class name>

    ·<plugin prefix> 总是 org.quartz.plugin.

    ·<pluginName> 是你指派的唯一的名字

    ·要指定插件类，使用后缀 .class

    ·右边是插件类的全限名

回头看代码 8.3，你会发现我们的 JobLoaderPlugin 是用了这一格式：

org.quartz.plugin.jobLoader.class=org.cavaness.quartzbook.chapter8.JobLoaderPlugin

指定给这个插件的名字是 jobLoader，可以任意的。我们可以使用任意的名字，只要它区别于其他已注册的插件是唯一的就行。在等号的右边，你必须指定插件类的全限名。这个类必须在 classpath 中或是对于类加载器可见。

·向插件传递参数

多数插件需要配置值，并以此作为好的编程实践，我们不希望把这些值硬编码到插件类中。Quartz 提供了一种机制向你的插件类传递参数，就是在 quartz.properties 文件中提供参数值。

Scheduler 找寻所有的能匹配如下格式的其他属性：

<plugin prefix>.<plugin name>.<property name>=<someValue>

它把把们视为插件类的 JavaBean 属性。从代码 8.3 中来看，意味着这一属性引发对 setJobDirectory() 方法的调用，并传递字符串值 c:\\quartz-book\\sample\\chapter8 作为该方法的参数：

org.quartz.plugin.jobLoader.jobsDirectory=c:\\quartz-book\\sample\\chapter8

你可以有配置给你的插件所需的更多的属性

Quartz 框架转换属性值成插件指定的类型，假定是原始类型，例如，你能指定属性的类型为 int，并期望　 Quartz 把 quartz.properties 文件中的字符串转换成一个 int。然而框架不会把 1 转换成一个 Integer 类。

·为 JobLoaderPlugin 创建 Job 文件

JobLoaderPlugin 查找指定目录下的所有 XML 文件，并假定每个文件都是有铲的 Quartz Job 文件。我们说 "有效"，意思是说 XML 文件是符合最新的 job-scheduling XSD 文件的，写这个的时候是 job_scheduling_data_1_5.xsd。

为使得 JobLoaderPlugin 更有用，我们把每一个 Job，和伴随着它的 JobDetail 和 Trigger 信息放在一个独立的 XML 文件中。这让我们在添加或完全移除 Job 时仅仅是把文件放入到这个目录中或是从中提出来。这对于你在开发环境中只是想测试某些 Job 的时候很有帮助。一个单一个 Job XML 文件如代码 8.4 所示。

代码 8.4. 一个由 JobLoaderPlugin 读取的 Job XML 文件

像代码 8.4 的 Job 文件中包含所有 JobLoaderPlugin 用来部署 Job 所需的信息。这个文件也包含一个 JobDataMap 项，这对于 Job 类运行时是可用的。代码 8.4 中的例子使用一个已配置的 SimpleTrigger 来部署一个以10秒为间隔不断重复的 Trigger。为进一步测试这个插件，我们创建了第二个 Job 文件，与前面的相比只有些许差别。代码 8.5 显示了第二个 Job 文件。

代码 8.5. 由 JobLoaderPlugin 加载的第二个 Job XML 文件

代码 8.5 所示的第二个 Job 文件与代码 8.4 的第一次相比只有稍稍不同。我们改变了 Job 所用来扫描的目录和触发计划。这里的重点就是在 Job 目录中你可以有多个 Job，而且 JobLoaderPlugin 将会加载它们并分别部署到 Scheduler 上。