bean
Tag include
Load the response from a dynamic application request and make it available as a bean.
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.
| Tag Information |
| Tag Class | org.apache.struts.taglib.bean.IncludeTag |
| TagExtraInfo Class | org.apache.struts.taglib.bean.IncludeTei |
| Body Content | empty |
| Display Name | None |
| Attributes |
| anchor |
Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| forward |
Logical name of a global ActionForward that contains the actual content-relative URI of the resource to be included. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| 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:
true |
| Request-time:
false |
Type:
java.lang.String |
|
| page |
Module-relative URI (starting with a '/') of the web application resource to be included. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| transaction |
Set to true if you want the current transaction control token included in the generated URL for this include. |
| |
| Required:
false |
| Request-time:
false |
Type:
java.lang.String |
|
| Variables |
No Variables Defined. |
Output Generated by
Tag Library Documentation Generator.
Java, JSP, and JavaServer Pages are trademarks or
registered trademarks of Sun Microsystems, Inc. in the US and other
countries. Copyright 2002-4 Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054, U.S.A.
All Rights Reserved.