org.apache.oozie.service
Class WorkflowAppService

java.lang.Object
  org.apache.oozie.service.WorkflowAppService

All Implemented Interfaces:

Service

Direct Known Subclasses:

LiteWorkflowAppService

public abstract class WorkflowAppService
extends java.lang.Object
implements Service

Service that provides application workflow definition reading from the path and creation of the proto configuration.

Field Summary

static java.lang.String	APP_LIB_PATH_LIST
static java.lang.String	HADOOP_JT_KERBEROS_NAME
static java.lang.String	HADOOP_NN_KERBEROS_NAME
static java.lang.String	HADOOP_UGI
static java.lang.String	HADOOP_USER

Fields inherited from interface org.apache.oozie.service.Service

CONF_PREFIX

Constructor Summary

WorkflowAppService()

Method Summary

XConfiguration	createProtoActionConf(org.apache.hadoop.conf.Configuration jobConf, java.lang.String authToken) Create proto configuration.
void	destroy() Destroy the workflow application service.
java.lang.Class<? extends Service>	getInterface() Return the public interface for workflow application service.
void	init(Services services) Initialize the workflow application service.
abstract WorkflowApp	parseDef(org.apache.hadoop.conf.Configuration jobConf, java.lang.String authToken) Parse workflow definition.
abstract WorkflowApp	parseDef(java.lang.String wfXml) Parse workflow definition.
protected java.lang.String	readDefinition(java.lang.String appPath, java.lang.String user, java.lang.String group, java.lang.String autToken) Read workflow definition.

Methods inherited from class java.lang.Object

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

Field Detail

APP_LIB_PATH_LIST

public static final java.lang.String APP_LIB_PATH_LIST

See Also:

Constant Field Values

HADOOP_UGI

public static final java.lang.String HADOOP_UGI

See Also:

Constant Field Values

HADOOP_USER

public static final java.lang.String HADOOP_USER

See Also:

Constant Field Values

HADOOP_JT_KERBEROS_NAME

public static final java.lang.String HADOOP_JT_KERBEROS_NAME

See Also:

Constant Field Values

HADOOP_NN_KERBEROS_NAME

public static final java.lang.String HADOOP_NN_KERBEROS_NAME

See Also:

Constant Field Values

Constructor Detail

WorkflowAppService

public WorkflowAppService()

Method Detail

init

public void init(Services services)

Initialize the workflow application service.

Specified by:

init in interface Service

Parameters:

services - services instance.

destroy

public void destroy()

Destroy the workflow application service.

Specified by:

destroy in interface Service

getInterface

public java.lang.Class<? extends Service> getInterface()

Return the public interface for workflow application service.

Specified by:

getInterface in interface Service

Returns:

WorkflowAppService.

readDefinition

protected java.lang.String readDefinition(java.lang.String appPath,
                                          java.lang.String user,
                                          java.lang.String group,
                                          java.lang.String autToken)
                                   throws WorkflowException

Read workflow definition.

Parameters:

appPath - application path.

user - user name.

group - group name.

autToken - authentication token.

Returns:

workflow definition.

Throws:

WorkflowException - thrown if the definition could not be read.

createProtoActionConf

public XConfiguration createProtoActionConf(org.apache.hadoop.conf.Configuration jobConf,
                                            java.lang.String authToken)
                                     throws WorkflowException

Create proto configuration.

The proto configuration includes the user,group and the paths which need to be added to distributed cache. These paths include .jar,.so and the resource file paths.

Parameters:

jobConf - job configuration.

authToken - authentication token.

Returns:

proto configuration.

Throws:

WorkflowException - thrown if the proto action configuration could not be created.

parseDef

public abstract WorkflowApp parseDef(org.apache.hadoop.conf.Configuration jobConf,
                                     java.lang.String authToken)
                              throws WorkflowException

Parse workflow definition.

Parameters:

jobConf - job configuration.

authToken - authentication token.

Returns:

workflow application.

Throws:

WorkflowException - thrown if the workflow application could not be parsed.

parseDef

public abstract WorkflowApp parseDef(java.lang.String wfXml)
                              throws WorkflowException

Parse workflow definition.

Parameters:

wfXml - workflow.

Returns:

workflow application.

Throws:

WorkflowException - thrown if the workflow application could not be parsed.