8. View web pages in different locale at design-time and run-time

During developing the internationalized application, sometimes it is necessary to view the JSP pages in the different languages to fix the localization and web design issues related to internationalization.

Workshop's JSF support includes design time support for localization resource bundles.

8.1. Configure the application for French

1. Open the JSF configuration file faces-config.xml.
2. Locate the <application> element specifying resource bundle and default locale for the application.
3. In <locale-config> element add <supported-locale> element for French locale as shown below in bold text.

<application>   <message-bundle>resources.application</message-bundle>   <locale-config>     <default-locale>en</default-locale>     <supported-locale>fr_FR</supported-locale>   </locale-config> </application>

4. Save the faces-config.xml file.
5. You need to create the properties file with key-value pairs for French language support. You can import the file application_fr_FR.properties from the folder workshop-JSF-tutorial/web/Resources to the resources package.
6. Close the Eclipse IDE and open it again.
   

8.2. Localize the view at design time

1. Open register.jsp
2. In Eclipse main menu bar select Text > Resource Locale... The Resource Locale dialog is displayed, allowing you to select configured locales for the web application.



3. Select the French (France) locale and click OK.
4. Reset the Resource Locale to English language.

8.3. Localize the view at design time [Optional]

The locale-config element in faces-config.xml lists the default locale and the other supported locales. The locale-config element enables the system to find the correct locale based on the browser's language settings. In register.jsp page we will manually set the French locale to override these settings.

1. Open register.jsp and write following lines of code after the tag libraries definitions and before the <f:loadBundle> tag.

<%   javax.faces.context.FacesContext ctx =javax.faces.context.FacesContext.getCurrentInstance( );   ctx.getViewRoot( ).setLocale(new java.util.Locale("fr", "FR")); %>

2. Save the register.jsp page and run the application on server.
3. It displays application component labels and messages in French.

   

4. Comment (/* … */) the above code which sets the French locale manually and save the register.jsp page.
5. Refresh the register.jsf page in Web browser and verify that it displays the application in English language.
6. Stop the server.

Click one of the following arrows to navigate through the tutorial: