- 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
- 関連項目:
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
を返します。protected Set<String>
handleKeySet()
このResourceBundle
にのみ含まれるキーのSet
を返します。-
クラス java.lang.Objectで宣言されたメソッド
clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait
-
クラス java.util.ResourceBundleで宣言されたメソッド
clearCache, clearCache, containsKey, getBaseBundleName, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, handleGetObject, 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
-
-
メソッドの詳細
-
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()
-
-