Skip navigation links

oracle.as.scheduler
Interface AsyncCancellable

public interface AsyncCancellable

Since:

release specific (what release of product did this appear in) Contract by which a client Asynchronous Java executable can be cancelled. This interface is typically used as an optional interface that may be implemented for certain Asynchronous Java classes supplied by the client.

When a job request is cancelled, Enterprise Scheduler determines if the client class implements the AsyncCancellable interface, and if so, calls the cancel method to notify the client class of the request cancellation.

Important: This interface differs from the normal Cancellable interface in that the cancel method has a RequestExecutionContext parameter. This is because the physical Java object on which ESS calls execute may not be the same object on which ESS calls cancel due to restarts (i.e. the asynchronous job may have started, the server restarted, and then the job cancelled). The provided context allows the client to correlate the job to be cancelled with whatever agent is running the actual job.

The client is responsible for stopping that agent and then calling onCancel using the AsyncHelper or by directly invoking the AsyncRequestBeanRemote

Version:

$Header: ess/src/oracle/as/scheduler/AsyncCancellable.java /main/1 2008/09/26 20:18:40 dcraft Exp $

Author:

dcraft

Method Summary

void	cancel(RequestExecutionContext context, RequestParameters requestParams) Invoked by Enterprise Scheduler when a job request is cancelled.

Method Detail

cancel

void cancel(RequestExecutionContext context,
            RequestParameters requestParams)

Invoked by Enterprise Scheduler when a job request is cancelled. This method must eventually return control to the caller.

Skip navigation links