org.apache.commons.configuration
Class DefaultConfigurationBuilder.ConfigurationDeclaration

java.lang.Object
  extended by org.apache.commons.configuration.beanutils.XMLBeanDeclaration
      extended by org.apache.commons.configuration.DefaultConfigurationBuilder.ConfigurationDeclaration
All Implemented Interfaces:
BeanDeclaration
Enclosing class:
DefaultConfigurationBuilder

public static class DefaultConfigurationBuilder.ConfigurationDeclaration
extends XMLBeanDeclaration

A specialized BeanDeclaration implementation that represents the declaration of a configuration source.

Instances of this class are able to extract all information about a configuration source from the configuration definition file. The declaration of a configuration source is very similar to a bean declaration processed by XMLBeanDeclaration. There are very few differences, e.g. some reserved attributes like optional and at and the fact that a bean factory is never needed.


Field Summary
 
Fields inherited from class org.apache.commons.configuration.beanutils.XMLBeanDeclaration
ATTR_BEAN_CLASS, ATTR_BEAN_FACTORY, ATTR_FACTORY_PARAM, ATTR_PREFIX, RESERVED_PREFIX
 
Constructor Summary
DefaultConfigurationBuilder.ConfigurationDeclaration(DefaultConfigurationBuilder builder, HierarchicalConfiguration config)
          Creates a new instance of ConfigurationDeclaration and initializes it.
 
Method Summary
 String getAt()
          Returns the value of the at attribute.
 String getBeanClassName()
          Returns the bean's class name.
 String getBeanFactoryName()
          Returns the name of the bean factory.
 DefaultConfigurationBuilder getConfigurationBuilder()
          Returns the associated configuration builder.
protected  Object interpolate(Object value)
          Performs interpolation.
 boolean isForceCreate()
          Returns a flag whether this configuration should always be created and added to the resulting combined configuration.
 boolean isOptional()
          Returns a flag whether this is an optional configuration.
protected  boolean isReservedNode(ConfigurationNode nd)
          Checks whether the given node is reserved.
 
Methods inherited from class org.apache.commons.configuration.beanutils.XMLBeanDeclaration
getBeanFactoryParameter, getBeanProperties, getConfiguration, getNestedBeanDeclarations, getNode
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DefaultConfigurationBuilder.ConfigurationDeclaration

public DefaultConfigurationBuilder.ConfigurationDeclaration(DefaultConfigurationBuilder builder,
                                                            HierarchicalConfiguration config)
Creates a new instance of ConfigurationDeclaration and initializes it.

Parameters:
builder - the associated configuration builder
config - the configuration this declaration is based onto
Method Detail

getConfigurationBuilder

public DefaultConfigurationBuilder getConfigurationBuilder()
Returns the associated configuration builder.

Returns:
the configuration builder

getAt

public String getAt()
Returns the value of the at attribute.

Returns:
the value of the at attribute (can be null)

isOptional

public boolean isOptional()
Returns a flag whether this is an optional configuration.

Returns:
a flag if this declaration points to an optional configuration

isForceCreate

public boolean isForceCreate()
Returns a flag whether this configuration should always be created and added to the resulting combined configuration. This flag is evaluated only for optional configurations whose normal creation has caused an error. If for such a configuration the forceCreate attribute is set and the corresponding configuration provider supports this mode, an empty configuration will be created and added to the resulting combined configuration.

Returns:
the value of the forceCreate attribute
Since:
1.4

getBeanFactoryName

public String getBeanFactoryName()
Returns the name of the bean factory. For configuration source declarations always a reserved factory is used. This factory's name is returned by this implementation.

Specified by:
getBeanFactoryName in interface BeanDeclaration
Overrides:
getBeanFactoryName in class XMLBeanDeclaration
Returns:
the name of the bean factory

getBeanClassName

public String getBeanClassName()
Returns the bean's class name. This implementation will always return null.

Specified by:
getBeanClassName in interface BeanDeclaration
Overrides:
getBeanClassName in class XMLBeanDeclaration
Returns:
the name of the bean's class

isReservedNode

protected boolean isReservedNode(ConfigurationNode nd)
Checks whether the given node is reserved. This method will take further reserved attributes into account

Overrides:
isReservedNode in class XMLBeanDeclaration
Parameters:
nd - the node
Returns:
a flag whether this node is reserved

interpolate

protected Object interpolate(Object value)
Performs interpolation. This implementation will delegate interpolation to the configuration builder, which takes care that the currently constructed configuration is taken into account, too.

Overrides:
interpolate in class XMLBeanDeclaration
Parameters:
value - the value to be interpolated
Returns:
the interpolated value


Copyright © 2001-2007 The Apache Software Foundation. All Rights Reserved.