Interface StepExecutionSplitter

All Known Implementing Classes:
SimpleStepExecutionSplitter

public interface StepExecutionSplitter
Strategy interface for generating input contexts for a partitioned step execution independent from the fabric they are going to run on.
Since:
2.0
Author:
Dave Syer, Mahmoud Ben Hassine
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    The separator used to build the name of the StepExecution of a partition from the name of the target step and the partition key, for example step1:partition0.
  • Method Summary

    Modifier and Type
    Method
    Description
    The name of the step configuration that will be executed remotely.
    split(StepExecution stepExecution, int gridSize)
    Partition the provided StepExecution into a set of parallel executable instances with the same parent JobExecution.
  • Field Details

    • STEP_NAME_SEPARATOR

      static final String STEP_NAME_SEPARATOR
      The separator used to build the name of the StepExecution of a partition from the name of the target step and the partition key, for example step1:partition0.
      Since:
      6.1
      See Also:
  • Method Details

    • getStepName

      String getStepName()
      The name of the step configuration that will be executed remotely. Remote workers are going to execute a the same step for each execution context in the partition.
      Returns:
      the name of the step that will execute the business logic
    • split

      Set<StepExecution> split(StepExecution stepExecution, int gridSize) throws JobExecutionException
      Partition the provided StepExecution into a set of parallel executable instances with the same parent JobExecution. The grid size will be treated as a hint for the size of the collection to be returned. It may or may not correspond to the physical size of an execution grid.

      On a restart clients of the StepExecutionSplitter should expect it to reconstitute the state of the last failed execution and only return those executions that need to be restarted. Thus the grid size hint will be ignored on a restart.
      Parameters:
      stepExecution - the StepExecution to be partitioned.
      gridSize - a hint for the splitter if the size of the grid is known
      Returns:
      a set of StepExecution instances for remote processing
      Throws:
      JobExecutionException - if the split cannot be made