cascading.property
Class AppProps

java.lang.Object
  cascading.property.Props
      cascading.property.AppProps

public class AppProps
extends Props

Class AppProps is a fluent helper for setting various application level properties that every Flow may or may not be required to have set. These properties are typically passed to a Flow via a FlowConnector.

In prior releases, the FlowConnector was responsible for setting the "application jar" class or path. Those methods have been deprecated and moved to AppProps.

New property settings that may be set in Cascading 2 are application name, version, and any tags.

Field Summary

static String	APP_FRAMEWORKS
static String	APP_ID
static String	APP_JAR_CLASS
static String	APP_JAR_PATH
static String	APP_NAME
static String	APP_TAGS
static String	APP_VERSION
protected Set<String>	frameworks
protected Class	jarClass
protected String	jarPath
protected String	name
protected Set<String>	tags
protected String	version

Constructor Summary

AppProps()

AppProps(String name, String version)
Sets the name and version of this application.

Method Summary

static void	addApplicationFramework(Map<Object,Object> properties, String framework) Adds a framework "name:version" string to the property set and to the System properties.
static void	addApplicationTag(Map<Object,Object> properties, String tag)
AppProps	addFramework(String framework) Adds a new framework name to the list of frameworks used.
AppProps	addFramework(String framework, String version) Adds a new framework name and its version to the list of frameworks used.
AppProps	addFrameworks(String... frameworks) Adds new framework names to the list of frameworks used.
protected void	addPropertiesTo(Properties properties)
AppProps	addTag(String tag)
AppProps	addTags(String... tags)
static AppProps	appProps()
static String	getApplicationFrameworks(Map<Object,Object> properties)
static String	getApplicationID(Map<Object,Object> properties)
static Class	getApplicationJarClass(Map<Object,Object> properties) Method getApplicationJarClass returns the Class set by the setApplicationJarClass method.
static String	getApplicationJarPath(Map<Object,Object> properties) Method getApplicationJarPath return the path set by the setApplicationJarPath method.
static String	getApplicationName(Map<Object,Object> properties)
static String	getApplicationTags(Map<Object,Object> properties)
static String	getApplicationVersion(Map<Object,Object> properties)
String	getFrameworks() Returns a list of frameworks used to build this App.
String	getTags()
static void	resetAppID() Sets the static appID value to null.
static void	setApplicationID(Map<Object,Object> properties)
static void	setApplicationJarClass(Map<Object,Object> properties, Class type) Method setApplicationJarClass is used to set the application jar file.
static void	setApplicationJarPath(Map<Object,Object> properties, String path) Method setApplicationJarPath is used to set the application jar file.
static void	setApplicationName(Map<Object,Object> properties, String name)
static void	setApplicationVersion(Map<Object,Object> properties, String version)
AppProps	setJarClass(Class jarClass) Method setJarClass is used to set the application jar file.
AppProps	setJarPath(String jarPath) Method setJarPath is used to set the application jar file.
AppProps	setName(String name)
AppProps	setVersion(String version)

Methods inherited from class cascading.property.Props

buildProperties, buildProperties, buildProperties, buildProperties, setProperties, setProperties

Methods inherited from class java.lang.Object

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

Field Detail

APP_ID

public static final String APP_ID

See Also:

Constant Field Values

APP_NAME

public static final String APP_NAME

See Also:

Constant Field Values

APP_VERSION

public static final String APP_VERSION

See Also:

Constant Field Values

APP_TAGS

public static final String APP_TAGS

See Also:

Constant Field Values

APP_FRAMEWORKS

public static final String APP_FRAMEWORKS

See Also:

Constant Field Values

APP_JAR_CLASS

public static final String APP_JAR_CLASS

See Also:

Constant Field Values

APP_JAR_PATH

public static final String APP_JAR_PATH

See Also:

Constant Field Values

name

protected String name

version

protected String version

tags

protected Set<String> tags

jarClass

protected Class jarClass

jarPath

protected String jarPath

frameworks

protected Set<String> frameworks

Constructor Detail

AppProps

public AppProps()

AppProps

public AppProps(String name,
                String version)

Sets the name and version of this application.

Parameters:

name - of type String

version - of type String

Method Detail

appProps

public static AppProps appProps()

setApplicationJarClass

public static void setApplicationJarClass(Map<Object,Object> properties,
                                          Class type)

Method setApplicationJarClass is used to set the application jar file.

All cluster executed Cascading applications need to call setApplicationJarClass(java.util.Map, Class) or setApplicationJarPath(java.util.Map, String), otherwise ClassNotFound exceptions are likely.

Parameters:

properties - of type Map

type - of type Class

getApplicationJarClass

public static Class getApplicationJarClass(Map<Object,Object> properties)

Method getApplicationJarClass returns the Class set by the setApplicationJarClass method.

Parameters:

properties - of type Map

Returns:

Class

setApplicationJarPath

public static void setApplicationJarPath(Map<Object,Object> properties,
                                         String path)

Method setApplicationJarPath is used to set the application jar file.

All cluster executed Cascading applications need to call setApplicationJarClass(java.util.Map, Class) or setApplicationJarPath(java.util.Map, String), otherwise ClassNotFound exceptions are likely.

Parameters:

properties - of type Map

path - of type String

getApplicationJarPath

public static String getApplicationJarPath(Map<Object,Object> properties)

Method getApplicationJarPath return the path set by the setApplicationJarPath method.

Parameters:

properties - of type Map

Returns:

String

setApplicationID

public static void setApplicationID(Map<Object,Object> properties)

getApplicationID

public static String getApplicationID(Map<Object,Object> properties)

resetAppID

public static void resetAppID()

Sets the static appID value to null. For debugging purposes.

setApplicationName

public static void setApplicationName(Map<Object,Object> properties,
                                      String name)

getApplicationName

public static String getApplicationName(Map<Object,Object> properties)

setApplicationVersion

public static void setApplicationVersion(Map<Object,Object> properties,
                                         String version)

getApplicationVersion

public static String getApplicationVersion(Map<Object,Object> properties)

addApplicationTag

public static void addApplicationTag(Map<Object,Object> properties,
                                     String tag)

getApplicationTags

public static String getApplicationTags(Map<Object,Object> properties)

addApplicationFramework

public static void addApplicationFramework(Map<Object,Object> properties,
                                           String framework)

Adds a framework "name:version" string to the property set and to the System properties.

Properties may be null. Duplicates are removed.

Parameters:

properties - may be null, additionally adds to System properties

framework - "name:version" String

getApplicationFrameworks

public static String getApplicationFrameworks(Map<Object,Object> properties)

setName

public AppProps setName(String name)

setVersion

public AppProps setVersion(String version)

getTags

public String getTags()

addTag

public AppProps addTag(String tag)

addTags

public AppProps addTags(String... tags)

getFrameworks

public String getFrameworks()

Returns a list of frameworks used to build this App.

Returns:

Registered frameworks

addFramework

public AppProps addFramework(String framework)

Adds a new framework name to the list of frameworks used.

Higher level tools should register themselves, and preferably with their version, for example foo-flow-builder:1.2.3.

See addFramework(String, String).

Parameters:

framework - A String

Returns:

this AppProps instance

addFramework

public AppProps addFramework(String framework,
                             String version)

Adds a new framework name and its version to the list of frameworks used.

Higher level tools should register themselves, and preferably with their version, for example foo-flow-builder:1.2.3.

Parameters:

framework - A String

Returns:

this AppProps instance

addFrameworks

public AppProps addFrameworks(String... frameworks)

Adds new framework names to the list of frameworks used.

Higher level tools should register themselves, and preferably with their version, for example foo-flow-builder:1.2.3.

Parameters:

frameworks - Strings

Returns:

this AppProps instance

setJarClass

public AppProps setJarClass(Class jarClass)

Method setJarClass is used to set the application jar file.

All cluster executed Cascading applications need to call setApplicationJarClass(java.util.Map, Class) or setApplicationJarPath(java.util.Map, String), otherwise ClassNotFound exceptions are likely.

Parameters:

jarClass - of type Class

setJarPath

public AppProps setJarPath(String jarPath)

Method setJarPath is used to set the application jar file.

All cluster executed Cascading applications need to call setJarClass(Class) or setJarPath(java.util.Map, String), otherwise ClassNotFound exceptions are likely.

Parameters:

jarPath - of type String

addPropertiesTo

protected void addPropertiesTo(Properties properties)

Specified by:

addPropertiesTo in class Props