Login/Register
JSTL Resource Bundle for Internationalization and Localization
Asked Answered
Solved jsplocalizationinternationalizationjstlresourcebundle
U

3

12

We have an application that using the basic JSP/servlet that all text currently in English is hard coded in the JSP pages. We are considering about internationalizations of our app, so we need some sort of ways to extract the text out into properties file.

Here is what I have done so far:
1) Create a file called XXXXX-messages_en.properties, add the key/value pair into the properties file, e.g. AAAAA = Hello World

2) Load JSTL relevant taglibs into the JSP page 

<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>

3) Replace the previous text with 

<fmt:message key="AAAAA" bundle="${XXXXX}"/>

4) Add setBundle tag into the JSP page:

<fmt:setBundle basename="XXXXX-messages" var="XXXXX"/>

And restart the server, everything is correctly displayed.

However, my question regarding the usage of JSTL internationalization library is:

QUESTION 1) It appears that I have to add <fmt:setBundle> tag into each of singe JSP pages, which is a bit ugly and if something needs to change in the future (name change?) this will make life more difficult.

I have think about maybe I can create a separate page and put this <fmt:setBundle> in it, and then include this page using <jsp:include>. Or I can inject this via a servlet filter? I would say I am not quite happy with either options.

Is there any recommended way to do this?

QUESTION 2) How to specify a default language if there is no match properties file there? I have tested in my case, if I put <fmt:setLocale> into the JSP page with a French language, the page can still loaded correctly. Does that mean the English version is always the default or is it simply because my operating system/browser is English?

What will happen if a Chinese/Japanese user open my page and I have both English and French properties file there?

Utter answered 18/9, 2012 at 5:34 Comment(0)
G
7

You can use a fallback locale to solve your second question:

If no match is found, the formatting action looks for the so-called fallback-locale configuration setting. A configuration setting is a value set either by a context parameter in the application's web.xml file or by a JSTL action or Java code in one of the JSP scopes. To set the fallback locale in the web.xml file, include these elements:

<context-param>
  <param-name>javax.servlet.jsp.jstl.fmt.fallbackLocale</param-name>
  <param-value>en</param-value>
</context-param>

http://onjava.com/onjava/2002/09/11/jstl2.html

Glycolysis answered 18/9, 2012 at 8:41 Comment(1)
I definitely read this when I google around, so how can I forget about it? My mind must out of my head at that moment. Anyway, thanks for your answer! – Utter
U
8

OK, I found the way to solve my own question 1. Basically what I need to do is put that into web.xml:

<context-param>
    <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
    <param-value>XXXXX-messages</param-value>
</context-param>

By doing this, I can save the tag of setBundle in each jsp pages.

Utter answered 18/9, 2012 at 5:47 Comment(0)
G
7

You can use a fallback locale to solve your second question:

If no match is found, the formatting action looks for the so-called fallback-locale configuration setting. A configuration setting is a value set either by a context parameter in the application's web.xml file or by a JSTL action or Java code in one of the JSP scopes. To set the fallback locale in the web.xml file, include these elements:

<context-param>
  <param-name>javax.servlet.jsp.jstl.fmt.fallbackLocale</param-name>
  <param-value>en</param-value>
</context-param>

http://onjava.com/onjava/2002/09/11/jstl2.html

Glycolysis answered 18/9, 2012 at 8:41 Comment(1)
I definitely read this when I google around, so how can I forget about it? My mind must out of my head at that moment. Anyway, thanks for your answer! – Utter
I
3

Below is the JSP template created using JSTL, may help someone incorporate JSTL Resource Bundle for Internationalization and Localization.

template.tag

<%@tag description="UI Template" pageEncoding="UTF-8"%>
<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>           
<%@attribute name="header" fragment="true"%>
<%@attribute name="footer" fragment="true"%>
<fmt:setLocale value="en" scope="session" />
<fmt:setBundle basename="resources.labels" var="label" scope="session" />
<fmt:setBundle basename="resources.messages" var="msg" scope="session" />
<html>
    <body>
        <div id="pageHeader">
            <jsp:invoke fragment="header"/>
        </div>
        <div id="body">            
            <jsp:doBody/>
        </div>
        <div id="pageFooter">            
            <jsp:invoke fragment="footer"/>
        </div>
    </body>
</html>


Below is the home.jsp file showing the header.jsp and footer.jsp included along with the body.

home.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@taglib prefix="t" tagdir="/WEB-INF/tags"%>
<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>
<!DOCTYPE html>
<t:template>
    <jsp:attribute name="header">
        <jsp:include page="../header.jsp" />
    </jsp:attribute>
    <jsp:attribute name="footer">
        <jsp:include page="../footer.jsp" />
    </jsp:attribute>
    <jsp:body>        
        <font style="font-family: Arial; font-size: 10pt; color: blue; font-weight: bold">
            <fmt:message bundle="${msg}" key="message.loginSuccess" />
        </font>
        <br/>
        <font style="font-family: Arial; font-size: 10pt; font-weight: bold">
            <fmt:message bundle="${label}" key="label.home" />
        </font>
    </jsp:body>
</t:template>


web.xml file

<context-param>
    <param-name>javax.servlet.jsp.jstl.fmt.localizationContext</param-name>
    <param-value>resources.labels</param-value>
    <param-value>resources.messages</param-value>
</context-param>
Involution answered 28/3, 2013 at 16:10 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.