| Handler for mapping or redirecting url's
Matches url's against a regexp pattern. If it matches, the url
is either rewritten or redirected.
Properties:
- match
- The regexp to match a url. May contain constructs
of the form ${xxx}, which are replaced by the value of
request.props for the key xxx
- replace
- The url to replace it with. This may contain both
regular expression sub-patterns, such as "\1", or
variables of the form ${..} which are replaced with
the equivalent request properties.
- export
- If set, use this as a properties prefix, and set
request properties for each sub-expression in "match".
(E.g. [export]1 [export]2 ...).
- redirect
- If set, the request is redirected instead of being rewritten
- ignoreCase
- If set, the case of the expression is ignored.
- source
- If set, then this string is used instead of the
url as the source of the match. Variable substitution
using ${xxx} is performed on source, which, if unset,
defaults to "${url}". If set, the request property:
"url" is set from the corrosponding field in the request
object. The source property
is obtained at init time, but evaluated (for ${...}) at every
request.
If constructs of the form !{...} are present, they are treated
the same as for ${...}, expect the values are taken from
the HTTP headers instead of from the request properties.
author:
Stephen Uhler
version:
1.16, 00/12/18 |
