配置 JobRepository

如前所述，JobRepository 用于 Spring Batch 中各种持久化域对象的 CRUD 操作，例如 JobExecution 和 StepExecution。它被许多主要框架功能（如 JobLauncher、Job 和 Step）所需要。

  • Java

  • XML

当使用 @EnableBatchProcessing 时，会为您提供一个 JobRepository。本节介绍如何对其进行自定义。作业存储库的配置选项可以通过 @EnableBatchProcessing 注释的属性指定，如下例所示

Java 配置
@Configuration
@EnableBatchProcessing(
		dataSourceRef = "batchDataSource",
		transactionManagerRef = "batchTransactionManager",
		tablePrefix = "BATCH_",
		maxVarCharLength = 1000,
		isolationLevelForCreate = "SERIALIZABLE")
public class MyJobConfiguration {

   // job definition

}

此处列出的配置选项均不是必需的。如果未设置，则使用前面显示的默认值。最大 varchar 长度默认为 2500，这是 示例模式脚本 中长 VARCHAR 列的长度

批处理命名空间抽象了 JobRepository 实现及其协作者的许多实现细节。但是，仍然有一些配置选项可用，如下例所示

XML 配置
<job-repository id="jobRepository"
    data-source="dataSource"
    transaction-manager="transactionManager"
    isolation-level-for-create="SERIALIZABLE"
    table-prefix="BATCH_"
	max-varchar-length="1000"/>

除了id之外，前面列出的配置选项都不是必需的。如果未设置，则使用前面显示的默认值。max-varchar-length默认为2500，这是示例模式脚本中长VARCHAR列的长度。

JobRepository 的事务配置

如果使用命名空间或提供的FactoryBean，则会自动在存储库周围创建事务性建议。这是为了确保批处理元数据（包括重启后失败所需的状态）被正确持久化。如果存储库方法不是事务性的，则框架的行为没有明确定义。create*方法属性中的隔离级别是单独指定的，以确保当作业启动时，如果两个进程尝试同时启动同一个作业，只有一个进程成功。该方法的默认隔离级别是SERIALIZABLE，这非常激进。READ_COMMITTED通常也能很好地工作。READ_UNCOMMITTED如果两个进程不太可能以这种方式发生冲突，则可以。但是，由于对create*方法的调用非常短，因此SERIALIZED不太可能造成问题，只要数据库平台支持它。但是，您可以覆盖此设置。

  • Java

  • XML

以下示例显示了如何在 Java 中覆盖隔离级别

Java 配置
@Configuration
@EnableBatchProcessing(isolationLevelForCreate = "ISOLATION_REPEATABLE_READ")
public class MyJobConfiguration {

   // job definition

}

以下示例显示了如何在 XML 中覆盖隔离级别

XML 配置
<job-repository id="jobRepository"
                isolation-level-for-create="REPEATABLE_READ" />

如果未使用命名空间，则还必须使用 AOP 配置存储库的事务行为。

  • Java

  • XML

以下示例显示了如何在 Java 中配置存储库的事务行为

Java 配置
@Bean
public TransactionProxyFactoryBean baseProxy() {
	TransactionProxyFactoryBean transactionProxyFactoryBean = new TransactionProxyFactoryBean();
	Properties transactionAttributes = new Properties();
	transactionAttributes.setProperty("*", "PROPAGATION_REQUIRED");
	transactionProxyFactoryBean.setTransactionAttributes(transactionAttributes);
	transactionProxyFactoryBean.setTarget(jobRepository());
	transactionProxyFactoryBean.setTransactionManager(transactionManager());
	return transactionProxyFactoryBean;
}

以下示例显示了如何在 XML 中配置存储库的事务行为

XML 配置
<aop:config>
    <aop:advisor
           pointcut="execution(* org.springframework.batch.core..*Repository+.*(..))"/>
    <advice-ref="txAdvice" />
</aop:config>

<tx:advice id="txAdvice" transaction-manager="transactionManager">
    <tx:attributes>
        <tx:method name="*" />
    </tx:attributes>
</tx:advice>

您可以几乎不加修改地使用前面的片段。请记住还要包含适当的命名空间声明，并确保spring-tx和spring-aop（或整个 Spring）位于类路径中。

更改表前缀

JobRepository的另一个可修改属性是元数据表的表前缀。默认情况下，它们都以BATCH_为前缀。BATCH_JOB_EXECUTION和BATCH_STEP_EXECUTION是两个示例。但是，可能存在修改此前缀的原因。如果需要将模式名称添加到表名前缀，或者如果在同一个模式中需要多组元数据表，则需要更改表前缀。

  • Java

  • XML

以下示例显示了如何在 Java 中更改表前缀

Java 配置
@Configuration
@EnableBatchProcessing(tablePrefix = "SYSTEM.TEST_")
public class MyJobConfiguration {

   // job definition

}

以下示例展示了如何在 XML 中更改表前缀。

XML 配置
<job-repository id="jobRepository"
                table-prefix="SYSTEM.TEST_" />

鉴于前面的更改，对元数据表的每个查询都以 SYSTEM.TEST_ 为前缀。BATCH_JOB_EXECUTION 被称为 SYSTEM.TEST_JOB_EXECUTION。

只有表前缀是可配置的。表名和列名不可配置。

存储库中的非标准数据库类型

如果您使用的数据库平台不在支持的平台列表中，则如果 SQL 变体足够接近，您可能可以使用支持的类型之一。为此，您可以使用原始的 JobRepositoryFactoryBean 而不是命名空间快捷方式，并使用它将数据库类型设置为最接近的匹配项。

  • Java

  • XML

以下示例展示了如何在 Java 中使用 JobRepositoryFactoryBean 将数据库类型设置为最接近的匹配项。

Java 配置
@Bean
public JobRepository jobRepository() throws Exception {
    JobRepositoryFactoryBean factory = new JobRepositoryFactoryBean();
    factory.setDataSource(dataSource);
    factory.setDatabaseType("db2");
    factory.setTransactionManager(transactionManager);
    return factory.getObject();
}

以下示例展示了如何在 XML 中使用 JobRepositoryFactoryBean 将数据库类型设置为最接近的匹配项。

XML 配置
<bean id="jobRepository" class="org...JobRepositoryFactoryBean">
    <property name="databaseType" value="db2"/>
    <property name="dataSource" ref="dataSource"/>
</bean>

如果未指定数据库类型，则 JobRepositoryFactoryBean 会尝试从 DataSource 自动检测数据库类型。平台之间的主要区别主要在于递增主键的策略，因此通常还需要覆盖 incrementerFactory（通过使用 Spring 框架中的标准实现之一）。

如果即使这样也不起作用，或者您没有使用 RDBMS，唯一的选择可能是实现 SimpleJobRepository 依赖的各种 Dao 接口，并在正常的 Spring 方式中手动连接一个。