|
此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Batch 文档 5.2.2！ |
配置作业
有多种实现Job接口。然而
这些实现被抽象在提供的构建器（用于 Java 配置）或 XML 后面
命名空间（用于基于 XML 的配置）。以下示例显示了 Java 和 XML 配置：
-
Java
-
XML
@Bean
public Job footballJob(JobRepository jobRepository) {
return new JobBuilder("footballJob", jobRepository)
.start(playerLoad())
.next(gameLoad())
.next(playerSummarization())
.build();
}一个Job（并且，通常，任何Step在其中）需要一个JobRepository.
前面的示例说明了Job由三个组成Step实例。工作相关
构建器还可以包含有助于并行化的其他元素（Split),
声明式流控制 （Decision）和流定义的外部化（Flow).
有多种实现Job接口。但是，命名空间抽象化了配置中的差异。它有
只有三个必需的依赖项：名称、JobRepository，以及Step实例。
以下示例创建了一个footballJob:
<job id="footballJob">
<step id="playerload" parent="s1" next="gameLoad"/>
<step id="gameLoad" parent="s2" next="playerSummarization"/>
<step id="playerSummarization" parent="s3"/>
</job>前面的示例使用父 Bean 定义来创建步骤。
请参阅步骤配置部分，了解内联声明特定步骤详细信息时的更多选项。XML 命名空间
默认引用带有id之jobRepository哪
是一个合理的默认值。但是，您可以显式覆盖此默认值：
<job id="footballJob" job-repository="specialRepository">
<step id="playerload" parent="s1" next="gameLoad"/>
<step id="gameLoad" parent="s3" next="playerSummarization"/>
<step id="playerSummarization" parent="s3"/>
</job>除了步骤之外，作业配置还可以包含其他元素
有助于并行化 （<split>),
声明式流控制 （<decision>）和
流定义的外部化
(<flow/>).
可重启性
执行批处理作业时的一个关键问题涉及Job当它是
重新 启动。启动Job如果JobExecution已经存在，用于特定的JobInstance.理想情况下，所有作业都应该能够启动
从他们离开的地方开始，但在某些情况下这是不可能的。在这种情况下，完全由开发人员来确保新的JobInstance被创建。但是，Spring Batch 确实提供了一些帮助。如果Job永远不应该
restarted 但应始终作为新JobInstance，您可以将
restartable 属性设置为false.
-
Java
-
XML
以下示例演示如何设置restartable字段设置为false在 Java 中：
@Bean
public Job footballJob(JobRepository jobRepository) {
return new JobBuilder("footballJob", jobRepository)
.preventRestart()
...
.build();
}以下示例演示如何设置restartable字段设置为false在 XML 中：
<job id="footballJob" restartable="false">
...
</job>换句话说，将restartable自false意思是“这Job不支持重新启动“。重新启动Job那不是
restartable 会导致JobRestartException自
被扔掉。
以下 Junit 代码导致抛出异常：
Job job = new SimpleJob();
job.setRestartable(false);
JobParameters jobParameters = new JobParameters();
JobExecution firstExecution = jobRepository.createJobExecution(job, jobParameters);
jobRepository.saveOrUpdate(firstExecution);
try {
jobRepository.createJobExecution(job, jobParameters);
fail();
}
catch (JobRestartException e) {
// expected
}第一次尝试创建JobExecution对于不可重启的
作业不会导致任何问题。然而，第二个
尝试会抛出一个JobRestartException.
拦截作业执行
在执行过程中Job，收到各种通知可能会有用
事件，以便可以运行自定义代码。SimpleJob通过调用JobListener在适当的时候：
public interface JobExecutionListener {
void beforeJob(JobExecution jobExecution);
void afterJob(JobExecution jobExecution);
}您可以添加JobListeners设置为SimpleJob通过在作业上设置侦听器。
-
Java
-
XML
以下示例显示了如何将侦听器方法添加到 Java 作业定义中：
@Bean
public Job footballJob(JobRepository jobRepository) {
return new JobBuilder("footballJob", jobRepository)
.listener(sampleListener())
...
.build();
}以下示例显示了如何将侦听器元素添加到 XML 作业定义中：
<job id="footballJob">
<step id="playerload" parent="s1" next="gameLoad"/>
<step id="gameLoad" parent="s2" next="playerSummarization"/>
<step id="playerSummarization" parent="s3"/>
<listeners>
<listener ref="sampleListener"/>
</listeners>
</job>请注意，afterJob方法被调用，无论成功还是失败Job. 如果您需要确定成功或失败，您可以从JobExecution:
public void afterJob(JobExecution jobExecution){
if (jobExecution.getStatus() == BatchStatus.COMPLETED ) {
//job success
}
else if (jobExecution.getStatus() == BatchStatus.FAILED) {
//job failure
}
}与此接口对应的注释是：
-
@BeforeJob -
@AfterJob
从父作业继承
如果一组作业共享相似但不相同的配置，则定义“父级”可能会有所帮助Job混凝土从中Job实例可以继承属性。类似于类继承，一个“子”Job结合 其元素和属性与父级的元素和属性。
在以下示例中，baseJob是一个摘要Job仅定义列表的定义 听众。 这Job (job1） 是一个具体的定义，它继承了监听器列表baseJob并合并它与自己的侦听器列表以生成一个Job有两个听众和一个Step (step1).
<job id="baseJob" abstract="true">
<listeners>
<listener ref="listenerOne"/>
</listeners>
</job>
<job id="job1" parent="baseJob">
<step id="step1" parent="standaloneStep"/>
<listeners merge="true">
<listener ref="listenerTwo"/>
</listeners>
</job>有关更多详细信息，请参阅从父步骤继承部分。
作业参数验证器
在 XML 命名空间中声明的作业或使用AbstractJob可以选择为 运行。 例如，当您需要断言作业使用其所有必需参数启动时，这很有用。有一个DefaultJobParametersValidator您可以使用它来约束组合简单的强制参数和可选参数。对于更复杂的约束，您可以自己实现该接口。
-
Java
-
XML
验证器的配置通过 Java 构建器支持：
@Bean
public Job job1(JobRepository jobRepository) {
return new JobBuilder("job1", jobRepository)
.validator(parametersValidator())
...
.build();
}验证器的配置通过 XML 命名空间通过子作业的元素支持，如以下示例所示：
<job id="job1" parent="baseJob3">
<step id="step1" parent="standaloneStep"/>
<validator ref="parametersValidator"/>
</job>您可以将验证器指定为引用（如前面所示）或嵌套 Bean定义beansNamespace。