Apache Struts API Documentation: Class DefinitionsFactoryConfig

org.apache.struts.tiles Class DefinitionsFactoryConfig

java.lang.Object
  |
  +--org.apache.struts.tiles.DefinitionsFactoryConfig

All Implemented Interfaces:

java.io.Serializable

public class DefinitionsFactoryConfig

extends java.lang.Object

implements java.io.Serializable

A TilesFactoryConfig object hold configuration attributes for a tile definition factory.

Since:

Struts 1.1

Version:

$Rev: 54929 $ $Date: 2004-10-16 17:38:42 +0100 (Sat, 16 Oct 2004) $

See Also:

Serialized Form

factoryClassname

protected java.lang.String factoryClassname

Fully qualified classname of the factory to create. If no classname is set, a default factory is created (of class "org.apache.struts.tiles.xmlDefinition.I18nFactorySet").

parserValidate

protected boolean parserValidate

Specifies whether the parser will validate configuration files. Default value is true.

definitionConfigFiles

protected java.lang.String definitionConfigFiles

Definition configuration file specified by user.

moduleAware

protected boolean moduleAware

Specifies whether the factory is "module-aware".

factoryName

protected java.lang.String factoryName

The name associated to this factory.
With Struts 1.1, this name is the module name to which this factory belong. It is set by the system.
In prior versions, this property is not used.

PARSER_DETAILS_PARAMETER_NAME

public static final java.lang.String PARSER_DETAILS_PARAMETER_NAME

Deprecated. This will be removed in a release after Struts 1.2.

Alternate name for parser debug details properties in configuration file.

PARSER_VALIDATE_PARAMETER_NAME

public static final java.lang.String PARSER_VALIDATE_PARAMETER_NAME

Alternate name for parser validate properties in configuration file.

FACTORY_CLASSNAME_PARAMETER_NAME

public static final java.lang.String FACTORY_CLASSNAME_PARAMETER_NAME

Alternate name for factory classname properties in configuration file.

DEFINITIONS_CONFIG_PARAMETER_NAME

public static final java.lang.String DEFINITIONS_CONFIG_PARAMETER_NAME

Alternate name for definition files properties in configuration file.

TILES_DETAILS_PARAMETER_NAME

public static final java.lang.String TILES_DETAILS_PARAMETER_NAME

Deprecated. This will be removed in a release after Struts 1.2.

Alternate name for definition debug details properties in configuration file.

extraAttributes

private java.util.Map extraAttributes

Map of extra attribute available.

DefinitionsFactoryConfig

public DefinitionsFactoryConfig()

Default constructor.

DefinitionsFactoryConfig

public DefinitionsFactoryConfig(java.util.Map initParameters)

Constructor. Create configuration object, and initialize it with parameters from Map. Parameters corresponding to an attribute are filtered and stored in appropriate attribute.

Parameters:

initParameters - Map.

isModuleAware

public boolean isModuleAware()

Get the module aware flag.

Returns:

true: user wants a single factory instance, false: user wants multiple factory instances (one per module with Struts)

setModuleAware

public void setModuleAware(boolean moduleAware)

Set the module aware flag.

Parameters:

moduleAware - true: user wants a single factory instance, false: user wants multiple factory instances (one per module with Struts)

getFactoryClassname

public java.lang.String getFactoryClassname()

Get the classname of the factory.

Returns:

Classname.

setFactoryClassname

public void setFactoryClassname(java.lang.String aFactoryClassname)

Set the classname of the factory..

Parameters:

aFactoryClassname - Classname of the factory.

getParserValidate

public boolean getParserValidate()

Determines if the parser is validating.

Returns:

true when in validating mode.

setParserValidate

public void setParserValidate(boolean aParserValidate)

Set the validating mode for the parser.

Parameters:

aParserValidate - true for validation, false otherwise

getDefinitionConfigFiles

public java.lang.String getDefinitionConfigFiles()

Get the definition config files.

Returns:

Defition config files.

setDefinitionConfigFiles

public void setDefinitionConfigFiles(java.lang.String aDefinitionConfigFiles)

Set the definition config files.

Parameters:

aDefinitionConfigFiles - Definition config files.

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)

Set value of an additional attribute.

Parameters:

name - Name of the attribute.

value - Value of the attribute.

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Get value of an additional attribute.

Parameters:

name - Name of the attribute.

Returns:

Value of the attribute, or null if not found.

getAttributes

public java.util.Map getAttributes()

Get additional attributes as a Map.

Returns:

Map A Map containing attribute name - value pairs.

populate

public void populate(java.util.Map properties)
              throws java.lang.IllegalAccessException,
                     java.lang.reflect.InvocationTargetException

Populate this config object from properties map, based on the specified name/value pairs. This method uses the populate() method from org.apache.commons.beanutils.BeanUtil.

Properties keys are scanned for old property names, and linked to the new name if necessary. This modifies the properties map.

The particular setter method to be called for each property is determined using the usual JavaBeans introspection mechanisms. Thus, you may identify custom setter methods using a BeanInfo class that is associated with the class of the bean itself. If no such BeanInfo class is available, the standard method name conversion ("set" plus the capitalized name of the property in question) is used.

NOTE: It is contrary to the JavaBeans Specification to have more than one setter method (with different argument signatures) for the same property.

Parameters:

properties - Map keyed by property name, with the corresponding (String or String[]) value(s) to be set.

Throws:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method.

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception.

See Also:

BeanUtils

linkOldPropertyNames

public static void linkOldPropertyNames(java.util.Map properties)

Link old property names to new property names. This modifies the map.

Parameters:

properties - Map keyed by property name, with the corresponding (String or String[]) value(s) to be set.

getFactoryName

public java.lang.String getFactoryName()

Get the factory name.

setFactoryName

public void setFactoryName(java.lang.String factoryName)

Set the factory name.

Parameters:

factoryName - Name of the factory.