How to Internationalize Basic JSP/Servlet Web Applications (i18n)

In this article, we will explore the possibility of internationalizing a basic JSP/Servlet Web Application. At first, we will learn how to use JSTL Taglib to localize a JSP page. Furthermore, we will demonstrate the use of request parameter, session attribute, and the cookie value to choose a preferred language in a JSP page. Besides, we will use Maven to set up the project. Hence, we expect the reader has a basic knowledge of Java Web Application, JSP, JSTL, and Maven.

Kindly be noted that we can find the full implementation of this article on Phrase Github.

1. Project Setup

For this simple JSP/Servlet Web Application, we only need to add jstl and javax.servlet-api dependencies into our pom.xml file:

We can find the latest version of those dependencies on Maven Central: jstl, javax.servlet-api

2. Localize A JSP Page

The basic approach to localize a JSP page is using JSTL in combination with resource bundles. Resource bundles are properties files which contain key-value pairs. Each value is a message which we want to show on the page. Whereas the key will be used to refer to that value on our JSP page. Thus, for each supported language, we will have one specific properties file.

Now, let’s create a default file under src/main/resources as below:

Next, we create a welcome.jsp page and put under /webapp folder:

In this page, we use <fmt:setBundle> tag to set the resource bundle

Because our resource bundle file is, thus, we set the value of basename attribute as messages. Moreover, we use <ftm:message> tag to refer to the defined key in our properties file.

Deploy the project on an Application Server (Tomcat 8.5 at port 8080 in this case) and access welcome.jsp page, we will see below result:

Since we haven’t mentioned which locale we want to use for the page, the message in default file is used.

Now, we try to support the French language by adding another resource bundle file which is as below:

Then, we modified the welcome.jsp page to use this new language:

Here, by using <fmt:setLocale> tag to set the preferred locale to fr, the new file will be used when we load the page. Consequently, we will see below result:

Until here, we can notice that the name of resource bundle properties file will have below format:

Thereupon, we can support other languages, for example, Chinese and German by adding and

It’s worth to note that if we set the locale to a non-existing resource bundle file, the application will use the file as default for displaying.

3. Choosing Locale Dynamically

We have explored how to set a preferred locale for a JSP page. It would be useful if we know how to do this dynamically. In this section, we will see how to set a page locale by using request parameter, session attribute, and browser cookie.

3.1. Using Request Parameter As Locale

Let’s create the requestLocale.jsp as below:

In this page, we set the locale to the value of request parameter lang. Thus, when accessing the page which the parameter lang=zh, we will see below result:

3.2. Using Session Attribute As Locale

Likewise, to set the locale by using a session attribute, we can implement sessionLocale.jsp as below:

In this example, we refer to attribute lang in sessionScope as preferred locale.

Therefore, let’s create a SessionLocaleFilter to allow us updating the session attribute lang:

This filter will check if the request parameter sessionLocale is available for the incoming request. If yes, the filter will update the attribute lang of the current session to that value.

Now, let’s create a changeLocale.jsp page to help us update this session attribute:

Then, we can run the application to access this changeLocale.jsp page and choose the German language. After that, we open our sessionLocale.jsp to see the result as below:

3.3. Using Browser Cookie As Locale

Accordingly, using the same method, we can implement a page which uses the value of a browser cookie as locale. Thus, we have below cookieLocale.jsp page:

Suppose that we store the locale in the cookie by the key lang. Hence, we access this cookie value by using the expression cookie[‘lang’].value. Thus, our page will use that value as preferred locale.

Furthermore, we need to create a CookieLocaleFilter which helps us changing browser cookie value before we can test our page:

For each incoming request, the above filter will check if a parameter cookieLocale is available. If yes, its value will be set to browser cookie with the key lang.

Again, let’s update the changeLocale.jsp to allow us changing this cookie value:

Similarly, let’s run the application and open this changeLocale.jsp to choose Chinese as cookie locale. Then we can access cookieLocale.jsp to view the result:

4. Conclusion

In this article, we have explored how to localize a JSP page on a basic Java Web Application. Moreover, we also learn how to choose locale dynamically by using request parameter, session attribute, and browser cookie.

Our approach is using JSTL in combination with resource bundle where we use <ftm:setLocale> and <ftm:setBundle> to refer to a resource bundle properties file.

Please view our Github repository for full implementation of this article.

If you are interested in the advanced topic regarding Internationalization and Localization of Java Web Application, please check out other blog posts such as Spring MVC I18N.

How to Internationalize Basic JSP/Servlet Web Applications (i18n)
5 (100%) 10 votes
Linh Phrase Content Team