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

Methods

Modifier and Type	Method and Description
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 Enterprise 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 Enterprise Scheduler that request post-processing resulted in a warning. The request will transition to WARNING state.
• DELAY to inform Enterprise 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 Enterprise Scheduler that the handler has experienced an error. The request will transition to WARNING state.
• BIZ_ERROR to inform Enterprise Scheduler that the handler has experienced a business error. The request will transition to WARNING state.

See Also:

State