Package org.springframework.batch.core.launch.support

Class TaskExecutorJobLauncher

java.lang.Object

org.springframework.batch.core.launch.support.SimpleJobLauncher

org.springframework.batch.core.launch.support.TaskExecutorJobLauncher

All Implemented Interfaces:

JobLauncher, org.springframework.beans.factory.InitializingBean

public class TaskExecutorJobLauncher
extends SimpleJobLauncher

Implementation of the JobLauncher interface based on a TaskExecutor. This means that the type of executor set is very important. If a SyncTaskExecutor is used, then the job will be processed within the same thread that called the launcher. Care should be taken to ensure any users of this class understand fully whether or not the implementation of TaskExecutor used will start tasks synchronously or asynchronously. The default setting uses a synchronous task executor.

There is only one required dependency of this Launcher, a JobRepository. The JobRepository is used to obtain a valid JobExecution. The Repository must be used because the provided Job could be a restart of an existing JobInstance, and only the Repository can reliably recreate it.

Since:

1.0

Author:

Lucas Ward, Dave Syer, Will Schipp, Michael Minella, Mahmoud Ben Hassine

See Also:

• JobRepository
• TaskExecutor

Field Summary

Fields inherited from class org.springframework.batch.core.launch.support.SimpleJobLauncher

logger

Constructor Summary

Constructors

Constructor	Description
TaskExecutorJobLauncher()

Method Summary

Modifier and Type	Method	Description
void	afterPropertiesSet()	Ensure the required dependencies of a JobRepository have been set.
JobExecution	run(Job job, JobParameters jobParameters)	Run the provided job with the given JobParameters.
void	setJobRepository(JobRepository jobRepository)	Set the JobRepository.
void	setTaskExecutor(org.springframework.core.task.TaskExecutor taskExecutor)	Set the TaskExecutor.

Methods inherited from class org.springframework.batch.core.launch.support.SimpleJobLauncher

setMeterRegistry

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TaskExecutorJobLauncher

public TaskExecutorJobLauncher()

Method Details

run

public JobExecution run(Job job,
 JobParameters jobParameters)
                 throws JobExecutionAlreadyRunningException,
JobRestartException,
JobInstanceAlreadyCompleteException,
JobParametersInvalidException

Description copied from class: SimpleJobLauncher

Run the provided job with the given JobParameters. The JobParameters will be used to determine if this is an execution of an existing job instance, or if a new one should be created.

Specified by:

run in interface JobLauncher

Overrides:

run in class SimpleJobLauncher

Parameters:

job - the job to be run.

jobParameters - the JobParameters for this particular execution.

Returns:

the JobExecution if it returns synchronously. If the implementation is asynchronous, the status might well be unknown.

Throws:

JobExecutionAlreadyRunningException - if the JobInstance already exists and has an execution already running.

JobRestartException - if the execution would be a re-start, but a re-start is either not allowed or not needed.

JobInstanceAlreadyCompleteException - if this instance has already completed successfully

JobParametersInvalidException - thrown if jobParameters is invalid.

setJobRepository

public void setJobRepository(JobRepository jobRepository)

Description copied from class: SimpleJobLauncher

Set the JobRepository.

Overrides:

setJobRepository in class SimpleJobLauncher

Parameters:

jobRepository - instance of JobRepository.

setTaskExecutor

public void setTaskExecutor(org.springframework.core.task.TaskExecutor taskExecutor)

Description copied from class: SimpleJobLauncher

Set the TaskExecutor. (Optional)

Overrides:

setTaskExecutor in class SimpleJobLauncher

Parameters:

taskExecutor - instance of TaskExecutor.

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Description copied from class: SimpleJobLauncher

Ensure the required dependencies of a JobRepository have been set.

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Overrides:

afterPropertiesSet in class SimpleJobLauncher

Throws:

Exception