Java国際化プログラミング - メッセージ

Java国際化プログラミング
メッセージ

'ResourceBundle'クラスは指定されたロケール(指定なしの場合はシステムロケール)に従いリソースデータを読み込み、メッセージやラベル、画像といったローカライズされたデータをユーザーロケールのものに切り替えることができます。
ResourceBundleの呼び出しのコードは以下です。

ResourceBundle wwnaviBundle = 
    ResourceBundle.getBundle("wwnavi_rs"); <-- *"wwnavi_rs"はプロパティファイルの名前です。(次のセクションを参照。)

*ResourceBundleをJSP/Servletで呼び出す場合は、HTTPリクエストのロケールを反映させなければならないので、コードの変更が必要です。詳細はサーバーサイドプログラミングを参照してください。

以下が基本的なResourceBundleの使い方です。

リソースファイル(プロパティファイル)の作成

プログラムからかき集めたメッセージはプロパティファイル(.properties)に記述します。
以下はWorld Wide Naviで作成された例です。

wwnavi_rs.properties
```
#$NLS-WWNAVI 2008-05-24T20:26:09+0900
#Sat May 24 20:26:09 JST 2008
me.tree.MainPanel.8=This is node5
me.tree.MainPanel.7=This is node4
```
*ここで注意が必要なのが、ASCII文字以外を記述する場合です。 Javaプロパティファイルには直接、非ASCII文字を記述できません。 Unicodeシーケンスとして記述します。非ASCII文字を記述するには一旦テキストファイルに記述したあと JDKのnative2asciiコマンドでpropertiesファイルに変換します。

以下は日本語をプロパティファイルにする手順です。

wwnavi_rs_ja.properties.UTF-8 (UTF-8テキストファイル)
```
#$NLS-WWNAVI 2008-05-24T20:26:09+0900
#Sat May 24 20:26:09 JST 2008
me.tree.MainPanel.8=これはノード5
me.tree.MainPanel.7=これはノード4
```
native2asciiコマンドでプロパティファイルを作成
```
native2ascii -encoding UTF-8 wwnavi_rs_ja.properties.UTF-8 \
    wwnavi_rs_ja.properties
```
wwnavi_rs_ja.properties (上記で作成されたプロパティファイル)
```
#$NLS-WWNAVI 2008-05-24T20:26:09+0900
#Sat May 24 20:26:09 JST 2008
me.tree.MainPanel.8=\u3053\u308c\u306f\u30ce\u30fc\u30c95
me.tree.MainPanel.7=\u3053\u308c\u306f\u30ce\u30fc\u30c94
```

メッセージ読み込み処理を記述する。

メッセージ読み込みのコードを文字列の位置に埋めこみます。

JOptionPane.showMessageDialog(null, 
    wwnaviBundle.getString("me.tree.MainPanel.4")); <-- *キー'me.tree.MainPanel.4'のメッセージの読み込み

.propertiesファイルを配置する。

.propertiesファイルの場所はCLASSPATHに設定されている場所に配置します。通常は読み込むクラスのパッケージのトップディレクトリと同じ場所に配置します。ファイル名は以下の規則に従います。
```
リソースバンドル名(例："wwnavi_rs") + "_" + 言語名(例："ja")
```
リソースバンドル名と同じ名前のプロパティファイルがデフォルトのリソースとなります。 (*プロパティファイルの命名規則の詳細についてはJava API Docを参照してください。)

例えば以下のような設定でクラス(MainPanel.class)を実行した場合、
```
java -cp . me.tree.MainPanel <-- *CLASSPATHはカレントディレクトリ
export LANG=ja_JP.UTF-8 <-- *言語を日本語に変更。
java -cp . me.tree.MainPanel <-- *CLASSPATHはカレントディレクトリ
```
プロパティファイルは以下に配置します。
```
me/tree/MainPanel.class <-- *クラスファイル
wwnavi_rs.properties <-- *デフォルトプロパティファイル
wwnavi_rs_ja.properties <-- *日本語プロパティファイル
```
*ResourceBundleをJSPで呼び出す場合は、デフォルトのCLASSPATHは'../WEB-INF/classes'となり、プロパティファイルもその中へ配置する必要があります。

上記はWorld Wide Navi付属のJava/JSPの文字列の外部化サンプルで確認できます。

国際化プログラミングトップへ

Copyright (C) 2012 Kokusaika JP, Inc.
本ドキュメントを無断で転載および引用することを禁じます。