Struts 2 with i18n example Tutorial

The i18n interceptor provides multi-lingual support for your application.

It handles setting locale for the action. It can be used if user wants to set his/her locale and get data according to the locale provided.

It is found in the defaultStack bydefault, so you don't have to specify it explicitly.

Parameters of i18n interceptor

There are 2 parameters defined for i18n interceptor. Both are optional.

Parameter	Description
parameterName	It specifies the name of the HTTP request parameter. It is set to request_locale bydefault.
attributeName	specifies the name of the session key to store the locale. It is WW_TRANS_I18N_LOCALE bydefault.

Example of i18n interceptor

In this example, we are creating following pages :

Login.java
Login_en.properties and Login_hi.properties
struts.xml
index.jsp
login-success.jsp

1) Create the action class

To use the i18n interceptor, you need to extend the ActionSupport class that implements TextProvider.

Login.java

package com.trainingtrains;
import com.opensymphony.xwork2.ActionSupport;

public class Login extends ActionSupport{
private String name;
public String getName() {
	return name;
}
public void setName(String name) {
	this.name = name;
}
public String execute(){
		return SUCCESS;
}
}

2) Create properties files

Now create 2 properties file inside the package. Its name should be actionname_languagecode.properties.

Login_en.properties

Login_hi.properties

3) Create index.jsp for input

This jsp page creates a form using struts UI tags. It receives name from the user.

index.jsp

<%@ taglib prefix="s" uri="/struts-tags" %>

<s:form action="login">
<s:textfield name="name" label="Name"></s:textfield>
<!-- 
<s:textfield name="request_locale" label="Language Code"></s:textfield>
 -->
<s:submit></s:submit>
</s:form>

Define action in struts.xml

struts.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
<package name="abc" extends="struts-default" >

<action name="login" class="com.trainingtrains.Login" method="execute">
<result name="success">/login-success.jsp</result>
</action>

</package>
</struts>    

4) Create view component

Now use text tag to get the data. It is used in i18n.

login-success.jsp

<%@ taglib uri="/struts-tags" prefix="s" %>
Welcome, <s:property value="name"/>
<br>
Message is: <s:text name="login.msg"></s:text>

Directory Structure in Eclipse IDE

download this example developed in Eclipse IDE (without jar)

download this example developed in Myeclipse IDE

Output

Now let's change the language code. Here, we are using chrome browser.

Click on the settings.

Now, click on the show advanced settings.

Now, click on the language and input settings.

Now, add hindi language and move it to the top side and then click on done.

If again, you run the application, it will show hindi message.

If you use request_locale property name in index.jsp file, message will be shown according to the given language code.

<%@ taglib prefix="s" uri="/struts-tags" %>

<s:form action="login">
<s:textfield name="name" label="Name"></s:textfield>
<s:textfield name="request_locale" label="Language Code"></s:textfield>
<s:submit></s:submit>
</s:form>

Let's see the output.