当前位置: 首页 > 文档资料 > JSF 入门教程 >

国际化(Internationalization)

优质
小牛编辑
114浏览
2023-12-01

国际化是一种技术,其中状态消息,GUI组件标签,货币,日期不在程序中硬编码。 相反,它们存储在资源包中的源代码之外并动态检索。 JSF提供了一种处理资源包的非常方便的方法。

需要以下步骤来内化JSF应用程序。

第1步:定义属性文件

为每个区域设置创建属性文件。 名称应为 _ .properties格式。

文件名中可以​​省略默认语言环境。

messages.properties

greeting = Hello World!

messages_fr.properties

greeting = Bonjour tout le monde!

第2步:更新faces-config.xml

faces-config.xml

<application>
   <locale-config>
      <default-locale>en</default-locale>
      <supported-locale>fr</supported-locale>
   </locale-config>
   <resource-bundle>
      <base-name>cn.xnip.messages</base-name>
      <var>msg</var>
   </resource-bundle>
</application>

第3步:使用resource-bundle var

home.xhtml

<h:outputText value = "#{msg['greeting']}" />

例子 Example Application

让我们创建一个测试JSF应用程序来测试JSF中的国际化。

描述
1cn.xnip.test包下创建一个名为helloworld的项目,如JSF - First Application一章中所述。
2src → mai文件夹下创建resources文件夹。
3src → main → resources文件夹下创建com文件夹。
4src → main → resources → com文件夹下创建xnip文件夹。
5src → main → resources → com → xnip文件夹下创建messages.properties文件。 按照以下说明修改它。
6src → main → resources → com → xnip文件夹下创建messages_fr.properties文件。 按照以下说明修改它。
7WEB-INFf创建faces-config.xml ,如下所述。
8在包cn.xnip.test下创建UserData.java ,如下所述。
9修改home.xhtml ,如下所述。 保持其余文件不变。
10编译并运行应用程序以确保业务逻辑按照要求运行。
11最后,以war文件的形式构建应用程序并将其部署在Apache Tomcat Webserver中。
12使用适当的URL启动Web应用程序,如下面的最后一步所述。

messages.properties

greeting = Hello World!

messages_fr.properties

greeting = Bonjour tout le monde!

faces-config.xml

<?xml version = "1.0" encoding = "UTF-8"?>
<faces-config
   xmlns = "http://java.sun.com/xml/ns/javaee"
   xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
   version = "2.0">
   <application>
      <locale-config>
         <default-locale>en</default-locale>
         <supported-locale>fr</supported-locale>
      </locale-config>
      <resource-bundle>
         <base-name>cn.xnip.messages</base-name>
         <var>msg</var>
      </resource-bundle>
   </application>
</faces-config>

UserData.java

package cn.xnip.test;
import java.io.Serializable;
import java.util.LinkedHashMap;
import java.util.Locale;
import java.util.Map;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import javax.faces.context.FacesContext;
import javax.faces.event.ValueChangeEvent;
@ManagedBean(name = "userData", eager = true)
@SessionScoped
public class UserData implements Serializable {
   private static final long serialVersionUID = 1L;
   private String locale;
   private static Map<String,Object> countries;
      static {
      countries = new LinkedHashMap<String,Object>();
      countries.put("English", Locale.ENGLISH);
      countries.put("French", Locale.FRENCH);
   }
   public Map<String, Object> getCountries() {
      return countries;
   }
   public String getLocale() {
      return locale;
   }
   public void setLocale(String locale) {
      this.locale = locale;
   }
   //value change event listener
   public void localeChanged(ValueChangeEvent e) {
      String newLocaleValue = e.getNewValue().toString();
      for (Map.Entry<String, Object> entry : countries.entrySet()) {
         if(entry.getValue().toString().equals(newLocaleValue)) {
            FacesContext.getCurrentInstance()
               .getViewRoot().setLocale((Locale)entry.getValue());         
         }
      }
   }
}

home.xhtml

<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns = "http://www.w3.org/1999/xhtml"   
xmlns:h = "http://java.sun.com/jsf/html"
xmlns:f = "http://java.sun.com/jsf/core">
   <h:head>
      <title>JSF tutorial</title>	 	
   </h:head>
   <h:body> 
      <h2>Internalization Language Example</h2>
      <h:form>
         <h3><h:outputText value = "#{msg['greeting']}" /></h3>
         <h:panelGrid columns = "2"> 
            Language : 
            <h:selectOneMenu value = "#{userData.locale}" onchange = "submit()"
               valueChangeListener = "#{userData.localeChanged}">
               <f:selectItems value = "#{userData.countries}" /> 
            </h:selectOneMenu> 
         </h:panelGrid> 
      </h:form>
   </h:body>
</html>

一旦准备好完成所有更改,让我们像在JSF - First Application章节中那样编译和运行应用程序。 如果您的应用程序一切正常,这将产生以下结果。

JSF国际化结果

从下拉列表中更改语言。 您将看到以下输出。

JSF国际化结果1