This is an example of the type of entry I'd like to see in a sitemap reference manual; see TowardsACocoonReference.
-- OwenSmith 24-Jun-2004
= Sitemap element: =match
Match the current request against a given pattern.
Included from
pipeline
Children
act, aggregate, call, generate, match, mount, parameter, read, redirect-to, select, serialize, transform
Attribute Definitions
pattern |
(Required) A pattern to match the current request against. |
type |
The name of the matcher component to use. |
Description
match is used to associate a class of website requests with the actions that need to be taken to respond to the request.
The type attribute, if specified, must be the name of a matcher component which is available through the current sitemap. That matcher will attempt to evaluate the request against the pattern expression specified in the pattern attribute, according to whatever pattern-matching rules the matcher implements. If the matcher component determines that the current request matches the given pattern, then the match element's children will be processed.
The descendants may be able to refer to matched portions of the pattern expression (TODO: explain).
If no type attribute is specified, the default matcher will be used, as defined by the default attribute of the sitemap's matchers element. The default sitemap of the Cocoon distribution uses WildcardURIMatcher as the default matcher.
See Also
matcher, pipeline, WildcardURIMatcher