oracle.as.scheduler

Interface Updatable

public interface Updatable

Contract by which an asynchronous Java executable can be delivered status information from the remote portion of the job.

This class allows the job to receive update events initiated by the remote job. When a job request is updated, Oracle Enterprise Scheduler determines whether the client class implements the Updatable interface. If the client class does implement the Updatable interface, it instantiates a new object of the job class and calls the onEvent method in the context of the MDB of the hosting application. This method accepts the request status as specified by the remote job and a string representing information in a format known to the job. This method may log information or do some other processing. It then returns an UpdateAction object including a status and a status message.

The Updatable interface is supported for the following client classes:

• a Java executable class that implements AsyncExecutable.

Method Summary

Modifier and Type	Method and Description
UpdateAction	onEvent(RequestExecutionContext context, RequestParameters parameters, AsyncStatus resultCode, String messagePayload) Invoked by Enterprise Scheduler when a remote job for an asynchronous request notifies Enterprise Scheduler of a status.

Method Detail

onEvent

UpdateAction onEvent(RequestExecutionContext context,
                     RequestParameters parameters,
                     AsyncStatus resultCode,
                     String messagePayload)

Invoked by Enterprise Scheduler when a remote job for an asynchronous request notifies Enterprise Scheduler of a status. This method must eventually return control to the caller.

Parameters:

context - the execution context for associated with this request

parameters - the request parameters associated with this request

resultCode - the action that generated this event

messagePayload - a String representing the body of this event. The content and format are not known by the Oracle Enterprise Scheduler.

Returns:

an object indicating how Oracle Enterprise Scheduler should proceed with processing the request.