Package org.springframework.batch.test

Class StepRunner

java.lang.Object

org.springframework.batch.test.StepRunner

public class StepRunner
extends Object

Utility class for executing steps. This is useful in end to end testing in order to allow for the testing of a step individually without running every Step in a job.

• launchStep(Step step): Launch the step with new parameters each time. (The current system time will be used)
• launchStep(Step step, JobParameters jobParameters): Launch the specified step with the provided JobParameters. This may be useful if your step requires a certain parameter during runtime.

It should be noted that any checked exceptions encountered while running the Step will wrapped with RuntimeException. Any checked exception thrown will be due to a framework error, not the logic of the step, and thus requiring a throws declaration in clients of this class is unnecessary.

Since:

2.0

Author:

Dan Garrette, Lucas Ward, Mahmoud Ben Hassine

See Also:

• SimpleJob

Field Summary

Fields

Modifier and Type	Field	Description
static final String	JOB_NAME	Name of the single-step job surrounding steps when tested individually
protected final org.apache.commons.logging.Log	logger	Logger

Constructor Summary

Constructors

Constructor	Description
StepRunner(JobLauncher launcher, JobRepository jobRepository)

Method Summary

Modifier and Type	Method	Description
JobExecution	launchStep(Step step)	Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME.
JobExecution	launchStep(Step step, JobParameters jobParameters)	Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME.
JobExecution	launchStep(Step step, JobParameters jobParameters, ExecutionContext jobExecutionContext)	Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME.
JobExecution	launchStep(Step step, ExecutionContext jobExecutionContext)	Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME.

Methods inherited from class java.lang.Object

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

Field Details

JOB_NAME

public static final String JOB_NAME

Name of the single-step job surrounding steps when tested individually

See Also:

• Constant Field Values

logger

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

Logger

Constructor Details

StepRunner

public StepRunner(JobLauncher launcher,
 JobRepository jobRepository)

Method Details

launchStep

public JobExecution launchStep(Step step)

Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME. A unique set of JobParameters will automatically be generated. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

step - The step to launch

Returns:

JobExecution

launchStep

public JobExecution launchStep(Step step,
 @Nullable
 ExecutionContext jobExecutionContext)

Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME. A unique set of JobParameters will automatically be generated. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

step - 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(Step step,
 JobParameters jobParameters)

Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

step - The step to launch

jobParameters - The JobParameters to use during the launch

Returns:

JobExecution

launchStep

public JobExecution launchStep(Step step,
 JobParameters jobParameters,
 @Nullable
 ExecutionContext jobExecutionContext)

Launch just the specified step in a surrounding single-step job of type SimpleJob named JOB_NAME. An IllegalStateException is thrown if there is no Step with the given name.

Parameters:

step - 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