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

Field Summary
protected  java.lang.String definitionConfigFiles
          Definition configuration file specified by user.
static java.lang.String DEFINITIONS_CONFIG_PARAMETER_NAME
          Alternate name for definition files properties in configuration file.
private  java.util.Map extraAttributes
          Map of extra attribute available.
static java.lang.String FACTORY_CLASSNAME_PARAMETER_NAME
          Alternate name for factory classname properties in configuration file.
protected  java.lang.String factoryClassname
          Fully qualified classname of the factory to create.
protected  java.lang.String factoryName
          The name associated to this factory.
protected  boolean moduleAware
          Specifies whether the factory is "module-aware".
static java.lang.String PARSER_DETAILS_PARAMETER_NAME
          Deprecated. This will be removed in a release after Struts 1.2.
static java.lang.String PARSER_VALIDATE_PARAMETER_NAME
          Alternate name for parser validate properties in configuration file.
protected  boolean parserValidate
          Specifies whether the parser will validate configuration files.
static java.lang.String TILES_DETAILS_PARAMETER_NAME
          Deprecated. This will be removed in a release after Struts 1.2.
 
Constructor Summary
DefinitionsFactoryConfig()
          Default constructor.
DefinitionsFactoryConfig(java.util.Map initParameters)
          Constructor.
 
Method Summary
 java.lang.Object getAttribute(java.lang.String name)
          Get value of an additional attribute.
 java.util.Map getAttributes()
          Get additional attributes as a Map.
 java.lang.String getDefinitionConfigFiles()
          Get the definition config files.
 java.lang.String getFactoryClassname()
          Get the classname of the factory.
 java.lang.String getFactoryName()
          Get the factory name.
 boolean getParserValidate()
          Determines if the parser is validating.
 boolean isModuleAware()
          Get the module aware flag.
static void linkOldPropertyNames(java.util.Map properties)
          Link old property names to new property names.
 void populate(java.util.Map properties)
          Populate this config object from properties map, based on the specified name/value pairs.
 void setAttribute(java.lang.String name, java.lang.Object value)
          Set value of an additional attribute.
 void setDefinitionConfigFiles(java.lang.String aDefinitionConfigFiles)
          Set the definition config files.
 void setFactoryClassname(java.lang.String aFactoryClassname)
          Set the classname of the factory..
 void setFactoryName(java.lang.String factoryName)
          Set the factory name.
 void setModuleAware(boolean moduleAware)
          Set the module aware flag.
 void setParserValidate(boolean aParserValidate)
          Set the validating mode for the parser.
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Field Detail

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.
Constructor Detail

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.
Method Detail

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.


Copyright 2000-2006 - The Apache Software Foundation