JavaTM Platform
Standard Ed. 6

java.util
类 PropertyResourceBundle

java.lang.Object
  继承者 java.util.ResourceBundle
      继承者 java.util.PropertyResourceBundle

public class PropertyResourceBundle
     
extends ResourceBundle

PropertyResourceBundleResourceBundle 的一个具体子类,它使用属性文件中的静态字符串集来管理语言环境资源。有关资源包的更多信息,请参阅 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
 

注:可根据 InputStream 或 Reader 构造 PropertyResourceBundle,它表示一个属性文件。根据 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 - 如果发生 I/O 错误
NullPointerException - 如果 stream 为 null

PropertyResourceBundle

public PropertyResourceBundle(Reader reader)
                       throws IOException
根据 Reader 创建属性资源包。与 PropertyResourceBundle(InputStream) 构造方法不同,关于输入属性文件的编码没有限制。

参数:
reader - 一个 Reader,表示要从其进行读取的属性文件。
抛出:
IOException - 如果发生 I/O 错误
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 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策