アプリケーションサーバーが要求パラメータを正しいエンコーディングでクライアントの要求から受け取るようにするには、 tomcat コネクタを設定する必要があります。 Tomcat または JBoss AS を使用する場合は URIEncoding="UTF-8" 属性をコネクタの設定に追加します。 JBoss AS 4.2 なら ${JBOSS_HOME}/server/(default)/deploy/jboss-web.deployer/server.xml を変更します。

<Connector port="8080" URIEncoding="UTF-8"/>

別の方法もあり、 こちらの方がよいでしょう。 JBoss AS に要求パラメータのエンコーディングはその要求から取得されることを指示することができます。

<Connector port="8080" useBodyEncodingForURI="true"/>

アプリケーションのすべての メッセージ にも翻訳された文字列が必要となります (例、 ビューのフィールドラベルなど)。 まず、 リソースバンドルが目的の文字エンコーディングを使ってコード化されることを確認する必要があります。 デフォルトでは ASCII が使用されます。 ASCII は多くの言語に十分対応しますが、 すべての言語の文字を提供しているわけではありません。

リソースバンドルは ASCII で作成されなければなりません。 あるいは Unicode 文字の表示に Unicode エスケープのコードを使用します。 バイトコードに対してプロパティファイルをコンパイルしないため使用にセットする文字を JVM に伝える方法がありません。 このため、 ASCII 文字または ASCII 文字にはないエスケープ文字を使用しなければなりません。 \uXXXX を使用するといずれの Java ファイルでも Unicode 文字を表すことができます。 XXXX はその文字を表す 16 進数です。

ネイティブエンコーディングでメッセージのリソースバンドルにラベル (<xlink>ラベル</xlink>) の翻訳を書き込みそのファイルの内容を JDK で提供される native2ascii ツールでエスケープ形式に変換することができます。 このツールはネイティブエンコーディングで記述されたファイルを Unicode エスケープ配列として非 ASCII 文字で表すものに変換します。

このツールの使い方は Java 5 の場合はここ または Java 6 の場合はここ に記載されています。 たとえば、 あるファイルを UTF-8 から変換するには次のようにします。

$ native2ascii -encoding UTF-8 messages_cs.properties > messages_cs_escaped.properties

正しい文字セットを使ってローカライズされたデータとメッセージが表示されること、 そしてサブミットされるデータがすべて正しいエンコーディングを使用することを確認する必要があります。

表示文字のエンコーディングを設定するには <f:view locale="cs_CZ"/> タグを使用する必要があります (ここでは JSF にチェコ語を使用するよう指示している)。 xml にローカライズされた文字列を埋め込む場合は xml ドキュメント自体のエンコーディングを変更したいことがあります。 これを行うには xml 宣言の <?xml version="1.0" encoding="UTF-8"?> で必要に応じてエンコーディング属性を変更します。

また、 JSF や Facelet は指定文字エンコーディングを使った要求をサブミットするはずですが、 エンコーディングを指定していない場合は強制的にサーブレットフィルタを使うようにすることができます。 components.xml で設定します。

<web:character-encoding-filter encoding="UTF-8" 

   override-client="true" 

   url-pattern="*.seam" />

Seam は java.util.ResourceBundle を提供しています (アプリケーションでは org.jboss.seam.core.resourceBundle として利用可能)。 この特殊リソースバンドルを通じて国際化されたラベルを使用可能にする必要があります。 デフォルトでは、 Seam で使用されるリソースバンドルは messages の名称なので messages.properties、 messages_en.properties、 messages_en_AU.properties などの名称のファイルにラベルを定義する必要があります。 これらのファイルは通常 WEB-INF/classes ディレクトリに属します。

従って、messages_en.properties では、

Hello=Hello

そして、messages_en_AU.properties では、

Hello=G'day

org.jboss.seam.core.resourceLoader.bundleNames と呼ばれる Seam 設定プロパティによって、 リソースバンドルとして異なる名前を選択することが可能です。 リソースバンドル名の一覧を指定してメッセージの検索をさせる (深さ優先) こともできます。

<core:resource-loader>

    <core:bundle-names>

        <value>mycompany_messages</value>

        <value>standard_messages</value>       

    </core:bundle-names>

</core:resource-loader>

特定のページだけにメッセージを定義したいのであれば、 そのJSFビューIDと同じ名前でリソースバンドルに指定します。 このときIDの最初の / と最後の拡張子を除去します。 つまり /welcome/hello.jsp にのみメッセージを表示したいのであれば、 表示させるメッセージを welcome/hello_en.properties に配置します。

pages.xml に明示的なバンドル名を指定することもできます。

<page view-id="/welcome/hello.jsp" bundle="HelloMessages"/>

これで HelloMessages.properties に定義されたメッセージを /welcome/hello.jsp で使うことができます。

もし、Seamのリソースバンドルを使ってラベルを定義する場合、 各ページそれぞれに <f:loadBundle ... /> を入力しなくてもこれを使用することができます。 代わりに単に以下のように入力します。

<h:outputText value="#{messages['Hello']}"/>

または、

<h:outputText value="#{messages.Hello}"/>

さらに良いことに、メッセージそのものには EL 式を含むことも可能です。

Hello=Hello, #{user.firstName} #{user.lastName}

Hello=G'day, #{user.firstName}

コードの中にメッセージを使用することも可能です。

@In private Map<String, String> messages;

@In("#{messages['Hello']}") private String helloMessage;

facesMessages コンポーネントはユーザーに成功か失敗かを表示するとても便利な方法です。 上述した機能は、faces messages にも有効です。

@Name("hello")

@Stateless

public class HelloBean implements Hello {

    @In FacesMessages facesMessages;

    

    public String sayIt() {

        facesMessages.addFromResourceBundle("Hello");

    }

}

これは、ユーザーのロケールに応じて、Hello, Gavin King あるいは、 G'day, Gavin と表示されます。