Perform an internal dispatch to the specified application component
(or external URL)
and make the response data from that request available as a bean of
type String
. This tag has a function similar to that of
the standard <jsp:include>
tag, except that the
response data is stored in a page scope attribute instead of being
written to the output stream. If the current request is part of a
session, the generated request for the include will also include the
session identifier (and thus be part of the same session).
The URL used to access the specified application component is
calculated based on which of the following attributes you specify
(you must specify exactly one of them):
-
forward - Use the value of this attribute as the name
of a global
ActionForward
to be looked up, and
use the module-relative or context-relative URI found there.
-
href - Use the value of this attribute unchanged (since
this might link to a resource external to the application, the
session identifier is not included.
-
page - Use the value of this attribute as an
module-relative URI to the desired resource.
Attribute Name |
Description |
anchor |
Optional anchor tag ("#xxx") to be added to the generated
hyperlink. Specify this value without any
"#" character.
[RT Expr]
|
forward |
Logical name of a global ActionForward that contains
the actual content-relative URI of the resource to be included.
[RT Expr]
|
href |
Absolute URL (including the appropriate protocol prefix such as
"http:") of the resource to be included. Because this URL could be
external to the current web application, the session identifier will
not be included in the request.
[RT Expr]
|
id |
Specifies the name of the scripting variable (and associated page
scope attribute) that will be made available with the value of the
specified web application resource.
[Required]
|
name |
Module-relative name (starting with a '/') of the web application
resource to be dispatched, and whose response data is to be made
available as a bean.
DEPRECATED:
Use the "page" attribute instead.
[RT Expr]
|
page |
Module-relative URI (starting with a '/') of the web application
resource to be included.
[RT Expr]
|
transaction |
Set to true if you want the current
transaction control token included in the generated
URL for this include.
[RT Expr]
|