org.asteriskjava.fastagi

Class CompositeMappingStrategy

java.lang.Object

org.asteriskjava.fastagi.CompositeMappingStrategy

All Implemented Interfaces:

MappingStrategy

public class CompositeMappingStrategy
extends Object
implements MappingStrategy

A mapping strategy that tries a sequence of other mapping strategies to find an AgiScript matching the request. The first strategy that returns a result wins, so the order of the mapping strategies passed to the CompositeMappingStrategy matters.

Example:

 new CompositeMappingStrategy(
       new ResourceBundleMappingStrategy(),
       new ClassNameMappingStrategy());
 

This creates a new mapping strategy that first tries to look up the script in fastagi-mapping.properties and - if the properties file is not present on the classpath or contains no mapping for the request - uses a ClassNameMappingStrategy to get the script.

Since:

0.3

Version:

$Id$

Author:

srt

See Also:

ResourceBundleMappingStrategy, ClassNameMappingStrategy

Constructor Summary

Constructors

Constructor and Description
CompositeMappingStrategy() Creates a new empty CompositeMappingStrategy.
CompositeMappingStrategy(List<MappingStrategy> strategies) Creates a new CompositeMappingStrategy.
CompositeMappingStrategy(MappingStrategy... strategies) Creates a new CompositeMappingStrategy.

Method Summary

Modifier and Type	Method and Description
void	addStrategy(MappingStrategy strategy) Adds a strategy (at the end of the list).
AgiScript	determineScript(AgiRequest request, AgiChannel channel) Returns the AgiScript instance that is responsible to handle the given request.
void	setStrategies(List<MappingStrategy> strategies) Sets the strategies to use.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CompositeMappingStrategy

public CompositeMappingStrategy()

Creates a new empty CompositeMappingStrategy.

CompositeMappingStrategy

public CompositeMappingStrategy(MappingStrategy... strategies)

Creates a new CompositeMappingStrategy.

Parameters:

strategies - the strategies to use.

CompositeMappingStrategy

public CompositeMappingStrategy(List<MappingStrategy> strategies)

Creates a new CompositeMappingStrategy.

Parameters:

strategies - the strategies to use.

Method Detail

addStrategy

public void addStrategy(MappingStrategy strategy)

Adds a strategy (at the end of the list).

Parameters:

strategy - the strategy to add.

setStrategies

public void setStrategies(List<MappingStrategy> strategies)

Sets the strategies to use.

Parameters:

strategies - the strategies to use.

determineScript

public AgiScript determineScript(AgiRequest request,
                                 AgiChannel channel)

Description copied from interface: MappingStrategy

Returns the AgiScript instance that is responsible to handle the given request.

Specified by:

determineScript in interface MappingStrategy

Parameters:

request - the request to lookup.

channel - the channel.

Returns:

the AgiScript instance to handle this request or null if none could be determined by this strategy.