はじめに

本稿は、Java Goldの学習のまとめとして以下項目についてまとめる。
（同じくJava Goldを学習中やローカライズについて知りたい方の参考になればと。）

ロケール
リソースバンドル

ロケールとは

java.util.Locale

言語や国ごとに異なるものの表記規則を示す。
＃例：単位・記号・日付・通貨など

アプリケーションを使用した国毎に、表示を変えたい場合などにロケールを利用する。
（アプリを使用する国によって文字を日本語・英語と分けたり等）

インスタンス生成方法は主に以下3種類ある。

new
Localクラスの定数
getDefault()メソッド

■ 主なコンストラクタ・メソッド

コンストラクタ	内容
Local(String language, String country)	引数の言語/国コードからオブジェクトを生成

// newによるインスタンス生成
// ja・en：言語名コード ｜ JP・US：国名コード
Locale localeJp = new Locale("ja","JP");  // 日本のロケール
Locale localeUs = new Locale("en","US");  // アメリカのロケール

// Localeクラスの定数によるインスタンス生成
Locale localeJp = Locale.JAPAN;
Locale localeUs = Locale.US;

// getDefault()メソッドによるインスタンス生成
// 日本で実行すると日本のLocaleインスタンスが生成される
Locale localeJp = Locale.getDefault();

メソッド	内容
static getDefault()	デフォルトロケールの現在の値を取得
final String getDisplayCountry()	ロケールの国名を返却
final String getDisplayLanguage()	ロケールの言語名を返却
String getCountry()	ロケールの国名コードを返却
String getLanguage()	ロケールの言語名コードを返却

// ja_JP が格納される（OSが日本の場合）
Locale locale = Locale.getDefault();

// 日本 が格納される
String country = locale.getDisplayCountry();

// 日本語 が格納される
String language = locale.getDisplayLanguage();

// JP が格納される
String country_code = locale.getCountry();

// ja が格納される
String language_code = locale.getLanguage();

// 備考：他のインスタンス生成方法
Locale locale = new Locale.Builder().setLanguage("ja")
                                    .setScript("Jpan")
                                    .setRegion("JP")
                                    .build();
// setScript()：引数はISO 15924 alpha-4スクリプトコード（Javadoc参照）
// build()：Locale.Builderのメソッドで、Localオブジェクトを生成

リソースバンドル

java.util.ResourceBundle

言語や国ごとに異なる表記規則をロケールに応じて対応させる。
これによりロケールに応じて日本表記や英語表記を切り替えることが出来る。

主に使用するメソッドは以下の通り。

メソッド	内容
boolean containsKey(String key)	引数で指定されたキーがリソースにある場合はtrueを返却
final Object getObject	引数で指定されたキーに紐づくオブジェトを返却
final String getString(String key)	引数で指定されたキーに紐づく文字列を返却
final String[] getStringArray(String key)	引数で指定されたキーに紐づく文字列の配列を返却
Set keySet()	バンドルに含まれるすべてのキーを返却

また、サブクラスとして以下がある。

サブクラス	内容
ListResourceBundle	ロケール用のリソースを便利かつ使いやすいリストで管理
PropertyResourceBuilder	プロパティファイルからの一連のstatic文字列を使用してロケール用のリソースを管理

■ ListResourceBundleを使用する場合

こちらを使用する場合の定義ルールは以下の通り。

定義方法
* ListResourceBundleを継承したpublicクラスを作成する
* getContents()メソッドをオーバーライドして配列でリソースのリストを作成する
* リソースは、キーと値を要素とする配列として作成

※ 引用

▼ 実装例

Resource.java

public class Resource extends ListResourceBundle {

	public Object[][] getContents() {
		Object[][] contents = {
				{"apple", "リンゴ"},
				{"orange", "オレンジ"}
		};
		return contents;
	}
}

Resource_en_US.java

public class Resource_en extends ListResourceBundle {

	protected Object[][] getContents() {
		Object[][] contents = {
				{"apple", "apple"},
				{"orange", "orange"}
		};
		return contents;
	}
}

基底名_言語コード_国コード.javaとすることでロケール
のオブジェクトに対応した言語のファイルが参照される。

デフォルトのロケールインスタンスの場合は基底名のリソースが参照される。
また、ロケールのインスタンスに言語コードのみ指定した場合は、基底名の後に言語コードのみで良い。

Main.java


// 出力結果は以下の通り
// リンゴ:オレンジ
// apple:orange

class Main {
	public static void main(String[] args) {

		Locale localeJa = Locale.JAPAN;
		Locale localeUs = Locale.US;

		// 第二引数の指定がない場合デフォルトロケートを指定する
		List<Locale> locales =
				new ArrayList<Locale>(Arrays.asList(localeJa, localeUs));

		for(Locale locale : locales) {
			// パッケージ名.ファイル名を指定
			ResourceBundle rb =
				ResourceBundle.getBundle("resource.Resource", locale);

			// String以外を取得する場合はgetObjectメソッドを使用してキャストする
			System.out.println(rb.getString("apple") + ":" + rb.getString("orange"));
		}
	}
}

■ PropertyResourceBuilderを使用する場合

こちらを使用する場合の定義ルールは以下の通り。

プロパティファイル名は、基底名_言語コード_国コード.properties
リソースのキーと値はプロパティファイル内にキー = 値の形の形で記載

▼ 実装例

Source.properties

apple=J_apple
orange=J_orange

Source_en_US.properties

apple=U_apple
orange=U_orange

Main.java


// 出力結果
// J_appleJ_orange
// U_appleU_orange

class Main {
	public static void main(String[] args) throws MalformedURLException {

        File dicDir = Paths.get(".\\resource").toFile();

        URLClassLoader urlLoader;
        urlLoader = new URLClassLoader(new URL[]{dicDir.toURI().toURL()});

		Locale localeJp = Locale.JAPAN;
		Locale localeUs = Locale.US;

		List<Locale> locales =
				new ArrayList<Locale>(Arrays.asList(localeJp, localeUs));

		for (Locale locale : locales) {
			// ファイル名のみ指定
			ResourceBundle rb =
					ResourceBundle.getBundle("Source" ,locale ,urlLoader);

			System.out.println(rb.getString("apple") + rb.getString("orange"));

		}
	}
}

参考文献