Skip to content

Spring Batch 6.0 Migration Guide

Jump to bottom
Mahmoud Ben Hassine edited this page Sep 18, 2025 · 27 revisions

❗ This document is still in progress. We will update it regularly for each milestone version until the GA is released ❗

This document is meant to help you migrate your applications to Spring Batch 6.0. Spring Batch 6 does not change the minimum required Java version which remains Java 17+.

Major changes

Dependencies upgrade

Spring Batch 6 upgrades its Spring dependencies to the following versions:

  • Spring Framework 7
  • Spring Integration 7
  • Spring Data 4
  • Spring AMQP 4
  • Spring for Apache Kafka 4
  • Micrometer 1.16

Infrastructure beans configuration

Changes related to @EnableBatchProcessing

Before v6, the @EnableBatchProcessing annotation was tied to a JDBC-based infrastructure. This is not the case anymore. Two new annotations have been introduced to configure the underlying job repository: @EnableJdbcJobRepository and EnableMongoJobRepository.

Starting from v6, @EnableBatchProcessing allows you to configure common attributes for the batch infrastructure, while store-specific attributes can be specified with the new dedicated annotations. Here is an example to migrate a JDBC configuration from v5 to v6:

// v5
@EnableBatchProcessing(dataSourceRef = "batchDataSource", taskExecutorRef = "batchTaskExecutor")
class MyJobConfiguration {

	@Bean
	public Job job(JobRepository jobRepository) {
		return new JobBuilder("job", jobRepository)
                    // job flow omitted
                    .build();
	}
}
// v6
@EnableBatchProcessing(taskExecutorRef = "batchTaskExecutor")
@EnableJdbcJobRepository(dataSourceRef = "batchDataSource")
class MyJobConfiguration {

	@Bean
	public Job job(JobRepository jobRepository) {
		return new JobBuilder("job", jobRepository)
                    // job flow omitted
                    .build();
	}
}

Changes related to DefaultBatchConfiguration

Similar to the annotation-based approach, the programmatic model based on DefaultBatchConfiguration has been updated by introducing two new configuration classes to define store-specific attributes: JdbcDefaultBatchConfiguration and MongoDefaultBatchConfiguration.

Here is an example to migrate a JDBC configuration from v5 to v6:

// v5
class MyJobConfiguration extends DefaultBatchConfiguration  {

	@Bean
	public Job job(JobRepository jobRepository) {
		return new JobBuilder("job", jobRepository)
                    // job flow omitted
                    .build();
	}

        @Override
	protected DataSource getDataSource() {
	        return new MyBatchDataSource();
	}
}
// v6
class MyJobConfiguration extends JdbcDefaultBatchConfiguration  {

	@Bean
	public Job job(JobRepository jobRepository) {
		return new JobBuilder("job", jobRepository)
                    // job flow omitted
                    .build();
	}

        @Override
	protected DataSource getDataSource() {
	        return new MyBatchDataSource();
	}
}

Changes related to the default batch configuration

  • The DefaultBatchConfiguration now configures a "resourceless" batch infrastructure (ie a ResourcelessJobRepository and a ResourcelessTransactionManager). This is to remove the need for an additional dependency to an in-memory database for those who do not need batch meta-data.
  • The configuration of a JobExplorer bean has been removed. This is due to the fact that JobRepository now extends JobExplorer and there is no need for a JobExplorer bean anymore, which is now deprecated (See "Deprecated APIs" section).
  • The configuration of a JobLauncher has been replaced with a JobOperator. This is due to the fact that JobOperator now extends JobLauncher and there is no need for a JobLauncher bean anymore, which is now deprecated (See "Deprecated APIs" section).
  • The configuration of a JobRegistrySmartInitializingSingleton bean has been removed. The MapJobRegistry is now optional as well , and is smart enough to populate itself with jobs from the application context on startup. JobRegistrySmartInitializingSingleton is now deprecated (See "Deprecated APIs" section).
  • The configuration of a transaction manager in JobOperatorFactoryBean is now optional
  • The configuration of a transaction manager in tasklet and chunk-oriented steps is now optional

Deprecated APIs

The following APIs have been deprecated in version 6.0:

Deprecated classes and interfaces

  • FaultTolerantStepBuilder
  • SimpleStepBuilder
  • BatchListenerFactoryHelper
  • FaultTolerantStepFactoryBean
  • SimpleStepFactoryBean
  • BatchRetryTemplate
  • ChunkMonitor
  • ChunkOrientedTasklet
  • ChunkProcessor
  • ChunkProvider
  • DefaultItemFailureHandler
  • FaultTolerantChunkProcessor
  • FaultTolerantChunkProvider
  • KeyGenerator
  • SimpleChunkProcessor
  • SimpleChunkProvider
  • SimpleRetryExceptionHandler
  • LimitCheckingItemSkipPolicy
  • org.springframework.batch.core.repository.support.JobRepositoryFactoryBean: renamed to JdbcJobRepositoryFactoryBean
  • org.springframework.batch.core.repository.explore.support.JobExplorerFactoryBean: renamed to JdbcJobExplorerFactoryBean
  • org.springframework.batch.core.configuration.annotation.AutomaticJobRegistrarBeanPostProcessor
  • org.springframework.batch.core.configuration.support.AbstractApplicationContextFactory
  • org.springframework.batch.core.configuration.support.ApplicationContextFactory
  • org.springframework.batch.core.configuration.support.ApplicationContextJobFactory
  • org.springframework.batch.core.configuration.support.AutomaticJobRegistrar
  • org.springframework.batch.core.configuration.support.ClasspathXmlApplicationContextsFactoryBean
  • org.springframework.batch.core.configuration.support.GenericApplicationContextFactory
  • org.springframework.batch.core.configuration.support.JobFactoryRegistrationListener
  • org.springframework.batch.core.configuration.support.ReferenceJobFactory
  • org.springframework.batch.core.configuration.JobFactory
  • org.springframework.batch.core.configuration.JobLocator
  • org.springframework.batch.core.configuration.ListableJobLocator
  • org.springframework.batch.core.configuration.support.JobLoader
  • org.springframework.batch.core.configuration.support.DefaultJobLoader
  • org.springframework.batch.core.launch.support.CommandLineJobRunner
  • org.springframework.batch.core.launch.support.JvmSystemExiter
  • org.springframework.batch.core.launch.support.RuntimeExceptionTranslator
  • org.springframework.batch.core.launch.support.SystemExiter
  • org.springframework.batch.core.launch.support.TaskExecutorJobLauncher
  • org.springframework.batch.core.launch.JobLauncher
  • org.springframework.batch.core.repository.explore.support.AbstractJobExplorerFactoryBean
  • org.springframework.batch.core.repository.explore.support.JdbcJobExplorerFactoryBean
  • org.springframework.batch.core.repository.explore.support.JobExplorerFactoryBean
  • org.springframework.batch.core.repository.explore.support.MongoJobExplorerFactoryBean
  • org.springframework.batch.core.repository.explore.support.SimpleJobExplorer
  • org.springframework.batch.core.repository.explore.JobExplorer
  • org.springframework.batch.core.resource.StepExecutionSimpleCompletionPolicy
  • org.springframework.batch.support.PropertiesConverter
  • org.springframework.batch.test.StepRunner
  • org.springframework.batch.item.SkipWrapper

Deprecated methods

  • StepBuilder#chunk(int chunkSize, PlatformTransactionManager transactionManager)
  • StepBuilder#chunk(CompletionPolicy completionPolicy, PlatformTransactionManager transactionManager)
  • StoppableTasklet#stop()
  • JobExplorer#isJobInstanceExists(String jobName, JobParameters jobParameters)
  • JobExplorer#findJobExecutions(JobInstance jobInstance)
  • JobExplorer#findJobInstancesByJobName(String jobName, int start, int count)
  • JobExplorer#findJobInstancesByName(String jobName, int start, int count)
  • SimpleJobExplorer#findJobInstancesByJobName(String jobName, int start, int count)
  • JobInstanceDao#findJobInstancesByName(String jobName, final int start, final int count)
  • JdbcJobInstanceDao#findJobInstancesByName(String jobName, final int start, final int count)
  • MongoJobInstanceDao#findJobInstancesByName(String jobName, final int start, final int count)
  • JobOperator#getExecutions(long instanceId)
  • JobOperator#getJobInstances(String jobName, int start, int count)
  • JobOperator#getJobInstance(String jobName, JobParameters jobParameters)
  • JobOperator#getRunningExecutions(String jobName)
  • JobOperator#getParameters(long executionId)
  • JobOperator#getSummary(long executionId)
  • JobOperator#getStepExecutionSummaries(long executionId)
  • JobOperator#start(String jobName, Properties parameters)
  • JobOperator#getJobNames
  • JobOperator#restart(long executionId)
  • JobOperator#startNextInstance(String jobName)
  • JobOperator#stop(long executionId)
  • JobOperator#abandon(long jobExecutionId)
  • SimpleJobOperator#start(String jobName, Properties parameters)
  • SimpleJobOperator#getJobNames
  • SimpleJobOperator#restart(long executionId)
  • SimpleJobOperator#startNextInstance(String jobName)
  • SimpleJobOperator#stop(long executionId)
  • SimpleJobOperator#abandon(long jobExecutionId)
  • SimpleJobOperator#getExecutions(long instanceId)
  • SimpleJobOperator#getJobInstances(String jobName, int start, int count)
  • SimpleJobOperator#getJobInstance(String jobName, JobParameters jobParameters)
  • SimpleJobOperator#getRunningExecutions(String jobName)
  • SimpleJobOperator#getParameters(long executionId)
  • SimpleJobOperator#getSummary(long executionId)
  • SimpleJobOperator#getStepExecutionSummaries(long executionId)
  • SimpleJobOperator#setJobParametersConverter(JobParametersConverter jobParametersConverter)
  • DefaultBatchConfiguration#getJobParametersConverter()
  • EnableBatchProcessing#modular
  • Chunk#Chunk(List<? extends W> items, List<SkipWrapper<W>> skips)
  • Chunk#getSkips()
  • Chunk#getErrors()
  • Chunk#skip(Exception e)
  • Chunk#getSkipsSize()
  • Chunk#isEnd()
  • Chunk#setEnd()
  • Chunk#isBusy()
  • Chunk#setBusy(boolean)
  • Chunk#clearSkips()
  • Chunk#getUserData()
  • Chunk#setUserData(Object)
  • Chunk#chunk(CompletionPolicy, PlatformTransactionManager)
  • ChunkListener#beforeChunk(ChunkContext)
  • ChunkListener#afterChunk(ChunkContext)
  • ChunkListener#afterChunkError(ChunkContext)
  • CompositeChunkListener#beforeChunk(ChunkContext)
  • CompositeChunkListener#afterChunk(ChunkContext)
  • CompositeChunkListener#afterChunkError(ChunkContext)

Please refer to the Javadoc of each API for more details about the suggested replacement.

Moved APIs

  • All APIs under org.springframework.batch.core.explore package have been moved under org.springframework.batch.core.repository.explore
  • JdbcExecutionContextDao, JdbcJobExecutionDao, JdbcJobInstanceDao and JdbcStepExecutionDao have been moved from org.springframework.batch.core.repository.dao to org.springframework.batch.core.repository.dao.jdbc
  • MongoExecutionContextDao, MongoJobExecutionDao, MongoJobInstanceDao, MongoStepExecutionDao and MongoSequenceIncrementer have been moved from org.springframework.batch.core.repository.dao to org.springframework.batch.core.repository.dao.mongo
  • Partitioner, PartitionNameProvider, PartitionStep and StepExecutionAggregator have been moved from org.springframework.batch.core.partition.support to org.springframework.batch.core.partition
  • ChunkListener, ItemProcessListener, ItemReadListener, ItemWriteListener, JobExecutionListener, SkipListener, StepExecutionListener and StepListener have been moved from org.springframework.batch.core to org.springframework.batch.core.listener
  • Job, JobExecution, JobExecutionException, JobInstance, JobInterruptedException, JobKeyGenerator, DefaultJobKeyGenerator, StartLimitExceededException and UnexpectedJobExecutionException have been moved from org.springframework.batch.core to org.springframework.batch.core.job
  • CompositeJobParametersValidator, DefaultJobParametersValidator, JobParameter, JobParameters, JobParametersBuilder, JobParametersIncrementer, JobParametersInvalidException and JobParametersValidator have been moved from org.springframework.batch.core to org.springframework.batch.core.job.parameters
  • Step, StepContribution and StepExecution have been moved from org.springframework.batch.core to org.springframework.batch.core.step

Removed APIs

The following APIs were deprecated in previous versions and have been removed in this release:

  • method org.springframework.batch.core.configuration.support.DefaultBatchConfiguration#getLobHandler
  • Attribute lobHandlerRef in @EnableBatchProcessing
  • Attribute lob-handler in XML element step
  • method org.springframework.batch.core.repository.dao.JdbcExecutionContextDao#setLobHandler
  • method org.springframework.batch.core.repository.dao.JdbcJobInstanceDao#setJobIncrementer
  • method org.springframework.batch.core.repository.support.JobRepositoryFactoryBean#setLobHandler
  • method org.springframework.batch.core.configuration.support.DefaultBatchConfiguration#jobLauncher
  • method org.springframework.batch.core.configuration.support.DefaultBatchConfiguration#jobOperator
  • method org.springframework.batch.core.configuration.support.DefaultBatchConfiguration#jobRegistryBeanPostProcessor
  • class org.springframework.batch.core.configuration.support.JobRegistryBeanPostProcessor
  • method org.springframework.batch.core.explore.support.JobExplorerFactoryBean#setLobHandler
  • constructor org.springframework.batch.core.job.builder.JobBuilder#JobBuilder(String name)
  • class org.springframework.batch.core.listener.ChunkListenerSupport
  • class org.springframework.batch.core.listener.JobExecutionListenerSupport
  • class org.springframework.batch.core.listener.SkipListenerSupport
  • class org.springframework.batch.core.listener.StepExecutionListenerSupport
  • method org.springframework.batch.core.step.builder.AbstractTaskletStepBuilder#throttleLimit
  • constructor org.springframework.batch.core.step.builder.StepBuilder#StepBuilder(String name)
  • method org.springframework.batch.core.step.builder.TaskletStepBuilder#tasklet(Tasklet tasklet)
  • method org.springframework.batch.core.step.factory.SimpleStepFactoryBean#setThrottleLimit
  • classes org.springframework.batch.item.data.MongoItemReader and org.springframework.batch.item.data.builder.MongoItemReaderBuilder
  • method org.springframework.batch.item.data.MongoItemWriter#setDelete
  • method org.springframework.batch.item.data.builder.MongoItemWriterBuilder#delete(boolean delete)
  • class org.springframework.batch.item.data.Neo4jItemReader and org.springframework.batch.item.data.Neo4jItemWriter
  • method org.springframework.batch.item.database.support.SqlPagingQueryUtils#generateLimitGroupedSqlQuery(AbstractSqlPagingQueryProvider provider, boolean remainingPageQuery, String limitClause)
  • class org.springframework.batch.item.database.support.SqlWindowingPagingQueryProvider
  • class org.springframework.batch.repeat.listener.RepeatListenerSupport
  • method org.springframework.batch.repeat.support.TaskExecutorRepeatTemplate#setThrottleLimit
  • class org.springframework.batch.support.SystemPropertyInitializer
  • constructor org.springframework.batch.integration.chunk.RemoteChunkingManagerStepBuilder#RemoteChunkingManagerStepBuilder(String stepName)
  • method org.springframework.batch.integration.chunk.RemoteChunkingManagerStepBuilder#RemoteChunkingManagerStepBuilder repository(JobRepository jobRepository)
  • constructor org.springframework.batch.integration.partition.RemotePartitioningManagerStepBuilder#RemotePartitioningManagerStepBuilder(String stepName)
  • constructor org.springframework.batch.integration.partition.RemotePartitioningWorkerStepBuilder#RemotePartitioningWorkerStepBuilder(String name)
  • method org.springframework.batch.integration.partition.RemotePartitioningWorkerStepBuilder#RemotePartitioningWorkerStepBuilder repository(JobRepository jobRepository)
  • method org.springframework.batch.integration.partition.RemotePartitioningWorkerStepBuilder#tasklet(Tasklet tasklet)
  • method org.springframework.batch.integration.partition.RemotePartitioningWorkerStepBuilder#chunk(CompletionPolicy completionPolicy)

Renamed APIs

  • The setter org.springframework.batch.core.step.job.JobStep#setJobLauncher(JobLauncher jobLauncher) was renamed to setJobOperator(JobOperator jobOperator) and now requires a JobOperator instead of a JobLauncher
  • The setter org.springframework.batch.core.step.builder.JobStepBuilder#launcher(JobLauncher jobLauncher) was renamed to operator(JobOperator jobOperator) and now requires a JobOperator instead of a JobLauncher
  • The attribute job-launcher of the XML element step.job in spring-batch.xsd was renamed to job-operator and now requires a JobOperator instead of a JobLauncher
  • The constructor org.springframework.batch.integration.launch.JobLaunchingGateway(JobLauncher jobLauncher) now accepts a JobOperator instead of a JobLauncher
  • org.springframework.batch.integration.launch.JobLaunchingMessageHandler(JobLauncher jobLauncher) now accepts a JobOperator instead of a JobLauncher
  • The attribute `` of the XML element job-launching-gateway in `spring-batch-integration.xsd` was renamed to `job-operator` and now requires a `JobOperator` instead of a `JobLauncher`
  • The setter org.springframework.batch.core.step.tasklet.SystemCommandTasklet#setJobExplorer(JobExplorer jobExplorer) was renamed to setJobRepository(JobRepository jobRepository) and now requires a JobRepository instead of a JobExplorer
  • The constructor org.springframework.batch.core.partition.support.RemoteStepExecutionAggregator(JobExplorer jobExplorer) now accepts a JobRepository instead of a JobExplorer
  • The setter org.springframework.batch.core.partition.support.RemoteStepExecutionAggregator#setJobExplorer(JobExplorer jobExplorer) was renamed to setJobRepository(JobRepository jobRepository) and now requires a JobRepository instead of a JobExplorer
Clone this wiki locally