compact1, compact2, compact3

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サブクラスの実装は、それが複数のスレッドで同時に使用される場合、スレッドセーフである必要があります。このクラスの非抽象メソッドのデフォルト実装はスレッドセーフです。

注: 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, getBaseBundleName, 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である場合

IllegalArgumentException - streamに形式が不正なUnicodeエスケープ・シーケンスが含まれる場合。

PropertyResourceBundle

public PropertyResourceBundle(Reader reader)
                       throws IOException

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

パラメータ:

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

例外:

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

NullPointerException - readerがnullである場合

IllegalArgumentException - readerから形式が不正なUnicodeエスケープ・シーケンスが出現する場合。

導入されたバージョン:

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()