org.springframework.batch.core.listener
Class ExecutionContextPromotionListener

java.lang.Object
  extended by org.springframework.batch.core.listener.StepExecutionListenerSupport
      extended by org.springframework.batch.core.listener.ExecutionContextPromotionListener
All Implemented Interfaces:
StepExecutionListener, StepListener, InitializingBean

public class ExecutionContextPromotionListener
extends StepExecutionListenerSupport
implements InitializingBean

This class can be used to automatically promote items from the Step ExecutionContext to the Job ExecutionContext at the end of a step. A list of keys should be provided that correspond to the items in the Step ExecutionContext that should be promoted. Additionally, an optional list of statuses can be set to indicate for which exit status codes the promotion should occur. These statuses will be checked using the PatternMatcher, so wildcards are allowed. By default, promotion will only occur for steps with an exit code of "COMPLETED".

Since:
2.0
Author:
Dan Garrette

Constructor Summary
ExecutionContextPromotionListener()
           
 
Method Summary
 void afterPropertiesSet()
           
 ExitStatus afterStep(StepExecution stepExecution)
          Give a listener a chance to modify the exit status from a step.
 void setKeys(String[] keys)
           
 void setStatuses(String[] statuses)
           
 void setStrict(boolean strict)
          If set to TRUE, the listener will throw an exception if any 'key' is not found in the Step ExecutionContext.
 
Methods inherited from class org.springframework.batch.core.listener.StepExecutionListenerSupport
beforeStep
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ExecutionContextPromotionListener

public ExecutionContextPromotionListener()
Method Detail

afterStep

public ExitStatus afterStep(StepExecution stepExecution)
Description copied from interface: StepExecutionListener
Give a listener a chance to modify the exit status from a step. The value returned will be combined with the normal exit status using ExitStatus.and(ExitStatus). Called after execution of step's processing logic (both successful or failed). Throwing exception in this method has no effect, it will only be logged.

Specified by:
afterStep in interface StepExecutionListener
Overrides:
afterStep in class StepExecutionListenerSupport
Returns:
an ExitStatus to combine with the normal value. Return null to leave the old value unchanged.

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception
Specified by:
afterPropertiesSet in interface InitializingBean
Throws:
Exception

setKeys

public void setKeys(String[] keys)
Parameters:
keys - A list of keys corresponding to items in the Step ExecutionContext that must be promoted.

setStatuses

public void setStatuses(String[] statuses)
Parameters:
statuses - A list of statuses for which the promotion should occur. Statuses can may contain wildcards recognizable by a PatternMatcher.

setStrict

public void setStrict(boolean strict)
If set to TRUE, the listener will throw an exception if any 'key' is not found in the Step ExecutionContext. FALSE by default.

Parameters:
strict -


Copyright © 2009 SpringSource. All Rights Reserved.