oracle.as.scheduler
Interface PostProcessHandler

public interface PostProcessHandler

Contract for a client application callback that is invoked after execution of a job request executable.

A client application specfies a post-process callback class by setting the POST_PROCESS system property, via either metadata or at request submission. The callback class may also implement the Cancellable interface. The class must provide an empty constructor.

The class object is instantiated at the start of request execution. The postProceess method will be called when the request has transitioned to COMPLETED state.

The Enterprise Scheduler creates a new instance of the callback class each time a submitted job request is executed. As such, the job implementation should not rely on class static or instance member variables for maintaining state.

See Also:

Executable, State

Method Summary

HandlerAction

postProcess(RequestExecutionContext context, RequestParameters parameters) Invoked by Enterprise Scheduler after the job request has executed.

Method Detail

postProcess

HandlerAction postProcess(RequestExecutionContext context,
                          RequestParameters parameters)

Invoked by Enterprise Scheduler after the job request has executed. This method is called when the request has transitioned to COMPLETED state. It must eventually return control to the caller and indicate how subsequent request processing should proceed.

This method is called only once for a given request. For example, it is not called each time a failed request is retried, or when request execution is paused to allow sub-requests to execute.

Parameters:

context - the execution context associated with this request

parameters - the request parameters associated with this request

Returns:

a HandlerAction whose associated status value indicates the status of this callout. The result will be used to determine how request processing will proceed. Any action other than those listed below is not supported and will cause the request to transition to WARNING state.

• PROCEED to inform Scheduler that request post-processing completed successfully. The request will transition to SUCCEEDED state or WARNING state depending on the status of the request prior to invoking the post-processor.
• WARN to inform Scheduler that request post-processing resulted in a warning. The request will transition to WARNING state.
• DELAY to inform Scheduler to postpone request processing by the quantum of time specified by the REPROCESS_DELAY property. The request remains in COMPLETED state during the delay.
• SYSTEM_ERROR to inform the Scheduler that the handler has experienced an error. The request will transition to WARNING state.
• BIZ_ERROR to inform the Scheduler that the handler has experienced a business error. The request will transition to to WARNING state.

See Also:

State