This project has retired. For details please refer to its Attic page.

org.apache.tiles.definition
Interface DefinitionsFactory

All Known Implementing Classes:

LocaleDefinitionsFactory, UrlDefinitionsFactory

public interface DefinitionsFactory

Interface for creating a Definitions object and managing its contents.

DefinitionsFactory implementations are responsible for maintaining the data sources of Tiles configuration data and using the data to create Definitions sets. Implementations also know how to append locale-specific configuration data to an existing Definitions set.

Version:

$Rev: 666834 $ $Date: 2008-06-11 22:49:05 +0200 (mer, 11 giu 2008) $

Field Summary

static String	DEFINITION_DAO_INIT_PARAM Constant representing the configuration parameter used to define the definition DAO to use.
static String	DEFINITIONS_CONFIG Constant representing the configuration parameter used to define the tiles definition resources.
static String	LOCALE_RESOLVER_IMPL_PROPERTY Property name that specifies the implementation of LocaleResolver.
static String	READER_IMPL_PROPERTY Property name that specifies the implementation of the DefinitionsReader.

Method Summary

void	addSource(Object source) Deprecated. Let the Definitions Factory load its sources by itself.
Definition	getDefinition(String name, TilesRequestContext tilesContext) Returns a Definition object that matches the given name and Tiles context.
void	init(Map<String,String> params) Initializes the DefinitionsFactory and its subcomponents.
Definitions	readDefinitions() Deprecated. Let the Definitions Factory use it.

Field Detail

READER_IMPL_PROPERTY

static final String READER_IMPL_PROPERTY

Property name that specifies the implementation of the DefinitionsReader.

See Also:

Constant Field Values

LOCALE_RESOLVER_IMPL_PROPERTY

static final String LOCALE_RESOLVER_IMPL_PROPERTY

Property name that specifies the implementation of LocaleResolver.

See Also:

Constant Field Values

DEFINITIONS_CONFIG

static final String DEFINITIONS_CONFIG

Constant representing the configuration parameter used to define the tiles definition resources.

Since:

2.1.0

See Also:

Constant Field Values

DEFINITION_DAO_INIT_PARAM

static final String DEFINITION_DAO_INIT_PARAM

Constant representing the configuration parameter used to define the definition DAO to use.

See Also:

Constant Field Values

Method Detail

init

void init(Map<String,String> params)

Initializes the DefinitionsFactory and its subcomponents.

Implementations may support configuration properties to be passed in via the params Map.

Parameters:

params - The Map of configuration properties.

Throws:

DefinitionsFactoryException - If a Tiles exception, such as an initialization error, occurs.

getDefinition

Definition getDefinition(String name,
                         TilesRequestContext tilesContext)

Returns a Definition object that matches the given name and Tiles context.

Parameters:

name - The name of the Definition to return.

tilesContext - The Tiles context to use to resolve the definition.

Returns:

the Definition matching the given name or null if none is found.

addSource

@Deprecated
void addSource(Object source)

Deprecated. Let the Definitions Factory load its sources by itself.

Adds a source where Definition objects are stored.

Implementations should publish what type of source object they expect. The source should contain enough information to resolve a configuration source containing definitions. The source should be a "base" source for configurations. Internationalization and Localization properties will be applied by implementations to discriminate the correct data sources based on locale.

Parameters:

source - The configuration source for definitions.

readDefinitions

@Deprecated
Definitions readDefinitions()

Deprecated. Let the Definitions Factory use it.

Creates and returns a Definitions set by reading configuration data from the applied sources.

Returns:

The read definitions.