com.ibm.di.config.xml
Class Factories

java.lang.Object
  com.ibm.di.config.xml.Factories

Direct Known Subclasses:

ALMappingFactory, AssemblyLineFactory, BranchingFactory, CheckpointFactory, ConnectorFactory, ContainerFactory, ExtPropFactory, FolderFactory, FormFactory, FunctionFactory, HookFactory, InstanceFactory, LibraryFactory, LoggingFactory, LogItemFactory, LoopFactory, NamespaceFactory, ParserFactory, PropertyFactory, PropertyStoreFactory, ReconnectFactory, SandboxFactory, SchemaFactory, ScriptFactory, SimulationFactory, SolutionInterfaceFactory, TombstonesFactory

public class Factories
extends Object

General class used to create a configuration object representing parsed XML file.

This class is inherited by all factories for specific components - AssemblyLineFactory, FunctionFactory, HookFactory etc.

Field Summary

static Hashtable<String,Factories>	classMap Tags / class mapping
static Hashtable<String,String>	implMap Hashtable containig the mapping between the XML tag names and the corresponding factory classes.
static String	INHERIT_TAG General tag - "InheritFrom"
static Log	logger Logger
static String	NAME_ATTRIBUTE General attribute - "name"
static String	NAME_TAG General tag - "Name"
static String	NULLBEHAVIOR General attribute - "NullBehavior"
static String	NULLBEHAVIORVALUE General attribute - "NullBehaviorValue"
static String	NULLDEFINITION General attribute - "NullDefinition"
static String	NULLDEFINITIONVALUE General attribute - "NullDefinitionValue"
static String	PARAMETER_TAG General tag - "parameter"
Factories	parent Parent of this factory.
static String	USER_COMMENT_ATTRIBUTE General attribute - "UserComment"
static String	VALUE_ATTRIBUTE General attribute - "value"

Constructor Summary

Factories()

Method Summary

void	build(BaseConfiguration config, Element element) Generate a XML element from a configuration object.
static void	debug(String msg) Prints debug message.
static void	dump(BaseConfiguration config) List information for this factory.
void	getBaseName(BaseConfiguration config, Element elem) This method retries the name and inheritFrom attributes/elements and configures the base object with its name and also calls MetamergeConfig for any inherited objects.
static String	getClassTag(Object config)
static Factories	getFactory(String tag)
static BaseConfiguration	getImpl(String tag)
void	getInheritsFrom(BaseConfiguration config, Element elem) This method retries the inheritsFrom element and configures the base object with the retrieved information.
String	getNodeText(Node node)
String	getNodeTextByName(Element node, String name)
void	getParameter(Element p, BaseConfiguration config) Add simple parameter to configuration.
void	getParameters(Element p, BaseConfiguration config) Add simple parameters to configuration.
Element	getSingleElement(Element node, String name)
static boolean	isDebugMode()
static void	logmsg(String msg) Logs message.
void	parse(BaseConfiguration config, Element element) Parse a XML element into a configuration object.
void	setBaseName(BaseConfiguration config, Element elem) Attaches to the XML tree a single element representing the user comment.
void	setInheritsFrom(BaseConfiguration config, Element elem) Set the inheritFrom if it exists.
void	setParameter(Element p, BaseConfiguration config, Object pname) Generates XML element for parameter, initialize it and attach it to the p object.
Element	setParameters(Element p, BaseConfiguration config, String tag)
void	setSingleElement(Element node, String tag, BaseConfiguration bc, String name) Sets a simple tag/value.
void	setSingleElement(Element node, String tag, String value) Sets a simple tag/value.

Methods inherited from class java.lang.Object

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

Field Detail

logger

public static final Log logger

Logger

classMap

public static final Hashtable<String,Factories> classMap

Tags / class mapping

implMap

public static final Hashtable<String,String> implMap

Hashtable containig the mapping between the XML tag names and the corresponding factory classes.

PARAMETER_TAG

public static final String PARAMETER_TAG

General tag - "parameter"

See Also:

Constant Field Values

NAME_TAG

public static final String NAME_TAG

General tag - "Name"

See Also:

Constant Field Values

INHERIT_TAG

public static final String INHERIT_TAG

General tag - "InheritFrom"

See Also:

Constant Field Values

NAME_ATTRIBUTE

public static final String NAME_ATTRIBUTE

General attribute - "name"

See Also:

Constant Field Values

VALUE_ATTRIBUTE

public static final String VALUE_ATTRIBUTE

General attribute - "value"

See Also:

Constant Field Values

USER_COMMENT_ATTRIBUTE

public static final String USER_COMMENT_ATTRIBUTE

General attribute - "UserComment"

See Also:

Constant Field Values

NULLBEHAVIOR

public static final String NULLBEHAVIOR

General attribute - "NullBehavior"

See Also:

Constant Field Values

NULLBEHAVIORVALUE

public static final String NULLBEHAVIORVALUE

General attribute - "NullBehaviorValue"

See Also:

Constant Field Values

NULLDEFINITION

public static final String NULLDEFINITION

General attribute - "NullDefinition"

See Also:

Constant Field Values

NULLDEFINITIONVALUE

public static final String NULLDEFINITIONVALUE

General attribute - "NullDefinitionValue"

See Also:

Constant Field Values

parent

public Factories parent

Parent of this factory.

Constructor Detail

Factories

public Factories()

Method Detail

getFactory

public static Factories getFactory(String tag)
                            throws Exception

Parameters:

tag - XML tag name

Returns:

factory for the specified XML element

Throws:

Exception - no mapping for such XML tag exist

getImpl

public static BaseConfiguration getImpl(String tag)
                                 throws Exception

Parameters:

tag - XML tag name

Returns:

new instance of configuration implementation

Throws:

Exception - no mapping for such XML tag exist

getClassTag

public static String getClassTag(Object config)

Parameters:

config - Factory object

Returns:

XML tag name used for the specified class

isDebugMode

public static boolean isDebugMode()

Returns:

true if debug is enabled. Otherwise, false is returned.

parse

public void parse(BaseConfiguration config,
                  Element element)
           throws Exception

Parse a XML element into a configuration object.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

element - this is a part of the XML tree that represents the BaseConfiguration object.

Throws:

Exception - in case the configuration object the provided XML element represents is not recognized.

build

public void build(BaseConfiguration config,
                  Element element)
           throws Exception

Generate a XML element from a configuration object.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will be represented as a XML sub-tree.

element - this is the part of the XML tree where the config object's XML representation will be attached to.

Throws:

Exception - in case the tag name of the provided XML element is not recognized as a valid name which is used for configuration object representation as a XML.

debug

public static void debug(String msg)

Prints debug message.

Parameters:

msg - text of the message

logmsg

public static void logmsg(String msg)

Logs message.

Parameters:

msg - text of the message.

dump

public static void dump(BaseConfiguration config)

List information for this factory.

Parameters:

config - configuration object

getBaseName

public void getBaseName(BaseConfiguration config,
                        Element elem)
                 throws Exception

This method retries the name and inheritFrom attributes/elements and configures the base object with its name and also calls MetamergeConfig for any inherited objects.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

elem - this is a part of the XML tree that represents the BaseConfiguration object.

Throws:

Exception - if could not return text from node's children

getInheritsFrom

public void getInheritsFrom(BaseConfiguration config,
                            Element elem)
                     throws Exception

This method retries the inheritsFrom element and configures the base object with the retrieved information.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

elem - this is a part of the XML tree that represents the BaseConfiguration object.

Throws:

Exception - if could not return text from node's children

setBaseName

public void setBaseName(BaseConfiguration config,
                        Element elem)
                 throws Exception

Attaches to the XML tree a single element representing the user comment.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

elem - this is the part of the XML tree where the config object's XML representation will be attached to.

Throws:

Exception - if could not return text from node's children

setInheritsFrom

public void setInheritsFrom(BaseConfiguration config,
                            Element elem)
                     throws Exception

Set the inheritFrom if it exists.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

elem - this is the part of the XML tree where the config object's XML representation will be attached to.

Throws:

Exception

getParameters

public void getParameters(Element p,
                          BaseConfiguration config)
                   throws Exception

Add simple parameters to configuration.

Parameters:

p - this is a part of the XML tree that represents the BaseConfiguration object.

config - an instance of the BaseConfiguration class

Throws:

Exception

getParameter

public void getParameter(Element p,
                         BaseConfiguration config)
                  throws Exception

Add simple parameter to configuration.

Parameters:

p - this is a part of the XML tree that represents the BaseConfiguration object.

config - an instance of the BaseConfiguration class

Throws:

Exception

setParameters

public Element setParameters(Element p,
                             BaseConfiguration config,
                             String tag)
                      throws Exception

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

p - this is the part of the XML tree where the config object's XML representation will be attached to.

tag - XML tag name to be created

Returns:

Element containing the simple parameters

Throws:

Exception

setParameter

public void setParameter(Element p,
                         BaseConfiguration config,
                         Object pname)
                  throws Exception

Generates XML element for parameter, initialize it and attach it to the p object.

Parameters:

config - an instance of the BaseConfiguration class which internal parameters will get set based on the information from the provided XML Element.

p - this is the part of the XML tree where the config object's XML representation will be attached to.

pname -

Throws:

Exception

getNodeText

public String getNodeText(Node node)
                   throws Exception

Parameters:

node - Node object

Returns:

text from a node's children

Throws:

Exception

getSingleElement

public Element getSingleElement(Element node,
                                String name)
                         throws Exception

Parameters:

node - Node object

name - name to locate

Returns:

a single Element from a node's children

Throws:

Exception

getNodeTextByName

public String getNodeTextByName(Element node,
                                String name)
                         throws Exception

Parameters:

node - Node object

name - child name

Returns:

text from a single named node's children

Throws:

Exception

setSingleElement

public void setSingleElement(Element node,
                             String tag,
                             BaseConfiguration bc,
                             String name)
                      throws Exception

Sets a simple tag/value.

Parameters:

node - Node object

tag - XML tag name

bc - BaseConfiguration object

name - name of the single Element

Throws:

Exception

setSingleElement

public void setSingleElement(Element node,
                             String tag,
                             String value)
                      throws Exception

Sets a simple tag/value.

Parameters:

node - Node object

tag - XML tag name

value - text node value

Throws:

Exception