This tag is used in conjunction with the <i18n:localize> tag to retrieve localized static text or messages from a JspMessageBundle for display on a page or in a Portlet.
Setting the default locale: To avoid server errors, make sure that a default locale is set on each machine running WebLogic Server.
<tagName attribute="value" />
id
Optional (String) - Holds the value of the label (or message) in the JSP. If set, this attribute is the name of the variable to hold the message as a String. If not set, the message is output to the JSP.
messageName
Required (String) - The key for the message bundle.
messageArgs
Optional (Object arguments) - The arguments to the message bundle. If no arguments are provided, it is assumed that static text (not a message) is to be returned.
For example, {"Wednesday", "78"}; might be used to construct the message “Today is Wednesday, and the temperature is 78 degrees Fahrenheit.”
bundleName
Optional (String) - If properly initialized in the <i18n:localize> tag, there is no need to pass this tag attribute unless you want to use a different bundle for a particular tag invocation. For more information on this attribute, see <i18n:localize>.
language
Optional (String) - If properly initialized in the <i18n:localize> tag, there is no need to pass this tag attribute, unless you want to use a different language for a particular tag invocation.
country
Optional (String) - If properly initialized in the <i18n:localize> tag, there is no need to pass this tag attribute, unless you want to use a different country for a particular tag invocation.
variant
Optional (String) - If properly initialized in the <i18n:localize> tag, there is no need to pass this tag attribute, unless you want to use a different variant for a particular tag invocation. The variant is used when localization demands a more specific locale than can be denoted by having just language and a country. For example, two variants for English are U.S. English and U.K. English.
locale
Optional (java.util.Locale) - If properly initialized in the <i18n:localize> tag, there is no need to pass this tag attribute, unless you want to use a different locale (language, country, and variant) for a particular tag invocation.
This example uses two messages ("greeting" and "message") in a resource bundle file called i18nExampleResourceBundle to produce this output:
"Welcome To This Page! 14 out of 100 files have been saved."
<%
// Definition of a single language preference
String language = "en";
// Creation of message arguments
Object[] args = new Object[]
{
new Integer(14),
new Integer(100)
};
%>
<i18n:localize language="<%=language%>" bundleName="Messages"/>
<html>
<body>
<i18n:getMessage messageName="greeting"/>
<i18n:getMessage messageName="message" messageArgs="<%=args%>"/>
</body>
</html>
The following code shows the entries in the property file named i18nExampleResourceBundle. properties:
greeting=Welcome To This Page!
message={0} out of {1} files have been saved.