Request Scope Attributes
Every request you will need to handle in your templates is preprocessed
by the
Escenic
filter chain (see
Servlet Filters), which determines
whether it is an article request (a request to view
a content item) or a section request (a request to
view a section page), and creates a corresponding set of
request scope attributes: that is, attributes of
the request scope bean, which is called requestScope
.
The request scope attributes create by the Escenic filter chain are:
Name/type/full reference | Article request | Section request |
---|---|---|
|
|
|
|
Requested content item |
Not present |
|
Section containing requested content item1 |
Requested section |
|
Section page of section containing requested content item1 |
Section page of requested section |
|
Publication containing requested content item |
Publication containing requested section |
1 "Section containing requested content item" means one of the sections in which the content item appears (usually, the section from which it has been requested), but not necessarily its home section.
The "full references" in the above table show how these attributes can
be unambiguously referenced using the JSP expression language. The
article
request scope attribute, for example, can be
referenced as follows:
${requestScope['article']}
and its title
field can be accessed as follows:
${requestScope['article'].fields.title}
You can, however, user a more compact notation to access them in most
cases. The article
request scope attribute can
usually be accessed as follows:
${article}
and its title
field can be accessed as follows:
${article.fields.title}
This shorter form is the recommended way of accessing the
Escenic
request scope attributes (referred to in the rest of this manual as the
Escenic
request beans
). Note, however, that you must then
make sure you do not create any page scope attributes with the same name
as one of the request beans. If you create a page scope attribute with
the name article
, then
${article}
will return the page scope attribute, and you will have to use the full reference notation to access the request bean.
You should not use the short notation described here to access the
escenic.com.context
request scope attribute. (You
are not allowed to use the "." character in JSP expression language
names.) Always use the full reference shown in the table above for
this attribute.