java.util

クラス PropertyResourceBundle

java.lang.Object

java.util.ResourceBundle

java.util.PropertyResourceBundle

public class PropertyResourceBundle
extends ResourceBundle

PropertyResourceBundle は、プロパティーファイルからの一連の static 文字列を使用してロケール用のリソースを管理する、ResourceBundle の具象サブクラスです。リソースバンドルの詳細については、ResourceBundle を参照してください。

ほかのタイプのリソースバンドルと違い、PropertyResourceBundle はサブクラス化されません。代わりに、リソースデータを格納するプロパティーファイルを提供します。ResourceBundle.getBundle は、自動的に適切なプロパティーファイルを探し、そのファイルを参照する PropertyResourceBundle を作成します。検索とインスタンス化の方法の詳細は、ResourceBundle.getBundle を参照してください。

次の例では、ベース名「MyResources」のリソースバンドルファミリのメンバーを示しています。テキストでは、バンドルファミリのドイツメンバーであるバンドル「MyResources_de」を定義します。このメンバーは PropertyResourceBundle に基づいています。したがって、テキストは「MyResources_de.properties」ファイルの内容です (関連例では、ListResourceBundle のサブクラスとして実装されるバンドルをこのファミリに追加する方法を示します)。この例のキーの形式は「s1」などです。実際のキーは、バンドルからオブジェクトを取り出すためにプログラムで使用するキーと同じであるかぎり、なんでもかまいません。キーには、大文字/小文字の区別があります。

 # MessageFormat pattern
 s1=Die Platte \"{1}\" enthält {0}.

 # location of {0} in pattern
 s2=1

 # sample disk name
 s3=Meine Platte

 # first ChoiceFormat choice
 s4=keine Dateien

 # second ChoiceFormat choice
 s5=eine Datei

 # third ChoiceFormat choice
 s6={0,number} Dateien

 # sample date
 s7=3. März 1996
 

注: PropertyResourceBundle の構築は、プロパティーファイルを表す InputStream、Reader のいずれかを使って行えます。InputStream から PropertyResourceBundle インスタンスを構築するには、その入力ストリームが ISO-8859-1 でエンコードされている必要があります。その場合、ISO-8859-1 エンコーディングで表現できない文字は、「Java™ 言語仕様」のセクション 3.3 で定義されている Unicode エスケープで表現します。一方、Reader を取るその他のコンストラクタには、この制限はありません。

導入されたバージョン:

JDK1.1

関連項目:

ResourceBundle, ListResourceBundle, Properties

ネストされたクラスのサマリー

クラス java.util.ResourceBundle から継承されたネストされたクラス/インタフェース

ResourceBundle.Control

フィールドのサマリー

クラス java.util.ResourceBundle から継承されたフィールド

parent

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
PropertyResourceBundle(InputStream stream) InputStream からプロパティーリソースバンドルを作成します。
PropertyResourceBundle(Reader reader) Reader からプロパティーリソースバンドルを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Enumeration<String>	getKeys() この ResourceBundle とその親バンドル内に含まれるキーの Enumeration を返します。
Object	handleGetObject(String key) このリソースバンドルから指定されたキーのオブジェクトを取得します。
protected Set<String>	handleKeySet() この ResourceBundle にのみ含まれるキーの Set を返します。

クラス java.util.ResourceBundle から継承されたメソッド

clearCache, clearCache, containsKey, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, keySet, setParent

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PropertyResourceBundle

public PropertyResourceBundle(InputStream stream)
                       throws IOException

InputStream からプロパティーリソースバンドルを作成します。このコンストラクタで読み取られるプロパティーファイルは、ISO-8859-1 でエンコードされていなければいけません。

パラメータ:

stream - 読み取り元のプロパティーファイルを表す InputStream。

例外:

IOException - 入出力エラーが発生した場合

NullPointerException - stream が null である場合

PropertyResourceBundle

public PropertyResourceBundle(Reader reader)
                       throws IOException

Reader からプロパティーリソースバンドルを作成します。コンストラクタ PropertyResourceBundle(InputStream) の場合と異なり、入力プロパティーファイルのエンコーディングに関する制限はありません。

パラメータ:

reader - 読み取り元のプロパティーファイルを表す Reader。

例外:

IOException - 入出力エラーが発生した場合

NullPointerException - reader が null である場合

導入されたバージョン:

1.6

メソッドの詳細

handleGetObject

public Object handleGetObject(String key)

クラスからコピーされた説明: ResourceBundle

このリソースバンドルから指定されたキーのオブジェクトを取得します。このリソースバンドルが、指定されたキーのオブジェクトを含まない場合は、null を返します。

定義:

handleGetObject、クラス: ResourceBundle

パラメータ:

key - 目的のオブジェクトのキー

戻り値:

指定されたキーのオブジェクト、または null

getKeys

public Enumeration<String> getKeys()

この ResourceBundle とその親バンドル内に含まれるキーの Enumeration を返します。

定義:

getKeys、クラス: ResourceBundle

戻り値:

この ResourceBundle とその親バンドル内に含まれるキーの Enumeration。

関連項目:

ResourceBundle.keySet()

handleKeySet

protected Set<String> handleKeySet()

この ResourceBundle にのみ含まれるキーの Set を返します。

オーバーライド:

handleKeySet、クラス: ResourceBundle

戻り値:

この ResourceBundle にのみ含まれているキーの Set

導入されたバージョン:

1.6

関連項目:

ResourceBundle.keySet()