1.3 1.2 bean http://struts.apache.org/tags-bean-el <%@ page %> directive. If you wish to process the actual exception that caused the problem, it is passed to the error page as a request attribute under key org.apache.struts.action.EXCEPTION.If you are viewing this page from within the Struts Documentation Application (or online at http://struts.apache.org), you can learn more about using these tags in the Bean Tags Developer's Guide. ]]> include org.apache.strutsel.taglib.bean.ELIncludeTag org.apache.struts.taglib.bean.IncludeTei empty 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 scoped variable 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.
]]> anchor false true Optional anchor tag ("#xxx") to be added to the generated hyperlink. Specify this value without any "#" character.

]]> forward false true Logical name of a global ActionForward that contains the actual content-relative URI of the resource to be included.

]]> href false true 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.

]]> id true false 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.

]]> page false true Module-relative URI (starting with a '/') of the web application resource to be included.

]]> transaction false true Set to true if you want the current transaction control token included in the generated URL for this include.

]]> message org.apache.strutsel.taglib.bean.ELMessageTag empty Render an internationalized message string to the response.

Retrieves an internationalized message for the specified locale, using the specified message key, and write it to the output stream. Up to five parametric replacements (such as "{0}") may be specified.

The message key may be specified directly, using the key attribute, or indirectly, using the name and property attributes to obtain it from a bean.

JSTL: The equivalent JSTL tag is <fmt:message>. For example,
<fmt:message key="my.msg.key"> <fmt:param value="replacement text"/> </fmt:message>

]]> arg0 false true First parametric replacement value, if any.

]]> arg1 false true Second parametric replacement value, if any.

]]> arg2 false true Third parametric replacement value, if any.

]]> arg3 false true Fourth parametric replacement value, if any.

]]> arg4 false true Fifth parametric replacement value, if any.

]]> bundle false true The name of the application scope bean under which the MessageResources object containing our messages is stored.

]]> key false true The message key of the requested message, which must have a corresponding value in the message resources. If not specified, the key is obtained from the name and property attributes.

]]> locale false true The name of the session scope bean under which our currently selected Locale object is stored.

]]> name false true Specifies the attribute name of the bean whose property is accessed to retrieve the value specified by property (if specified). If property is not specified, the value of this bean itself will be used as the message resource key.

]]> property false true Specifies the name of the property to be accessed on the bean specified by name. This value may be a simple, indexed, or nested property reference expression. If not specified, the value of the bean identified by name will itself be used as the message resource key.

]]> scope false true Specifies the variable scope searched to retrieve the bean specified by name. If not specified, the default rules applied by PageContext.findAttribute() are applied.

]]> page org.apache.strutsel.taglib.bean.ELPageTag empty Expose a specified item from the page context as a bean.

Retrieve the value of the specified item from the page context for this page, and define it as a scripting variable, and a page scope attribute accessible to the remainder of the current page.

If a problem occurs while retrieving the specified configuration object, a request time exception will be thrown.

]]> id true false Specifies the name of the scripting variable (and associated page scope attribute) that will be made available with the value of the specified page context property.

]]> property true true Name of the property from our page context to be retrieved and exposed. Must be one of application, config, request, response, or session.

]]> resource org.apache.strutsel.taglib.bean.ELResourceTag org.apache.struts.taglib.bean.ResourceTei empty Load a web application resource and make it available as a bean.

Retrieve the value of the specified web application resource, and make it available as either a InputStream or a String, depending on the value of the input attribute.

If a problem occurs while retrieving the specified resource, a request time exception will be thrown.

]]> id true false 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.

]]> input false true If any arbitrary value for this attribute is specified, the resource will be made available as an InputStream. If this attribute is not specified, the resource will be made available as a String.

]]> name true true Module-relative name (starting with a '/') of the web application resource to be loaded and made available.

]]> size org.apache.strutsel.taglib.bean.ELSizeTag org.apache.struts.taglib.bean.SizeTei empty Define a bean containing the number of elements in a Collection or Map.

Given a reference to an array, Collection or Map, creates a new bean, of type java.lang.Integer, whose value is the number of elements in that collection. You can specify the collection to be counted in any one of the following ways:

  • As a runtime expression specified as the value of the collection attribute.
  • As a JSP bean specified by the name attribute.
  • As the property, specified by the property attribute, of the JSP bean specified by the name attribute.
]]> collection false true A runtime expression that evaluates to an array, a Collection, or a Map.

]]> id true false The name of a page scope JSP bean, of type java.lang.Integer, that will be created to contain the size of the underlying collection being counted.

]]> name false true The name of the JSP bean (optionally constrained to the scope specified by the scope attribute) that contains the collection to be counted (if property is not specified), or whose property getter is called to return the collection to be counted (if property is specified.

]]> property false true The name of the property, of the bean specified by the name attribute, whose getter method will return the collection to be counted.

]]> scope false true The bean scope within which to search for the JSP bean specified by the name attribute. If not specified, the available scopes are searched in ascending sequence.

]]> struts org.apache.strutsel.taglib.bean.ELStrutsTag org.apache.struts.taglib.bean.StrutsTei empty Expose a named Struts internal configuration object as a bean.

Retrieve the value of the specified Struts internal configuration object, and define it as a scripting variable and as a page scope attribute accessible to the remainder of the current page. You must specify exactly one of the formBean, forward, and mapping attributes to select the configuration object to be exposed.

If a problem occurs while retrieving the specified configuration object, a request time exception will be thrown.

]]> id true false Specifies the name of the scripting variable (and associated page scope attribute) that will be made available with the value of the specified Struts internal configuration object.

]]> formBean false true Specifies the name of the Struts ActionFormBean definition object to be exposed.

]]> forward false true Specifies the name of the global Struts ActionForward definition object to be exposed.

]]> mapping false true Specifies the matching path of the Struts ActionMapping definition object to be exposed.

]]>