Reads {@link Definition} objects froman 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.
@version $Rev: 616890 $ $Date: 2008-01-30 21:16:51 +0100 (Wed, 30 Jan 2008) $