i18n在JSF 2.0应用程序中使用UTF-8编码的属性文件

时间:2010-09-05 08:37:22

标签: java jsf utf-8 internationalization jsf-2

我正在使用jsf-ri 2.0.3,需要希伯来语和俄语支持。 问题是我在屏幕上看到的是乱码而不是正确的文字。

首先,我为每种语言定义了包(* _locale.properties)。这些文件采用UTF-8编码。 其次,我在faces-config.xml

中定义了默认和支持的语言环境
<locale-config>
    <default-locale>iw</default-locale>
    <supported-locale>en</supported-locale>
    <supported-locale>ru</supported-locale>
</locale-config>

我添加了一个自定义过滤器,将响应字符编码设置为UTF-8。

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

最后当我创建一个简单的xhtml来调试输出时,我看到一个非常奇怪的结果

<f:loadBundle basename="i18n.frontend.homepage" var="msg"/>
<strong>i18n: </strong><h:outputText value="#{msg.language}"/>
<br/>
<strong>Locale: </strong>
<h:outputText value="#{facesContext.externalContext.response.locale}"/>
<br/>
<strong>Encoding: </strong>
<h:outputText value="#{facesContext.externalContext.response.characterEncoding}"/>

结果是:

i18n: ×¢×ר×ת
Locale: en_US
Encoding: UTF-8 

我的配置有什么问题?

2 个答案:

答案 0 :(得分:22)

是的,您可以创建自定义ResourceBundle或使用native2ascii转换器(如果需要,可以使用Maven 2插件使转换更加透明)。由于另一个答案仅详细介绍了最后一种方法,下面是另一个答案,您可以创建一个自定义ResourceBundle,以便在基于Java SE 1.6的环境中的JSF 2.x应用程序中将属性文件加载为UTF-8。 / p>

faces-config.xml

<application>
    <resource-bundle>
        <base-name>com.example.i18n.Text</base-name>
        <var>text</var>
    </resource-bundle>
</application>

com.example.i18n.Text

package com.example.i18n;

import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.URL;
import java.net.URLConnection;
import java.util.Enumeration;
import java.util.Locale;
import java.util.PropertyResourceBundle;
import java.util.ResourceBundle;

import javax.faces.context.FacesContext;

public class Text extends ResourceBundle {

    protected static final String BUNDLE_NAME = "com.example.i18n.text";
    protected static final String BUNDLE_EXTENSION = "properties";
    protected static final String CHARSET = "UTF-8";
    protected static final Control UTF8_CONTROL = new UTF8Control();

    public Text() {
        setParent(ResourceBundle.getBundle(BUNDLE_NAME, 
            FacesContext.getCurrentInstance().getViewRoot().getLocale(), UTF8_CONTROL));
    }

    @Override
    protected Object handleGetObject(String key) {
        return parent.getObject(key);
    }

    @Override
    public Enumeration<String> getKeys() {
        return parent.getKeys();
    }

    protected static class UTF8Control extends Control {
        public ResourceBundle newBundle
            (String baseName, Locale locale, String format, ClassLoader loader, boolean reload)
                throws IllegalAccessException, InstantiationException, IOException
        {
            // The below code is copied from default Control#newBundle() implementation.
            // Only the PropertyResourceBundle line is changed to read the file as UTF-8.
            String bundleName = toBundleName(baseName, locale);
            String resourceName = toResourceName(bundleName, BUNDLE_EXTENSION);
            ResourceBundle bundle = null;
            InputStream stream = null;
            if (reload) {
                URL url = loader.getResource(resourceName);
                if (url != null) {
                    URLConnection connection = url.openConnection();
                    if (connection != null) {
                        connection.setUseCaches(false);
                        stream = connection.getInputStream();
                    }
                }
            } else {
                stream = loader.getResourceAsStream(resourceName);
            }
            if (stream != null) {
                try {
                    bundle = new PropertyResourceBundle(new InputStreamReader(stream, CHARSET));
                } finally {
                    stream.close();
                }
            }
            return bundle;
        }
    }
}

这需要text.properties包中的text_en.propertiescom.example.i18n等UTF-8编码属性文件。不需要native2ascii。

顺便说一句,使用<resource-bundle>中的新JSF 2.0样式faces-config.xml声明,您不再需要<f:loadBundle>在视图中。所有视图中的所有文字都将由#{text}直接提供。

答案 1 :(得分:3)

嗯,经过深入调查后,我找到了解决方案。

早于java 1.6 PropertyResourceBundle只有一个构造函数,其中包含以下文档The property file read with this constructor must be encoded in ISO-8859-1. 这意味着可以在资源包中仅使用英文文本。

此问题有两种解决方案:

第一个是编写一个自定义的loadBundle组件,它将使用正确的ResourceBundle实例化方法。

第二个(我的选择)正在使用Native-to-ASCII转换器,可以使用Native2Ascii maven plugin与maven一起使用。

以下是配置示例:

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>native2ascii-maven-plugin</artifactId>
    <executions>
        <execution>
            <goals>
                <goal>native2ascii</goal>
            </goals>
            <configuration>
                <src>${basedir}/src/main/resources</src>                
                <dest>${project.build.directory}/native2ascii</dest>
                <encoding>UTF8</encoding>
                <includes>**/*.properties</includes>
            </configuration>
        </execution>
    </executions>
</plugin>