oracle.apps.fnd.applcp.request.exec
Class ExecWrapperBase

java.lang.Object
  oracle.apps.fnd.applcp.request.exec.ExecWrapperBase

Direct Known Subclasses:

AsyncExecutableWrapper, ExecutableWrapper

public abstract class ExecWrapperBase
extends java.lang.Object

This class is used to wrap the program executable to perform certain important tasks before control is handed off to the program executable and after control is returned from it.

This class replaces the program executable class as the ESS executable in the pre-processing phase. When ESS enters the execution stage, it run this class. At this point, this class performs two actions:

• Setup the RequestInfoMap for support classes
• Run the program executable

This class also implements the Cancellable interface. When cancel() is called on this class, it in turn inspects to see if the underlying program executable implements Cancellable and if yes, invokes it. Else no action is performed.

At the end of the execution, all open resources are closed and control is is returned back to ESS. If an unexpected error occurs during program execution, this error is caught, logged (to the request log file) and re-thrown appropriately.

Version:

$Header: atgpf/applcp/src/java/oracle/apps/fnd/applcp/request/exec/ExecWrapperBase.java /st_atgpf_pt-11.1.1.7.0/1 2012/09/05 10:48:51 sonelson Exp $

aweisber

Field Summary

java.lang.Object	jobInstance
static java.lang.String	LOGGER_PREFIX The prefix to use when logging messages via ODL.
static java.util.logging.Logger	oLog

Constructor Summary

ExecWrapperBase()

Method Summary

protected boolean	canLog(java.util.logging.Level level) Check if log message can be written to the ODL log at a particular level.
protected void	cleanup()
void	execute(oracle.as.scheduler.RequestExecutionContext context, oracle.as.scheduler.RequestParameters params) Implements the execute() method from the Executable interface.
abstract void	executeHelper(oracle.as.scheduler.RequestExecutionContext context, oracle.as.scheduler.RequestParameters params)
protected void	init(oracle.as.scheduler.RequestExecutionContext context, oracle.as.scheduler.RequestParameters parameters) Initialize instance
void	setExecutable(java.lang.Class<?> exec)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

oLog

public static java.util.logging.Logger oLog

jobInstance

public java.lang.Object jobInstance

LOGGER_PREFIX

public static final java.lang.String LOGGER_PREFIX

The prefix to use when logging messages via ODL.

See Also:

Constant Field Values

Constructor Detail

ExecWrapperBase

public ExecWrapperBase()

Method Detail

execute

public void execute(oracle.as.scheduler.RequestExecutionContext context,
                    oracle.as.scheduler.RequestParameters params)
             throws oracle.as.scheduler.ExecutionErrorException,
                    oracle.as.scheduler.ExecutionWarningException,
                    oracle.as.scheduler.ExecutionCancelledException,
                    oracle.as.scheduler.ExecutionPausedException,
                    oracle.as.scheduler.ExecutionManualRecoveryException

Implements the execute() method from the Executable interface.

Parameters:

context - the context of the current request

params - the parameters associated with this request

Throws:

oracle.as.scheduler.ExecutionErrorException - if an error occurs during execution

oracle.as.scheduler.ExecutionWarningException - if an warning occurs during execution

oracle.as.scheduler.ExecutionCancelledException - if execution is cancelled by the program for any reason

oracle.as.scheduler.ExecutionPausedException - if the program logic wants to pause this request

oracle.as.scheduler.ExecutionManualRecoveryException - if an error occurs during execution of async program job logic that requires manual recovery

executeHelper

public abstract void executeHelper(oracle.as.scheduler.RequestExecutionContext context,
                                   oracle.as.scheduler.RequestParameters params)
                            throws oracle.as.scheduler.ExecutionErrorException,
                                   oracle.as.scheduler.ExecutionWarningException,
                                   oracle.as.scheduler.ExecutionCancelledException,
                                   oracle.as.scheduler.ExecutionPausedException,
                                   oracle.as.scheduler.ExecutionManualRecoveryException

Throws:

oracle.as.scheduler.ExecutionErrorException

oracle.as.scheduler.ExecutionWarningException

oracle.as.scheduler.ExecutionCancelledException

oracle.as.scheduler.ExecutionPausedException

oracle.as.scheduler.ExecutionManualRecoveryException

init

protected void init(oracle.as.scheduler.RequestExecutionContext context,
                    oracle.as.scheduler.RequestParameters parameters)
             throws java.lang.Throwable

Initialize instance

Throws:

java.lang.Throwable

cleanup

protected void cleanup()

canLog

protected boolean canLog(java.util.logging.Level level)

Check if log message can be written to the ODL log at a particular level.

Parameters:

level - a Level value

Returns:

a boolean value

setExecutable

public void setExecutable(java.lang.Class<?> exec)