此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Batch 文档 5.2.2！spring-doc.cadn.net.cn

子元素

当这个Gateway正在接收来自PollableChannel，您必须提供全局默认值Poller或提供Poller子元素添加到Job Launching Gateway.spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例显示了如何在 Java 中提供轮询器：spring-doc.cadn.net.cn

Java 配置

@Bean
@ServiceActivator(inputChannel = "queueChannel", poller = @Poller(fixedRate="1000"))
public JobLaunchingGateway sampleJobLaunchingGateway() {
    JobLaunchingGateway jobLaunchingGateway = new JobLaunchingGateway(jobLauncher());
    jobLaunchingGateway.setOutputChannel(replyChannel());
    return jobLaunchingGateway;
}

以下示例显示了如何在 XML 中提供轮询器：spring-doc.cadn.net.cn

XML 配置

<batch-int:job-launching-gateway request-channel="queueChannel"
    reply-channel="replyChannel" job-launcher="jobLauncher">
  <int:poller fixed-rate="1000">
</batch-int:job-launching-gateway>

通过信息性消息提供反馈

由于 Spring Batch 作业可以运行很长时间，因此提供进度信息通常至关重要。例如，利益相关者可能希望如果批处理作业的部分或全部部分失败，则收到通知。Spring Batch 为正在收集的信息提供支持通过：spring-doc.cadn.net.cn

主动轮询spring-doc.cadn.net.cn
事件驱动的侦听器spring-doc.cadn.net.cn

异步启动 Spring Batch 作业时（例如，通过使用 Job LaunchingGateway），一个JobExecutioninstance 被返回。因此，您可以使用JobExecution.getJobId()通过检索JobExecution从JobRepository通过使用JobExplorer. 但是，这是被认为是次优的，并且首选事件驱动的方法。spring-doc.cadn.net.cn

因此，Spring Batch 提供了监听器，包括最常用的三个听众：spring-doc.cadn.net.cn

StepListenerspring-doc.cadn.net.cn
ChunkListenerspring-doc.cadn.net.cn
JobExecutionListenerspring-doc.cadn.net.cn

在下图所示的示例中，Spring Batch 作业已配置了StepExecutionListener. 因此，Spring Integration 接收并处理事件之前或之后的任何步骤。例如，您可以检查收到的StepExecution通过使用Router. 根据该检查的结果，可能会发生各种情况（例如将邮件路由到邮件出站通道适配器），以便电子邮件通知可以根据某些条件发送出去。spring-doc.cadn.net.cn

图 1.处理信息性消息

以下由两部分组成的示例显示了如何配置侦听器以将消息发送到Gateway对于一个StepExecution事件并将其输出记录到logging-channel-adapter.spring-doc.cadn.net.cn

首先，创建通知集成 Bean。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例显示了如何在 Java 中创建通知集成 Bean：spring-doc.cadn.net.cn

Java 配置

@Bean
@ServiceActivator(inputChannel = "stepExecutionsChannel")
public LoggingHandler loggingHandler() {
    LoggingHandler adapter = new LoggingHandler(LoggingHandler.Level.WARN);
    adapter.setLoggerName("TEST_LOGGER");
    adapter.setLogExpressionString("headers.id + ': ' + payload");
    return adapter;
}

@MessagingGateway(name = "notificationExecutionsListener", defaultRequestChannel = "stepExecutionsChannel")
public interface NotificationExecutionListener extends StepExecutionListener {}

您需要添加@IntegrationComponentScan注释添加到您的配置中。

以下示例显示了如何在 XML 中创建通知集成 Bean：spring-doc.cadn.net.cn

XML 配置

<int:channel id="stepExecutionsChannel"/>

<int:gateway id="notificationExecutionsListener"
    service-interface="org.springframework.batch.core.listener.StepExecutionListener"
    default-request-channel="stepExecutionsChannel"/>

<int:logging-channel-adapter channel="stepExecutionsChannel"/>

其次，修改作业以添加步进级侦听器。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例显示了如何在 Java 中添加步进级侦听器：spring-doc.cadn.net.cn

Java 配置

public Job importPaymentsJob(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
    return new JobBuilder("importPayments", jobRepository)
        .start(new StepBuilder("step1", jobRepository)
                .chunk(200, transactionManager)
                .listener(notificationExecutionsListener())
                // ...
                .build();
              )
        .build();
}

以下示例显示了如何在 XML 中添加步进级侦听器：spring-doc.cadn.net.cn

XML 配置

<job id="importPayments">
    <step id="step1">
        <tasklet ../>
            <chunk ../>
            <listeners>
                <listener ref="notificationExecutionsListener"/>
            </listeners>
        </tasklet>
        ...
    </step>
</job>

异步处理器

异步处理器可帮助您扩展项目的处理。在异步处理器用例中，一个AsyncItemProcessor作为调度器，执行这ItemProcessor对于新线程上的项目。项目完成后，Future是传递给AsyncItemWriter待写。spring-doc.cadn.net.cn

因此，您可以通过使用异步项处理来提高性能，基本上允许您实现 fork-join 方案。这AsyncItemWriter收集结果，并在所有结果可用时立即写回块。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例演示如何配置AsyncItemProcessor在 Java 中：spring-doc.cadn.net.cn

Java 配置

@Bean
public AsyncItemProcessor processor(ItemProcessor itemProcessor, TaskExecutor taskExecutor) {
    AsyncItemProcessor asyncItemProcessor = new AsyncItemProcessor();
    asyncItemProcessor.setTaskExecutor(taskExecutor);
    asyncItemProcessor.setDelegate(itemProcessor);
    return asyncItemProcessor;
}

以下示例演示如何配置AsyncItemProcessor在 XML 中：spring-doc.cadn.net.cn

XML 配置

<bean id="processor"
    class="org.springframework.batch.integration.async.AsyncItemProcessor">
  <property name="delegate">
    <bean class="your.ItemProcessor"/>
  </property>
  <property name="taskExecutor">
    <bean class="org.springframework.core.task.SimpleAsyncTaskExecutor"/>
  </property>
</bean>

这delegate属性是指您的ItemProcessorbean 和taskExecutor属性引用TaskExecutor您选择的。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例显示如何配置AsyncItemWriter在 Java 中：spring-doc.cadn.net.cn

Java 配置

@Bean
public AsyncItemWriter writer(ItemWriter itemWriter) {
    AsyncItemWriter asyncItemWriter = new AsyncItemWriter();
    asyncItemWriter.setDelegate(itemWriter);
    return asyncItemWriter;
}

以下示例显示如何配置AsyncItemWriter在 XML 中：spring-doc.cadn.net.cn

XML 配置

<bean id="itemWriter"
    class="org.springframework.batch.integration.async.AsyncItemWriter">
  <property name="delegate">
    <bean id="itemWriter" class="your.ItemWriter"/>
  </property>
</bean>

同样，delegate属性是实际上是对你的ItemWriter豆。spring-doc.cadn.net.cn

外部化批处理执行

到目前为止讨论的集成方法提出了用例其中 Spring Integration 像外壳一样包装 Spring Batch。但是，Spring Batch 也可以在内部使用 Spring Integration。通过使用这种方法，Spring Batch 用户可以委托将项目甚至块处理到外部进程。这允许您卸载复杂的处理。Spring Batch 集成为以下内容提供专门支持：spring-doc.cadn.net.cn

远程分块spring-doc.cadn.net.cn
远程分区spring-doc.cadn.net.cn

远程分块

下图显示了使用 Spring Batch 时远程分块的一种工作方式以及 Spring Integration：spring-doc.cadn.net.cn

图 2.远程分块

更进一步，您还可以将使用ChunkMessageChannelItemWriter（由 Spring Batch Integration 提供），它发送项目并收集结果。发送后，Spring Batch 将继续读取和分组项目的过程，无需等待结果。相反，这是ChunkMessageChannelItemWriter收集结果并将它们集成回 Spring Batch 流程中。spring-doc.cadn.net.cn

使用 Spring Integration，您拥有完整的控制进程的并发性（例如，通过使用QueueChannel而不是DirectChannel).此外，通过依靠 Spring Integration 丰富的通道适配器集合（例如 JMS 和 AMQP），您可以将批处理作业的块分发到用于处理的外部系统。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

具有要远程分块的步骤的作业可能具有类似于在 Java 中遵循：spring-doc.cadn.net.cn

Java 配置

public Job chunkJob(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
     return new JobBuilder("personJob", jobRepository)
             .start(new StepBuilder("step1", jobRepository)
                     .<Person, Person>chunk(200, transactionManager)
                     .reader(itemReader())
                     .writer(itemWriter())
                     .build())
             .build();
 }

具有要远程分块的步骤的作业可能具有类似于以下 XML 格式：spring-doc.cadn.net.cn

XML 配置

<job id="personJob">
  <step id="step1">
    <tasklet>
      <chunk reader="itemReader" writer="itemWriter" commit-interval="200"/>
    </tasklet>
    ...
  </step>
</job>

这ItemReader要用于读取经理。这ItemWriter特殊ItemWriter（称为ChunkMessageChannelItemWriter），如前所述。处理器（如果有）被遗漏 Manager 配置，因为它是在辅助角色上配置的。您应该检查任何实现时的其他组件属性，例如限制等您的用例。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下 Java 配置提供了基本的管理器设置：spring-doc.cadn.net.cn

Java 配置

@Bean
public org.apache.activemq.ActiveMQConnectionFactory connectionFactory() {
    ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory();
    factory.setBrokerURL("tcp://localhost:61616");
    return factory;
}

/*
 * Configure outbound flow (requests going to workers)
 */
@Bean
public DirectChannel requests() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow outboundFlow(ActiveMQConnectionFactory connectionFactory) {
    return IntegrationFlow
            .from(requests())
            .handle(Jms.outboundAdapter(connectionFactory).destination("requests"))
            .get();
}

/*
 * Configure inbound flow (replies coming from workers)
 */
@Bean
public QueueChannel replies() {
    return new QueueChannel();
}

@Bean
public IntegrationFlow inboundFlow(ActiveMQConnectionFactory connectionFactory) {
    return IntegrationFlow
            .from(Jms.messageDrivenChannelAdapter(connectionFactory).destination("replies"))
            .channel(replies())
            .get();
}

/*
 * Configure the ChunkMessageChannelItemWriter
 */
@Bean
public ItemWriter<Integer> itemWriter() {
    MessagingTemplate messagingTemplate = new MessagingTemplate();
    messagingTemplate.setDefaultChannel(requests());
    messagingTemplate.setReceiveTimeout(2000);
    ChunkMessageChannelItemWriter<Integer> chunkMessageChannelItemWriter
            = new ChunkMessageChannelItemWriter<>();
    chunkMessageChannelItemWriter.setMessagingOperations(messagingTemplate);
    chunkMessageChannelItemWriter.setReplyChannel(replies());
    return chunkMessageChannelItemWriter;
}

以下 XML 配置提供了基本的管理器设置：spring-doc.cadn.net.cn

XML 配置

<bean id="connectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
  <property name="brokerURL" value="tcp://localhost:61616"/>
</bean>

<int-jms:outbound-channel-adapter id="jmsRequests" destination-name="requests"/>

<bean id="messagingTemplate"
    class="org.springframework.integration.core.MessagingTemplate">
  <property name="defaultChannel" ref="requests"/>
  <property name="receiveTimeout" value="2000"/>
</bean>

<bean id="itemWriter"
    class="org.springframework.batch.integration.chunk.ChunkMessageChannelItemWriter"
    scope="step">
  <property name="messagingOperations" ref="messagingTemplate"/>
  <property name="replyChannel" ref="replies"/>
</bean>

<int:channel id="replies">
  <int:queue/>
</int:channel>

<int-jms:message-driven-channel-adapter id="jmsReplies"
    destination-name="replies"
    channel="replies"/>

前面的配置为我们提供了许多 bean。我们使用 ActiveMQ 和 Spring Integration 提供的入站和出站 JMS 适配器。如显示，我们的itemWriterbean，即我们的作业步骤引用，使用ChunkMessageChannelItemWriter在配置的中间件。spring-doc.cadn.net.cn

现在我们可以继续进行工作器配置，如以下示例所示：spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例显示了 Java 中的 worker 配置：spring-doc.cadn.net.cn

Java 配置

@Bean
public org.apache.activemq.ActiveMQConnectionFactory connectionFactory() {
    ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory();
    factory.setBrokerURL("tcp://localhost:61616");
    return factory;
}

/*
 * Configure inbound flow (requests coming from the manager)
 */
@Bean
public DirectChannel requests() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow inboundFlow(ActiveMQConnectionFactory connectionFactory) {
    return IntegrationFlow
            .from(Jms.messageDrivenChannelAdapter(connectionFactory).destination("requests"))
            .channel(requests())
            .get();
}

/*
 * Configure outbound flow (replies going to the manager)
 */
@Bean
public DirectChannel replies() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow outboundFlow(ActiveMQConnectionFactory connectionFactory) {
    return IntegrationFlow
            .from(replies())
            .handle(Jms.outboundAdapter(connectionFactory).destination("replies"))
            .get();
}

/*
 * Configure the ChunkProcessorChunkHandler
 */
@Bean
@ServiceActivator(inputChannel = "requests", outputChannel = "replies")
public ChunkProcessorChunkHandler<Integer> chunkProcessorChunkHandler() {
    ChunkProcessor<Integer> chunkProcessor
            = new SimpleChunkProcessor<>(itemProcessor(), itemWriter());
    ChunkProcessorChunkHandler<Integer> chunkProcessorChunkHandler
            = new ChunkProcessorChunkHandler<>();
    chunkProcessorChunkHandler.setChunkProcessor(chunkProcessor);
    return chunkProcessorChunkHandler;
}

以下示例显示了 XML 中的工作程序配置：spring-doc.cadn.net.cn

XML 配置

<bean id="connectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
  <property name="brokerURL" value="tcp://localhost:61616"/>
</bean>

<int:channel id="requests"/>
<int:channel id="replies"/>

<int-jms:message-driven-channel-adapter id="incomingRequests"
    destination-name="requests"
    channel="requests"/>

<int-jms:outbound-channel-adapter id="outgoingReplies"
    destination-name="replies"
    channel="replies">
</int-jms:outbound-channel-adapter>

<int:service-activator id="serviceActivator"
    input-channel="requests"
    output-channel="replies"
    ref="chunkProcessorChunkHandler"
    method="handleChunk"/>

<bean id="chunkProcessorChunkHandler"
    class="org.springframework.batch.integration.chunk.ChunkProcessorChunkHandler">
  <property name="chunkProcessor">
    <bean class="org.springframework.batch.core.step.item.SimpleChunkProcessor">
      <property name="itemWriter">
        <bean class="io.spring.sbi.PersonItemWriter"/>
      </property>
      <property name="itemProcessor">
        <bean class="io.spring.sbi.PersonItemProcessor"/>
      </property>
    </bean>
  </property>
</bean>

这些配置项中的大多数应该看起来很熟悉管理器配置。工人不需要访问春季批次JobRepository也不到实际的作业配置文件。感兴趣的主要豆子是chunkProcessorChunkHandler.这chunkProcessor属性ChunkProcessorChunkHandler需要一个配置SimpleChunkProcessor，您可以在此处提供对ItemWriter（并且，可选地，您的ItemProcessor）将在工作程序上运行当它从管理器接收块时。spring-doc.cadn.net.cn

有关更多信息，请参阅“可伸缩性”一章中有关远程分块的部分。spring-doc.cadn.net.cn

从 4.1 版本开始，Spring Batch Integration 引入了@EnableBatchIntegration注释，可用于简化远程分块设置。此注释提供您可以在应用程序上下文中自动连接两个 bean：spring-doc.cadn.net.cn

RemoteChunkingManagerStepBuilderFactory：配置管理器步骤spring-doc.cadn.net.cn
RemoteChunkingWorkerBuilder：配置远程工作人员集成流spring-doc.cadn.net.cn

这些 API 负责配置许多组件，如下图所示：spring-doc.cadn.net.cn

图 3.远程分块配置

在管理器端，RemoteChunkingManagerStepBuilderFactory允许您通过声明以下内容来配置管理器步骤：spring-doc.cadn.net.cn

用于读取物料并将其发送给工作人员的物料读取器spring-doc.cadn.net.cn
向工作线程发送请求的输出通道（“传出请求”）。spring-doc.cadn.net.cn
接收工作人员回复的输入通道（“传入回复”）spring-doc.cadn.net.cn

无需显式配置ChunkMessageChannelItemWriter和MessagingTemplate. （如果找到这样做的原因，您仍然可以显式配置它们）。spring-doc.cadn.net.cn

在工作程序端，RemoteChunkingWorkerBuilder允许您将辅助角色配置为：spring-doc.cadn.net.cn

监听管理器在输入通道上发送的请求（“传入请求”）spring-doc.cadn.net.cn
调用handleChunk方法ChunkProcessorChunkHandler对于每个请求与配置的ItemProcessor和ItemWriterspring-doc.cadn.net.cn
在输出通道上向经理发送回复（“传出回复”）。spring-doc.cadn.net.cn

您无需显式配置SimpleChunkProcessor和ChunkProcessorChunkHandler.（如果发现这样做的理由）。spring-doc.cadn.net.cn

以下示例演示如何使用这些 API：spring-doc.cadn.net.cn

@EnableBatchIntegration
@EnableBatchProcessing
public class RemoteChunkingJobConfiguration {

    @Configuration
    public static class ManagerConfiguration {

        @Autowired
        private RemoteChunkingManagerStepBuilderFactory managerStepBuilderFactory;

        @Bean
        public TaskletStep managerStep() {
            return this.managerStepBuilderFactory.get("managerStep")
                       .chunk(100)
                       .reader(itemReader())
                       .outputChannel(requests()) // requests sent to workers
                       .inputChannel(replies())   // replies received from workers
                       .build();
        }

        // Middleware beans setup omitted

    }

    @Configuration
    public static class WorkerConfiguration {

        @Autowired
        private RemoteChunkingWorkerBuilder workerBuilder;

        @Bean
        public IntegrationFlow workerFlow() {
            return this.workerBuilder
                       .itemProcessor(itemProcessor())
                       .itemWriter(itemWriter())
                       .inputChannel(requests()) // requests received from the manager
                       .outputChannel(replies()) // replies sent to the manager
                       .build();
        }

        // Middleware beans setup omitted

    }

}

您可以在此处找到远程分块作业的完整示例。spring-doc.cadn.net.cn

远程分区

下图显示了典型的远程分区情况：spring-doc.cadn.net.cn

图 4.远程分区

另一方面，远程分区在以下情况下很有用不是项目的处理，而是关联的 I/O 导致瓶颈。通过远程分区，您可以发送工作到执行完整 Spring Batch 的 worker 步骤。因此，每个工人都有自己的ItemReader,ItemProcessor和ItemWriter.为此，Spring Batch 集成提供了MessageChannelPartitionHandler.spring-doc.cadn.net.cn

这种实现PartitionHandler接口用途MessageChannelinstances 设置为向远程工作人员发送指令并接收他们的回复。这提供了一个很好的传输抽象（例如 JMS 和 AMQP）用于与远程工作人员通信。spring-doc.cadn.net.cn

“可伸缩性”一章中涉及远程分区的部分概述了概念和配置远程分区所需的组件，并显示使用默认值的示例TaskExecutorPartitionHandler分区在单独的本地执行线程中。用于远程分区对于多个 JVM，需要两个额外的组件：spring-doc.cadn.net.cn

远程结构或网格环境spring-doc.cadn.net.cn
一个PartitionHandler支持所需远程结构或网格环境spring-doc.cadn.net.cn

与远程分块类似，您可以使用 JMS 作为“远程结构”。在这种情况下，使用一个MessageChannelPartitionHandler实例作为PartitionHandler实现如前所述。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例假设现有的分区作业，并重点关注MessageChannelPartitionHandler和 Java 中的 JMS 配置：spring-doc.cadn.net.cn

Java 配置

/*
 * Configuration of the manager side
 */
@Bean
public PartitionHandler partitionHandler() {
    MessageChannelPartitionHandler partitionHandler = new MessageChannelPartitionHandler();
    partitionHandler.setStepName("step1");
    partitionHandler.setGridSize(3);
    partitionHandler.setReplyChannel(outboundReplies());
    MessagingTemplate template = new MessagingTemplate();
    template.setDefaultChannel(outboundRequests());
    template.setReceiveTimeout(100000);
    partitionHandler.setMessagingOperations(template);
    return partitionHandler;
}

@Bean
public QueueChannel outboundReplies() {
    return new QueueChannel();
}

@Bean
public DirectChannel outboundRequests() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow outboundJmsRequests() {
    return IntegrationFlow.from("outboundRequests")
            .handle(Jms.outboundGateway(connectionFactory())
                    .requestDestination("requestsQueue"))
            .get();
}

@Bean
@ServiceActivator(inputChannel = "inboundStaging")
public AggregatorFactoryBean partitioningMessageHandler() throws Exception {
    AggregatorFactoryBean aggregatorFactoryBean = new AggregatorFactoryBean();
    aggregatorFactoryBean.setProcessorBean(partitionHandler());
    aggregatorFactoryBean.setOutputChannel(outboundReplies());
    // configure other propeties of the aggregatorFactoryBean
    return aggregatorFactoryBean;
}

@Bean
public DirectChannel inboundStaging() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow inboundJmsStaging() {
    return IntegrationFlow
            .from(Jms.messageDrivenChannelAdapter(connectionFactory())
                    .configureListenerContainer(c -> c.subscriptionDurable(false))
                    .destination("stagingQueue"))
            .channel(inboundStaging())
            .get();
}

/*
 * Configuration of the worker side
 */
@Bean
public StepExecutionRequestHandler stepExecutionRequestHandler() {
    StepExecutionRequestHandler stepExecutionRequestHandler = new StepExecutionRequestHandler();
    stepExecutionRequestHandler.setJobExplorer(jobExplorer);
    stepExecutionRequestHandler.setStepLocator(stepLocator());
    return stepExecutionRequestHandler;
}

@Bean
@ServiceActivator(inputChannel = "inboundRequests", outputChannel = "outboundStaging")
public StepExecutionRequestHandler serviceActivator() throws Exception {
    return stepExecutionRequestHandler();
}

@Bean
public DirectChannel inboundRequests() {
    return new DirectChannel();
}

public IntegrationFlow inboundJmsRequests() {
    return IntegrationFlow
            .from(Jms.messageDrivenChannelAdapter(connectionFactory())
                    .configureListenerContainer(c -> c.subscriptionDurable(false))
                    .destination("requestsQueue"))
            .channel(inboundRequests())
            .get();
}

@Bean
public DirectChannel outboundStaging() {
    return new DirectChannel();
}

@Bean
public IntegrationFlow outboundJmsStaging() {
    return IntegrationFlow.from("outboundStaging")
            .handle(Jms.outboundGateway(connectionFactory())
                    .requestDestination("stagingQueue"))
            .get();
}

以下示例假设现有的分区作业，并重点关注MessageChannelPartitionHandler和 XML 中的 JMS 配置：spring-doc.cadn.net.cn

XML 配置

<bean id="partitionHandler"
   class="org.springframework.batch.integration.partition.MessageChannelPartitionHandler">
  <property name="stepName" value="step1"/>
  <property name="gridSize" value="3"/>
  <property name="replyChannel" ref="outbound-replies"/>
  <property name="messagingOperations">
    <bean class="org.springframework.integration.core.MessagingTemplate">
      <property name="defaultChannel" ref="outbound-requests"/>
      <property name="receiveTimeout" value="100000"/>
    </bean>
  </property>
</bean>

<int:channel id="outbound-requests"/>
<int-jms:outbound-channel-adapter destination="requestsQueue"
    channel="outbound-requests"/>

<int:channel id="inbound-requests"/>
<int-jms:message-driven-channel-adapter destination="requestsQueue"
    channel="inbound-requests"/>

<bean id="stepExecutionRequestHandler"
    class="org.springframework.batch.integration.partition.StepExecutionRequestHandler">
  <property name="jobExplorer" ref="jobExplorer"/>
  <property name="stepLocator" ref="stepLocator"/>
</bean>

<int:service-activator ref="stepExecutionRequestHandler" input-channel="inbound-requests"
    output-channel="outbound-staging"/>

<int:channel id="outbound-staging"/>
<int-jms:outbound-channel-adapter destination="stagingQueue"
    channel="outbound-staging"/>

<int:channel id="inbound-staging"/>
<int-jms:message-driven-channel-adapter destination="stagingQueue"
    channel="inbound-staging"/>

<int:aggregator ref="partitionHandler" input-channel="inbound-staging"
    output-channel="outbound-replies"/>

<int:channel id="outbound-replies">
  <int:queue/>
</int:channel>

<bean id="stepLocator"
    class="org.springframework.batch.integration.partition.BeanFactoryStepLocator" />

您还必须确保分区handler属性映射到partitionHandler豆。spring-doc.cadn.net.cn

Javaspring-doc.cadn.net.cn
XMLspring-doc.cadn.net.cn

以下示例映射分区handler属性添加到partitionHandler在 Java：spring-doc.cadn.net.cn

Java 配置

	public Job personJob(JobRepository jobRepository) {
		return new JobBuilder("personJob", jobRepository)
				.start(new StepBuilder("step1.manager", jobRepository)
						.partitioner("step1.worker", partitioner())
						.partitionHandler(partitionHandler())
						.build())
				.build();
	}

以下示例映射分区handler属性添加到partitionHandler在 XML：spring-doc.cadn.net.cn

XML 配置

<job id="personJob">
  <step id="step1.manager">
    <partition partitioner="partitioner" handler="partitionHandler"/>
    ...
  </step>
</job>

您可以在此处找到远程分区作业的完整示例。spring-doc.cadn.net.cn

您可以使用@EnableBatchIntegration注释以简化远程分区设置。此注解提供了两个对远程分区有用的 bean：spring-doc.cadn.net.cn

RemotePartitioningManagerStepBuilderFactory：配置管理器步骤spring-doc.cadn.net.cn
RemotePartitioningWorkerStepBuilderFactory：配置工作器步骤spring-doc.cadn.net.cn

这些 API 负责配置许多组件，如下图所示：spring-doc.cadn.net.cn

图 5.远程分区配置（使用作业存储库轮询）

图6.远程分区配置（带回复聚合）

在管理器端，RemotePartitioningManagerStepBuilderFactory允许您通过声明以下内容来配置管理器步骤：spring-doc.cadn.net.cn

这Partitioner用于对数据进行分区spring-doc.cadn.net.cn
用于向工作线程发送请求的输出通道（“传出请求”）。spring-doc.cadn.net.cn
用于接收来自辅助角色的回复的输入通道（“传入回复”）（配置回复聚合时）spring-doc.cadn.net.cn
轮询间隔和超时参数（配置作业存储库轮询时）spring-doc.cadn.net.cn

您无需显式配置MessageChannelPartitionHandler和MessagingTemplate. （如果您找到这样做的原因，您仍然可以显式配置它们）。spring-doc.cadn.net.cn

在工作程序端，RemotePartitioningWorkerStepBuilderFactory允许您将辅助角色配置为：spring-doc.cadn.net.cn

监听管理器在输入通道上发送的请求（“传入请求”）spring-doc.cadn.net.cn
调用handle方法StepExecutionRequestHandler对于每个请求spring-doc.cadn.net.cn
在输出通道上向经理发送回复（“传出回复”）。spring-doc.cadn.net.cn

您无需显式配置StepExecutionRequestHandler. （如果找到这样做的原因，可以显式配置它）。spring-doc.cadn.net.cn

以下示例演示如何使用这些 API：spring-doc.cadn.net.cn

@Configuration
@EnableBatchProcessing
@EnableBatchIntegration
public class RemotePartitioningJobConfiguration {

    @Configuration
    public static class ManagerConfiguration {

        @Autowired
        private RemotePartitioningManagerStepBuilderFactory managerStepBuilderFactory;

        @Bean
        public Step managerStep() {
                 return this.managerStepBuilderFactory
                    .get("managerStep")
                    .partitioner("workerStep", partitioner())
                    .gridSize(10)
                    .outputChannel(outgoingRequestsToWorkers())
                    .inputChannel(incomingRepliesFromWorkers())
                    .build();
        }

        // Middleware beans setup omitted

    }

    @Configuration
    public static class WorkerConfiguration {

        @Autowired
        private RemotePartitioningWorkerStepBuilderFactory workerStepBuilderFactory;

        @Bean
        public Step workerStep() {
                 return this.workerStepBuilderFactory
                    .get("workerStep")
                    .inputChannel(incomingRequestsFromManager())
                    .outputChannel(outgoingRepliesToManager())
                    .chunk(100)
                    .reader(itemReader())
                    .processor(itemProcessor())
                    .writer(itemWriter())
                    .build();
        }

        // Middleware beans setup omitted

    }

}