Save This Page
Home » tiles-2.0.6-src » org.apache » tiles » definition » digester » [javadoc | source]
org.apache.tiles.definition.digester
public class: DigesterDefinitionsReader [javadoc | source]
java.lang.Object
   org.apache.tiles.definition.digester.DigesterDefinitionsReader

All Implemented Interfaces:
    DefinitionsReader

Reads Definition objects from an XML InputStream using Digester.

This DefinitionsReader implementation expects the source to be passed as an InputStream. It parses XML data from the source and builds a Map of Definition objects.

The Digester object can be configured by passing in initialization parameters. Currently the only parameter that is supported is the validating parameter. This value is set to false by default. To enable DTD validation for XML Definition files, give the init method a parameter with a key of org.apache.tiles.definition.digester.DigesterDefinitionsReader.PARSER_VALIDATE and a value of "true".

The Definition objects are stored internally in a Map. The Map is stored as an instance variable rather than a local variable in the read method. This means that instances of this class are not thread-safe and access by multiple threads must be synchronized.

Field Summary
public static final  String PARSER_VALIDATE_PARAMETER_NAME    Digester validation parameter name. 
protected  Digester digester    Digester object used to read Definition data from the source. 
protected  boolean validating    Should we use a validating XML parser to read the configuration file. Default is true
protected  String[] registrations    The set of public identifiers, and corresponding resource names for the versions of the configuration file DTDs we know about. There MUST be an even number of Strings in this list! 
Constructor:
 public DigesterDefinitionsReader() 
Method from org.apache.tiles.definition.digester.DigesterDefinitionsReader Summary:
addDefinition,   init,   read
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.tiles.definition.digester.DigesterDefinitionsReader Detail:
 public  void addDefinition(Definition definition) 
    Adds a new Definition to the internal Map or replaces an existing one.
 public  void init(Map params) throws DefinitionsFactoryException 
    Initializes the DefinitionsReader object.

    This method must be called before the #read method is called.

 public Map read(Object source) throws DefinitionsFactoryException 
    Reads Definition objects from a source.

    Implementations should publish what type of source object is expected.