org.springframework.batch.test

Class JobLauncherTestUtils

java.lang.Object

org.springframework.batch.test.JobLauncherTestUtils

public class JobLauncherTestUtils
extends java.lang.Object

Utility class for testing batch jobs. It provides methods for launching an entire AbstractJob, allowing for end to end testing of individual steps, without having to run every step in the job. Any test classes using this utility can set up an instance in the ApplicationContext as part of the Spring test framework.

This class also provides the ability to run Steps from a FlowJob or SimpleJob individually. By launching Steps within a Job on their own, end to end testing of individual steps can be performed without having to run every step in the job.

It should be noted that using any of the methods that don't contain JobParameters in their signature, will result in one being created with a random number of type long as a parameter. This will ensure restartability when no parameters are provided.

Since:

2.1

Author:

Lucas Ward, Dan Garrette, Dave Syer, Mahmoud Ben Hassine

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger Logger

Constructor Summary

Constructors

Constructor and Description
JobLauncherTestUtils()

Method Summary

Modifier and Type	Method and Description
Job	getJob()
JobLauncher	getJobLauncher()
JobRepository	getJobRepository()
protected StepRunner	getStepRunner() Convenient method for subclasses to grab a StepRunner for running steps by name.
JobParameters	getUniqueJobParameters()
JobParametersBuilder	getUniqueJobParametersBuilder()
JobExecution	launchJob() Launch the entire job, including all steps.
JobExecution	launchJob(JobParameters jobParameters) Launch the entire job, including all steps
JobExecution	launchStep(java.lang.String stepName) Launch just the specified step in the job.
JobExecution	launchStep(java.lang.String stepName, ExecutionContext jobExecutionContext) Launch just the specified step in the job.
JobExecution	launchStep(java.lang.String stepName, JobParameters jobParameters) Launch just the specified step in the job.
JobExecution	launchStep(java.lang.String stepName, JobParameters jobParameters, ExecutionContext jobExecutionContext) Launch just the specified step in the job.
void	setJob(Job job) The Job instance that can be manipulated (e.g.
void	setJobLauncher(JobLauncher jobLauncher) A JobLauncher instance that can be used to launch jobs.
void	setJobRepository(JobRepository jobRepository) The JobRepository to use for creating new JobExecution instances.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

Logger

Constructor Detail

JobLauncherTestUtils

public JobLauncherTestUtils()

Method Detail

setJob

@Autowired
public void setJob(Job job)

The Job instance that can be manipulated (e.g. launched) in this utility.

Parameters:

job - the AbstractJob to use

setJobRepository

@Autowired
public void setJobRepository(JobRepository jobRepository)

The JobRepository to use for creating new JobExecution instances.

Parameters:

jobRepository - a JobRepository

getJobRepository

public JobRepository getJobRepository()

Returns:

the job repository

getJob

public Job getJob()

Returns:

the job

setJobLauncher

@Autowired
public void setJobLauncher(JobLauncher jobLauncher)

A JobLauncher instance that can be used to launch jobs.

Parameters:

jobLauncher - a job launcher

getJobLauncher

public JobLauncher getJobLauncher()

Returns:

the job launcher

launchJob

public JobExecution launchJob()
                       throws java.lang.Exception

Launch the entire job, including all steps.

Returns:

JobExecution, so that the test can validate the exit status

Throws:

java.lang.Exception - thrown if error occurs launching the job.

launchJob

public JobExecution launchJob(JobParameters jobParameters)
                       throws java.lang.Exception

Launch the entire job, including all steps

Parameters:

jobParameters - instance of JobParameters.

Returns:

JobExecution, so that the test can validate the exit status

Throws:

java.lang.Exception - thrown if error occurs launching the job.

getUniqueJobParameters

public JobParameters getUniqueJobParameters()

Returns:

a new JobParameters object containing only a parameter with a random number of type long, to ensure that the job instance will be unique.

getUniqueJobParametersBuilder

public JobParametersBuilder getUniqueJobParametersBuilder()

Returns:

a new JobParametersBuilder object containing only a parameter with a random number of type long, to ensure that the job instance will be unique.

getStepRunner

protected StepRunner getStepRunner()

Convenient method for subclasses to grab a StepRunner for running steps by name.

Returns:

a StepRunner

launchStep

public JobExecution launchStep(java.lang.String stepName)

Launch just the specified step in the job. A unique set of JobParameters will automatically be generated. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

stepName - The name of the step to launch

Returns:

JobExecution

launchStep

public JobExecution launchStep(java.lang.String stepName,
                               ExecutionContext jobExecutionContext)

Launch just the specified step in the job. A unique set of JobParameters will automatically be generated. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

stepName - The name of the step to launch

jobExecutionContext - An ExecutionContext whose values will be loaded into the Job ExecutionContext prior to launching the step.

Returns:

JobExecution

launchStep

public JobExecution launchStep(java.lang.String stepName,
                               JobParameters jobParameters)

Launch just the specified step in the job. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

stepName - The name of the step to launch

jobParameters - The JobParameters to use during the launch

Returns:

JobExecution

launchStep

public JobExecution launchStep(java.lang.String stepName,
                               JobParameters jobParameters,
                               @Nullable
                               ExecutionContext jobExecutionContext)

Launch just the specified step in the job. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

stepName - The name of the step to launch

jobParameters - The JobParameters to use during the launch

jobExecutionContext - An ExecutionContext whose values will be loaded into the Job ExecutionContext prior to launching the step.

Returns:

JobExecution