org.apache.cocoon.matching
Interface Matcher

All Superinterfaces:

Component

All Known Subinterfaces:

PreparableMatcher

All Known Implementing Classes:

AbstractPreparableMatcher, AbstractWildcardMatcher, AjaxRequestMatcher, CookieMatcher, HeaderMatcher, LocaleMatcher, MountTableMatcher, ParameterMatcher, RequestAttributeMatcher, RequestParameterMatcher, SessionAttributeMatcher

public interface Matcher

extends Component

Version:

CVS $Id: Matcher.java 433543 2006-08-22 06:22:54Z crossley $

Author:

Giacomo Pati

Field Summary

static String

ROLE

Method Summary

Map	match(String pattern, Map objectModel, Parameters parameters) Matches the pattern against some Request values and returns a Map object with replacements for wildcards contained in the pattern.

Field Detail

ROLE

public static final String ROLE

Method Detail

match

public Map match(String pattern,
                 Map objectModel,
                 Parameters parameters)
          throws PatternException

Matches the pattern against some Request values and returns a Map object with replacements for wildcards contained in the pattern.

Parameters:

pattern - The pattern to match against. Depending on the implementation the pattern can contain wildcards or regular expressions.

objectModel - The Map with object of the calling environment which can be used to select values this matchers matches against.

Returns:

Map The returned Map object with replacements for wildcards/regular-expressions contained in the pattern. If the return value is null there was no match.

Throws:

PatternException