bundle

Establishes the ResourceBundle to use for other i18n tags in the JSP. It also determines the most appropriate locale to use based on browser settings if a locale is not provided. It overrides the doEndTag( ) method and sets the ChangeResponseLocale feature to False. This tag must be placed in a JSP before any other i18n tags. This tag wraps the org.apache.taglibs.i18n.BundleTag.

Library

i18n

Tag class

com.actuate.reportcast.tags.common.BundleTag

Attributes

Table 8-3 lists and describes the attributes for bundle.

Table 8-3  Attributes for bundle 

Attribute	Required	Description
baseName	Yes	Used along with the locale to locate the desired ResourceBundle
id	No	Variable ID for use with standard jsp:getProperty tag and as an attribute to other tags in this tag library
locale	No	Current user’s locale, such as en_US, from <context root>\WEB-INF\localemap.xml
localeAttribute	No	Name of an attribute whose value is the user’s preferred locale

Variables

Table 8-4 describes the variable for bundle.

Table 8-4  Variable for bundle  

Variable	Description
id	Allows other tags or scriptlets to access the ResourceBundle defined by this tag. This is useful for allowing multiple bundle declarations per page or for creating localization debug pages by listing all key and value pairs in a bundle.

Example

The following example defines a bundle using browser preference to determine locale:

<i18n:bundle baseName="com.mycorp.taglibs.i18n.test"/>

The next example defines a bundle using browser preference to determine locale, and declaring the scripting variable bundle:

<i18n:bundle baseName="com.mycorp.taglibs.i18n.test" id="bundle"/>

The next example defines a bundle using a scriptlet variable to specify the locale:

<i18n:bundle baseName="com.mycorp.taglibs.i18n.test"locale="<%= localeVar %>"/>

Used in

<context root>\errors\error.jsp

<context root>\errors\pagenotfound.jsp

<context root>\viewer\closewindow.jsp

<context root>\viewer\print.jsp

<context root>\viewer\saveas.jsp

<context root>\viewer\searchreport.jsp

<context root>\viewer\viewreport.jsp

<context root>\viewer\waitforexecution.jsp

(c) Copyright Actuate Corporation 2011