Spring Batch 2. 行话

 

每一个行业都有自己的行话，SpringBatch也不例外。

 

Job

一个Job是用于封装一整个批处理的实体。和其它Spring项目一样，一个Job和一个XML配置文件相连。这个文件可能叫任务配置。无论如何，Job是整个层次结构的顶点。

 

一个Job就是一系列Step的容器。Job可以定义一些属性，如是否可以重新执行。Step会使用Job定义的属性。

 

Job的定义包含下面几个部分
• 一个简单的名字
• 一系列步骤
• 是否支持重新执行

 

SpringBatch提供一个基本的实现SimpleJob。可以用下面方式配置一个Job

<job id="footballJob">
    <step id="playerload" next="gameLoad"/>
    <step id="gameLoad" next="playerSummarization"/>
    <step id="playerSummarization"/>
</job>

 

JobInstance

一个JobInstance就是一个Job的实例。一个Job的每次受调度都会产生一个JobInstance。假如我们配置一个每天都运行的任务。那么每天都会有一个JobInstance产生。1月1号会有一个JobInstance，1月2号会有一个。如果1月1号的那个JobInstance执行失败，再执行一次并不会新产生一个JobInstance，还是1月1号的那个JobInstance。

一个JobInstance不和任何数据绑定。JobInstance只保存状态，如何加载数据完全由ItemReader的实现决定。

 

 

JobParameters

JobParameters用于区分JobInstance。一个JobParameters是在开始一个Job时的一组参数。

在上图的例子中，有两个JobInstance，1月1号和1月2号。但是它们属于同一个Job，所以我们可以说JobInstance = Job + JobParameters。

 

JobExecution

一个JobExecution就是一次真正意义上一次Job的执行。一个JobInsntace可以有多个JobExecution，一个JobExecution的失败并不意味这个JobInstance失败。

 

一个Job定义这个Job该如何执行。JobInstnace用于将一系列的JobExecution组织起来。JobExecution会将本次执行的状态记录下来。

 

JobExecution有如下属性：

• status：本次执行的状态，可以是BatchStatus.STARTED、BatchStatus.FAILED、BatchStatus.COMPLETED等

• startTime：JobExecution执行开始时间

• endTime：JobExecution执行的结束时间

• exitStatus：JobExecution执行的结果

• createTime：JobExecution的生成时间。如果还没有开始执行那么就没有startTime，但是createTime始终是有的。

• lastUpdated：最后更新时间

• executionContext：一个容器，用于执行时需要保存的用户数据。

• failureExceptions：执行时碰到的异常列表。有多个异常的导致失败时会有用。

 

Step

每个Job包含一个或多个Step。一个Step包含实际执行需要的信息。一个Step可以很简单也业很复杂。一个简单的Step可能不需要代码或只要写一点点代码，如把数据从文件加载到数据库中。和Job一样，一个Step也有StepExecution的概念。如下图所示，Job由Step组成，JobExecution由StepExecution组成。

StepExecution

StepExecution表示一个Step的执行。 StepExecution只有在真正开始时才会生成，而不是JobExecution开始时就生成所有的StepExecution。StepExecution有对应的Step（可能只是名字？）和JobExecution的引用，以及和事务相关的数据。它还有一个ExecutionContext，用于保存用户数据。

 

StepExecution有下面的一系列属性。

 

• status：本次执行的状态，可以是BatchStatus.STARTED、BatchStatus.FAILED、BatchStatus.COMPLETED等

• startTime：JobExecution执行开始时间

• endTime：JobExecution执行的结束时间

• exitStatus：JobExecution执行的结果

• createTime：JobExecution的生成时间。如果还没有开始执行那么就没有startTime，但是createTime始终是有的。

• executionContext：一个容器，用于执行时需要保存的用户数据。

• failureExceptions：执行时碰到的异常列表。有多个异常的导致失败时会有用。

• readCount：有少条记录已经成功的读了。

• writeCount：有少条记录已经成功的写了。

• commitCount：已经提交了多少次事务了。

• rollbackCount：和Step相关的事物被回滚了多少次。

• readSkipCount：读跳过了多少次。resulting in a skipped item.？

• processSkipCount：处理跳过了多少次。resulting in a skipped item.

• filterCount：用ItemProcessor跳过了多少条记录。

• writeSkipCount：写跳过了多少次。resulting in a skipped item.？

ExecutionContext

ExecutionContext是一系列的键/值对，由框架控制保存。它允许用户保存StepExecution或JobExecution的状态信息。ExecutionContext和Quartz的JobDataMap非常类似。使用ExecutionContext的最佳例子就是重试的辅助。以读取文本文件为例，处理时可以将处理到哪一行记录到ExecutionContext中，框架会把这些信息在检入点永久保持起来。当失败时可以从上次失败的那个点开始重新运行。

 

 

JobRepository

JobRepository是上面所有东西的存储机制。它为JobLauncher、Job和Step的实现提供了CRUD操作。当一个Job开始运行时，从JobRepository获取一个JobExecution。在执行阶段StepExecution和JobExecution会保存到JobRepository中。

 

JobLauncher

JobLauncher用于从JobRepository获取JobExecution和执行该JobExecution。接口定义如下。

public interface JobLauncher {
    public JobExecution run(Job job, JobParameters jobParameters)
        throws JobExecutionAlreadyRunningException, JobRestartException;
    }
}

ItemReader

ItemReader用于抽象Step的输入。当所有输入读完后返回null。

 

ItemWriter

ItemWriter用于抽象Step的输出，每次一条记录。通常来说，ItemWriter并不知道下一条要处理什么，它只有当前的那条记录。

 

ItemProcessor

 

ItemProcessor用于抽象一条记录的处理。ItemReader用于读一条记录，ItemWriter用于写一条记录，ItemProcessor用于应用业务逻辑，从一种格式到另一种格式。在处理过程中，返回null表示这条记录不需要写下来。