JavaTM Platform
Standard Ed. 6

java.util
クラス PropertyResourceBundle

java.lang.Object
  上位を拡張 java.util.ResourceBundle
      上位を拡張 java.util.PropertyResourceBundle

public class PropertyResourceBundle
extends ResourceBundle

PropertyResourceBundle は、ResourceBundle の具象サブクラスです。 ResourceBundle クラスは、プロパティーファイルから得た static な文字列のセットを使用してロケール用のリソースを管理します。リソースバンドル全体の説明については、ResourceBundle を参照してください。

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

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

 # 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 エンコーディングで表現できない文字は、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 を返します。

定義:
クラス ResourceBundle 内の handleGetObject
パラメータ:
key - 望ましいオブジェクトのキー
戻り値:
指定されたキーのオブジェクト、または null

getKeys

public Enumeration<String> getKeys()
この ResourceBundle とその親バンドル内に含まれるキーの Enumeration を返します。

定義:
クラス ResourceBundle 内の getKeys
戻り値:
この ResourceBundle とその親バンドル内に含まれるキーの Enumeration
関連項目:
ResourceBundle.keySet()

handleKeySet

protected Set<String> handleKeySet()
この ResourceBundle だけに格納されているキーの Set を返します。

オーバーライド:
クラス ResourceBundle 内の handleKeySet
戻り値:
この ResourceBundle だけに格納されているキーの Set
導入されたバージョン:
1.6
関連項目:
ResourceBundle.keySet()

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。