org.apache.tiles.definition
Interface DefinitionsReader

All Known Implementing Classes:

CompatibilityDigesterDefinitionsReader, DigesterDefinitionsReader

public interface DefinitionsReader

Interface for reading Definition from a source.

This interface provides a standard way to read Definition objects from a source. Implementations should define what the source is, whether it be a persistent store such as a configuration file or database, or something like a web service. The DefinitionsReader is responsible for reading from a single location. It does not perform any internationalization duties or inheritance of Definitions. It only reads from the source and returns a Map of objects read.

Version:

$Rev: 652862 $ $Date: 2008-05-02 20:22:56 +0200 (ven, 02 mag 2008) $

Method Summary

void	init(Map<String,String> params) Initializes the DefinitionsReader object.
Map<String,Definition>	read(Object source) Reads Definition objects from a source.

Method Detail

init

void init(Map<String,String> params)

Initializes the DefinitionsReader object.

This method must be called before the read(java.lang.Object) method is called.

Parameters:

params - A map of properties used to set up the reader.

Throws:

DefinitionsFactoryException - if required properties are not passed in or the initialization fails.

read

Map<String,Definition> read(Object source)

Reads Definition objects from a source.

Implementations should publish what type of source object is expected.

Parameters:

source - The source from which definitions will be read.

Returns:

a Map of Definition objects read from the source.

Throws:

DefinitionsFactoryException - if the source is invalid or an error occurs when reading definitions.