配置跳过逻辑
在许多情况下,处理过程中遇到的错误不应该导致 Step
失败,而应该跳过。这通常需要了解数据本身及其含义的人员做出决定。例如,财务数据可能无法跳过,因为它会导致资金转移,这需要完全准确。另一方面,加载供应商列表可能允许跳过。如果由于格式错误或缺少必要信息而未加载供应商,则可能不会出现问题。通常,这些错误记录也会被记录下来,这将在稍后讨论监听器时介绍。
-
Java
-
XML
以下 Java 示例演示了如何使用跳过限制
@Bean
public Step step1(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
return new StepBuilder("step1", jobRepository)
.<String, String>chunk(10, transactionManager)
.reader(flatFileItemReader())
.writer(itemWriter())
.faultTolerant()
.skipLimit(10)
.skip(FlatFileParseException.class)
.build();
}
以下 XML 示例演示了如何使用跳过限制
<step id="step1">
<tasklet>
<chunk reader="flatFileItemReader" writer="itemWriter"
commit-interval="10" skip-limit="10">
<skippable-exception-classes>
<include class="org.springframework.batch.item.file.FlatFileParseException"/>
</skippable-exception-classes>
</chunk>
</tasklet>
</step>
在前面的示例中,使用了 FlatFileItemReader
。如果在任何时候抛出 FlatFileParseException
,则跳过该项目并将其计入总跳过限制 10 次。在块处理的任何阶段(读取、处理或写入)都可能抛出声明的异常(及其子类)。在步骤执行过程中,对读取、处理和写入的跳过进行了单独计数,但限制适用于所有跳过。一旦达到跳过限制,则找到的下一个异常将导致步骤失败。换句话说,第十一跳触发异常,而不是第十跳。
前面示例的一个问题是,除了 FlatFileParseException
之外的任何其他异常都会导致 Job
失败。在某些情况下,这可能是正确的行为。但是,在其他情况下,识别哪些异常会导致失败并跳过所有其他异常可能更容易。
-
Java
-
XML
以下 Java 示例演示了如何排除特定异常
@Bean
public Step step1(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
return new StepBuilder("step1", jobRepository)
.<String, String>chunk(10, transactionManager)
.reader(flatFileItemReader())
.writer(itemWriter())
.faultTolerant()
.skipLimit(10)
.skip(Exception.class)
.noSkip(FileNotFoundException.class)
.build();
}
以下 XML 示例演示了如何排除特定异常
<step id="step1">
<tasklet>
<chunk reader="flatFileItemReader" writer="itemWriter"
commit-interval="10" skip-limit="10">
<skippable-exception-classes>
<include class="java.lang.Exception"/>
<exclude class="java.io.FileNotFoundException"/>
</skippable-exception-classes>
</chunk>
</tasklet>
</step>
通过将 java.lang.Exception
标识为可跳过异常类,配置指示所有 Exceptions
都可以跳过。但是,通过“排除” java.io.FileNotFoundException
,配置将可跳过异常类的列表细化为所有 Exceptions
*除了* FileNotFoundException
。如果遇到任何被排除的异常类,则该类是致命的(即,它们不会被跳过)。
对于遇到的任何异常,其可跳过性由类层次结构中最接近的超类决定。任何未分类的异常都被视为“致命”异常。
-
Java
-
XML
skip
和 noSkip
方法调用的顺序无关紧要。
<include/>
和 <exclude/>
元素的顺序无关紧要。