org.apache.oozie.command.wf
Class ActionCommand.ActionExecutorContext

java.lang.Object
  org.apache.oozie.command.wf.ActionCommand.ActionExecutorContext

All Implemented Interfaces:

ActionExecutor.Context

Enclosing class:

ActionCommand<T>

public static class ActionCommand.ActionExecutorContext
extends java.lang.Object
implements ActionExecutor.Context

Constructor Summary

ActionCommand.ActionExecutorContext(WorkflowJobBean workflow, WorkflowActionBean action, boolean isRetry)

Method Summary

WorkflowAction	getAction()
org.apache.hadoop.fs.Path	getActionDir()
org.apache.hadoop.fs.FileSystem	getAppFileSystem()
java.lang.String	getCallbackUrl(java.lang.String externalStatusVar) Create the callback URL for the action.
ELEvaluator	getELEvaluator() Return an ELEvaluator with the context injected.
org.apache.hadoop.conf.Configuration	getProtoActionConf() Return a proto configuration for actions with auth properties already set.
java.lang.String	getRecoveryId() Get the Action Recovery ID.
java.lang.String	getVar(java.lang.String name) Get a workflow action variable.
WorkflowJob	getWorkflow() Return the workflow job.
boolean	isEnded() Returns whether setEndData has been called or not.
boolean	isExecuted() Returns whether setExecutionData has been called or not.
boolean	isRetry() Return if the executor invocation is a retry or not.
boolean	isStarted() Returns whether setStartData has been called or not.
void	setEndData(WorkflowAction.Status status, java.lang.String signalValue) Set the action end completion information for a completed action.
void	setErrorInfo(java.lang.String str, java.lang.String exMsg)
void	setExecutionData(java.lang.String externalStatus, java.util.Properties actionData) Set the action execution completion information for an action.
void	setExternalStatus(java.lang.String externalStatus) Sets the external status for the action in context.
void	setStartData(java.lang.String externalId, java.lang.String trackerUri, java.lang.String consoleUrl) Set the action tracking information for an successfully started action.
void	setVar(java.lang.String name, java.lang.String value) Set a workflow action variable.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionCommand.ActionExecutorContext

public ActionCommand.ActionExecutorContext(WorkflowJobBean workflow,
                                           WorkflowActionBean action,
                                           boolean isRetry)

Method Detail

getCallbackUrl

public java.lang.String getCallbackUrl(java.lang.String externalStatusVar)

Description copied from interface: ActionExecutor.Context

Create the callback URL for the action.

Specified by:

getCallbackUrl in interface ActionExecutor.Context

Parameters:

externalStatusVar - variable for the caller to inject the external status.

Returns:

the callback URL.

getProtoActionConf

public org.apache.hadoop.conf.Configuration getProtoActionConf()

Description copied from interface: ActionExecutor.Context

Return a proto configuration for actions with auth properties already set.

Specified by:

getProtoActionConf in interface ActionExecutor.Context

Returns:

a proto configuration for actions with auth properties already set.

getWorkflow

public WorkflowJob getWorkflow()

Description copied from interface: ActionExecutor.Context

Return the workflow job.

Specified by:

getWorkflow in interface ActionExecutor.Context

Returns:

the workflow job.

getAction

public WorkflowAction getAction()

getELEvaluator

public ELEvaluator getELEvaluator()

Description copied from interface: ActionExecutor.Context

Return an ELEvaluator with the context injected.

Specified by:

getELEvaluator in interface ActionExecutor.Context

Returns:

configured ELEvaluator.

setVar

public void setVar(java.lang.String name,
                   java.lang.String value)

Description copied from interface: ActionExecutor.Context

Set a workflow action variable.

Convenience method that prefixes the variable name with the action name plus a '.'.

Specified by:

setVar in interface ActionExecutor.Context

Parameters:

name - variable name.

value - variable value, null removes the variable.

getVar

public java.lang.String getVar(java.lang.String name)

Description copied from interface: ActionExecutor.Context

Get a workflow action variable.

Convenience method that prefixes the variable name with the action name plus a '.'.

Specified by:

getVar in interface ActionExecutor.Context

Parameters:

name - variable name.

Returns:

the variable value, null if not set.

setStartData

public void setStartData(java.lang.String externalId,
                         java.lang.String trackerUri,
                         java.lang.String consoleUrl)

Description copied from interface: ActionExecutor.Context

Set the action tracking information for an successfully started action.

Specified by:

setStartData in interface ActionExecutor.Context

Parameters:

externalId - the action external ID.

trackerUri - the action tracker URI.

consoleUrl - the action console URL.

setExecutionData

public void setExecutionData(java.lang.String externalStatus,
                             java.util.Properties actionData)

Description copied from interface: ActionExecutor.Context

Set the action execution completion information for an action. The action status is set to WorkflowAction.Status.DONE

Specified by:

setExecutionData in interface ActionExecutor.Context

Parameters:

externalStatus - the action external end status.

actionData - the action data on completion, null if none.

setEndData

public void setEndData(WorkflowAction.Status status,
                       java.lang.String signalValue)

Description copied from interface: ActionExecutor.Context

Set the action end completion information for a completed action.

Specified by:

setEndData in interface ActionExecutor.Context

Parameters:

status - the action end status, it can be WorkflowAction.Status.OK or WorkflowAction.Status.ERROR.

signalValue - the action external end status.

isRetry

public boolean isRetry()

Description copied from interface: ActionExecutor.Context

Return if the executor invocation is a retry or not.

Specified by:

isRetry in interface ActionExecutor.Context

Returns:

if the executor invocation is a retry or not.

isStarted

public boolean isStarted()

Returns whether setStartData has been called or not.

Returns:

true if start completion info has been set.

isExecuted

public boolean isExecuted()

Returns whether setExecutionData has been called or not.

Returns:

true if execution completion info has been set, otherwise false.

isEnded

public boolean isEnded()

Returns whether setEndData has been called or not.

Returns:

true if end completion info has been set.

setExternalStatus

public void setExternalStatus(java.lang.String externalStatus)

Description copied from interface: ActionExecutor.Context

Sets the external status for the action in context.

Specified by:

setExternalStatus in interface ActionExecutor.Context

Parameters:

externalStatus - the external status.

getRecoveryId

public java.lang.String getRecoveryId()

Description copied from interface: ActionExecutor.Context

Get the Action Recovery ID.

Specified by:

getRecoveryId in interface ActionExecutor.Context

Returns:

recovery ID.

getActionDir

public org.apache.hadoop.fs.Path getActionDir()
                                       throws HadoopAccessorException,
                                              java.io.IOException,
                                              java.net.URISyntaxException

Specified by:

getActionDir in interface ActionExecutor.Context

Throws:

HadoopAccessorException

java.io.IOException

java.net.URISyntaxException

getAppFileSystem

public org.apache.hadoop.fs.FileSystem getAppFileSystem()
                                                 throws HadoopAccessorException,
                                                        java.io.IOException,
                                                        java.net.URISyntaxException

Specified by:

getAppFileSystem in interface ActionExecutor.Context

Returns:

filesystem handle for the application deployment fs.

Throws:

HadoopAccessorException

java.io.IOException

java.net.URISyntaxException

setErrorInfo

public void setErrorInfo(java.lang.String str,
                         java.lang.String exMsg)

Specified by:

setErrorInfo in interface ActionExecutor.Context