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
- APIのノート:
PropertyResourceBundle
は、プロパティ・ファイルを表すInputStream
またはReader
から構築できます。InputStream
からPropertyResourceBundle
インスタンスを構築するには、入力ストリームをUTF-8
でエンコードする必要があります。 デフォルトでは、入力ストリームの読取り時にMalformedInputException
またはUnmappableCharacterException
が発生した場合、PropertyResourceBundle
インスタンスは例外前の状態にリセットされ、ISO-8859-1
で入力ストリームが再読取りされ、読取りが続行されます。 システム・プロパティjava.util.PropertyResourceBundle.encoding
が"ISO-8859-1"または"UTF-8"に設定されている場合、入力ストリームはそのエンコードでのみ読み取られ、無効な順序が検出されると例外がスローされます。 "ISO-8859-1"が指定されている場合、ISO-8859-1エンコーディングで表現できない文字は、「Java言語仕様」の3.3セクションで定義されているUnicodeエスケープで表す必要がありますが、Reader
を使用する他のコンストラクタにはその制限はありません。 このシステム・プロパティでは、他のエンコーディング値は無視されます。 このクラスの初期化時にシステム・プロパティが読み取られ、評価されます。 プロパティを変更または削除しても、初期化後に効果はありません。- 実装要件:
PropertyResourceBundle
サブクラスの実装は、それが複数のスレッドで同時に使用される場合、スレッドセーフである必要があります。 このクラスの非抽象メソッドのデフォルト実装はスレッドセーフです。- 導入されたバージョン:
- 1.1
- 関連項目:
-
ネストされたクラスのサマリー
クラスjava.util.ResourceBundleで宣言されたネストされたクラス/インタフェース
ResourceBundle.Control
-
フィールドのサマリー
クラスjava.util.ResourceBundleで宣言されたフィールド
parent
-
コンストラクタのサマリー
コンストラクタ説明PropertyResourceBundle
(InputStream stream) InputStream
からプロパティ・リソース・バンドルを作成します。PropertyResourceBundle
(Reader reader) Reader
からプロパティ・リソース・バンドルを作成します。 -
メソッドのサマリー
修飾子と型メソッド説明getKeys()
このResourceBundle
とその親バンドル内に含まれるキーのEnumeration
を返します。handleGetObject
(String key) このリソース・バンドルから指定されたキーのオブジェクトを取得します。このResourceBundle
にのみ含まれるキーのSet
を返します。クラスjava.util.ResourceBundleで宣言されたメソッド
clearCache, clearCache, containsKey, getBaseBundleName, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, keySet, setParent
-
コンストラクタの詳細
-
PropertyResourceBundle
public PropertyResourceBundle(InputStream stream) throws IOException InputStream
からプロパティ・リソース・バンドルを作成します。 このコンストラクタは、デフォルトでプロパティ・ファイルをUTF-8で読み取ります。 入力ストリームの読取り時にMalformedInputException
またはUnmappableCharacterException
が発生した場合、PropertyResourceBundleインスタンスは例外前の状態にリセットされ、ISO-8859-1
の入力ストリームが再読み込まれ、読取りが続行されます。 システム・プロパティjava.util.PropertyResourceBundle.encoding
が"ISO-8859-1"または"UTF-8"に設定されている場合、入力ストリームはそのエンコードでのみ読み取られ、無効な順序が検出されると例外がスローされます。 このシステム・プロパティでは、他のエンコーディング値は無視されます。 このクラスの初期化時にシステム・プロパティが読み取られ、評価されます。 プロパティを変更または削除しても、初期化後に効果はありません。- パラメータ:
stream
- 読取り元のプロパティ・ファイルを表すInputStream。- 例外:
IOException
- 入出力エラーが発生した場合NullPointerException
-stream
がnullである場合IllegalArgumentException
-stream
に形式が不正なUnicodeエスケープ・シーケンスが含まれる場合。MalformedInputException
- システム・プロパティjava.util.PropertyResourceBundle.encoding
が"UTF-8"に設定され、stream
に無効なUTF-8バイト・シーケンスが含まれている場合。UnmappableCharacterException
- システム・プロパティjava.util.PropertyResourceBundle.encoding
が"UTF-8"に設定され、stream
にマッピングできないUTF-8バイト・シーケンスが含まれている場合。
-
PropertyResourceBundle
public PropertyResourceBundle(Reader reader) throws IOException Reader
からプロパティ・リソース・バンドルを作成します。 コンストラクタPropertyResourceBundle(InputStream)
の場合と異なり、入力プロパティ・ファイルのエンコーディングに関する制限はありません。- パラメータ:
reader
- 読取り元のプロパティ・ファイルを表すReader。- 例外:
IOException
- 入出力エラーが発生した場合NullPointerException
-reader
がnullである場合IllegalArgumentException
-reader
から形式が不正なUnicodeエスケープ・シーケンスが出現する場合。- 導入されたバージョン:
- 1.6
-
-
メソッドの詳細
-
handleGetObject
クラスからコピーされた説明:ResourceBundle
このリソース・バンドルから指定されたキーのオブジェクトを取得します。 このリソース・バンドルが、指定されたキーのオブジェクトを含まない場合は、nullを返します。- 定義:
handleGetObject
、クラスResourceBundle
- パラメータ:
key
- 目的のオブジェクトのキー- 戻り値:
- 指定されたキーのオブジェクト、またはnull
-
getKeys
public Enumeration<String> getKeys()このResourceBundle
とその親バンドル内に含まれるキーのEnumeration
を返します。- 定義:
getKeys
、クラスResourceBundle
- 戻り値:
- この
ResourceBundle
とその親バンドル内に含まれるキーのEnumeration
。 - 関連項目:
-
handleKeySet
このResourceBundle
にのみ含まれるキーのSet
を返します。- オーバーライド:
handleKeySet
、クラスResourceBundle
- 戻り値:
- この
ResourceBundle
にのみ含まれているキーのSet
- 導入されたバージョン:
- 1.6
- 関連項目:
-