| Template (and handler) class for Setting a value into the request props.
This class is used by the TemplateHandler.
The tag<set> is processed with the following
attributes:
- name=value
- The name of the entry to set in the request properties.
- value=value
- The value to set. If no value is provided, any existing value
is removed.
- local
- By default, variables are set (or removed from)
a namespace that is persistent across all requests for the same session.
if local is specified, the values only remain for the
duration of the current request.
Request Properties:
- sessionTable
- The name of the SessionManager table to use for
storing values. Defaults to the handler's prefix.
- debug
- If set, the original tag is included in a comment,
otherwise it is removed entirely.
- mustMatch
- Set to a glob pattern that all names must match
in order to be set. This may be used to prevent malicious
html pages (what a concept) from changing inappropriate
values.
- querySet
- If set, then properties may be set in query
parameters, to the "handler" portion, but only
if they match the glob pattern.
Normally, any persistent properties held by the SetTemplate are
chained onto the request.props when the init method is found. If this
template is installed as an up-stream handler, then the persistent
properties associated with the session are made available at that time.
When used as a handler, the following property is used:
- session=value
- The request property to find the session information in.
Normally this should be the same as the session property used
by the container calling this as a template.
author:
Stephen Uhler
version:
%V% SetTemplate.java 1.9 |
