Localization of Web Modules

Localization of Web Modules

You can localize iPlanet Application Server web modules using Forte for Java. In this section, you will create an application that will ask the user's prefered language and name and display "hello" message in the prefered language.

Making the web application display in a new language, other than the languge it was initially developed on, involves 3 separate tasks. First, I18N support must be enabled on iPlanet Application Server. Second, you need to write the application to output in a new language, including creating localized JSP pages for existing JSP pages. Third, ias-web.xml deployment descriptor should be updated.

Enabling I18N support on iPlanet Application Server

To use built-in support for internationalization, you must turn it on first. The detailed information of this topic can be found in Administrator's Guide book of iPlanet Application Server. In this subsection, you will use the Administration Tool to enable the internationalization support. To enable it:

From the Explorer window, select the Runtime tab.

Select to expand the Server Registry node and Installed Servers node.

if the iPlanet Application Server node is not displayed under the Installed Servers node, then the integration modules is not installed or it is not enabled.

Right click on the iPlanet Application Server 6.5 node to display context menu and select the Launch Admin Tool option.
Select the iAS1 node in the Administrator Tool.
Check the Enable I18N Support checkbox.

If you have enabled I18N Support during the installation, the checkbox should already be checked when you selected the iAS1 node. In this case, you may close the Administration Tool window and skip the rest of steps in this subsection.

Select Apply Changes button.

You will be prompted to restart the iPlanet Application Server.

Select OK to dismiss the dialog.

On a Solaris system, navigate to the iASInstallDir\ias\bin\ path, and run the following two scripts:

iascontrol kill -instance -user -password -host -port iascontrol start -instance -user -password -host -port

On Windows, run the following two commands:

iascontroll kill iascontrol start

iPlanet Application Server will now stop and start again.

Creating a Localized Web Application

You will now create an web application that prints hello in English and Japanese. The application consists of four files. The first page, named Hello2.jsp, asks for the prefered language and the user's name. When users select the submit button, a servlet, named Hello2Servlet, receives the request and redirects it to either LocalHello.jsp or LocalHello_ja.jsp depending on the language specified. As the name suggets, LocalHello_ja.jsp will output the Japanese greeting.

The files will be included in the web module that was created in the Creating a JavaServer Page section of this tutorial. To create the application:

Create Hello2.jsp in the D:\MyWebModules\WebModule directory.

See Creating a JavaServer Page for details.

Change the Hello2.jsp to as follows:

<%@page contentType="text/html"%>
<html>
<head><title>JSP Page</title></head>
<body>
<h2>Multilingual</h2>
<FORM ACTION="servlet/myPackage/Hello2Servlet" METHOD="post" NAME="Form1">
Select preferred language: <br>
<SELECT NAME="locale" SIZE="3">
<OPTION selected value="">None</OPTION>
<OPTION          value="en">English</OPTION>
<OPTION          value="ja">Japanese</OPTION>
</SELECT><br><br>
Enter your name:<br>
<input TYPE="text" NAME="name" SIZE="30">
<input TYPE="SUBMIT" NAME="ok" VALUE="submit">
</FORM>
</body>
</html>

Save the Hello2 page with File | Save from the menu.

Create Hello2Servlet.java in the WEB-INF/Classes/myPackage node.

Change the processRequest method as follows:

protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, java.io.IOException {
   String locale = request.getParameter("locale");
   String name = request.getParameter("name");
   request.setAttribute("name", name);
   com.kivasoft.util.GX.SetLocale(locale);
   RequestDispatcher dispatcher = getServletContext().getRequestDispatcher("/LocalHello.jsp");
   dispatcher.forward(request, response);
}

Save Hello2Servlet.java with File | Save from the menu.
From the File menu, select Mount Filesystem...

Select Add JAR File and select the Browse... button.

Navigate to the iASInstallDir\ias\classes\java\ directory and select kfcjdk11.jar. Select OK to close the dialog window.

The com.kivasoft.util.GX package, used in the processRequest method in Hello2Servlet.java, is included in kfcjdk11.jar. The JAR file is mounted so that the servlet can be compiled in the IDE.

Click OK to mount the JAR file.

Create LocalHello.jsp in the D:\MyWebModules\WebModule directory.

This JSP page will output a message in the English language.

Change the LocalHello.jsp as follows:

<%@page contentType="text/html; charset=UTF8"%>
<html>
<head><title>English Hello Page</title></head>
<body>
<p><h2>Hello, <%= request.getAttribute("name") %>!</h2></p>
</body>
</html>

Save LocalHello.jsp with File | Save from the menu.

The page must be saved in UTF-8 encoding.

Create LocalHello_ja.jsp in the D:\MyWebModules\WebModule directory.

This JSP page will output a message in the Japanese language.

Change the LocalHello_ja.jsp as follows:

You can download the code by right-clicking on the code above and selecting Save Link As...

Save LocalHello_ja.jsp with File | Save from the menu.

The page must be saved in UTF-8 encoding.

Updating the Deployment Descriptor

In this subsection, you will specify English as a default language and choose UTF8 as an encoding scheme for both Japanese and English languages in the deployment descriptor. To update the deployment descriptor:

Expand WEB-INF node.

Right click on the web.xml node, and select Properties from the Context munu.

In the Properties of the web.xml dialog window, select the iPlanet AS tab.

Select the button for Locale Charet Map field.

Select the Add button.

Select en for Locale and UTF8 for Charset.

Select OK to dismiss the dialog window.

Select the Add button again.

Select ja for Locale and UTF8 for Charset.

Select OK to dismiss the dialog window.

The Property Editor: Locale Charset Map window should contain the two entries you just created.

Select OK.

In the Properties of the web.xml dialog window, select en for Default locale.

Close the window.

Deploying and Running the Application

Now, the application is ready to be deployed and run.

Right click on WEB-INF node, and select Deploy from the context menu.

Right click on the Hello2 JSP node in the Explorer window, and select Execute.

The browser opens to the http://serverinstance/NASApp/WebModule/Hello2.jsp URL.

If you select None for the preferred language and submit your name, you will see the greeting in English as it was selected to be the default locale. If you select Japanese, the browser displays the greeting in Japanese, as shown below. You might have to configure the system before the Japanese characters are displayed properly.

The next step in the iPlanet Application Server Integration Module Tutorial is creating a session Enterprise Java Bean.

Legal Notices