ResourceBundle 类介绍 （一）使用场景
java.util
类 ResourceBundle
java.lang.Object java.util.ResourceBundle
- 直接已知子类：
- ListResourceBundle , PropertyResourceBundle
public abstract class ResourceBundleextends Object
资源包包含特定于语言环境的对象。当程序需要一个特定于语言环境的资源时（如 String ），程序可以从适合当前用户语言环境的资源包中加载它。使用这种方式，可以编写很大程度上独立于用户语言环境的程序代码，它将资源包中大部分（即便不是全部）特定于语言环境的信息隔离开来。
这使编写的程序可以：
- 轻松地本地化或翻译成不同的语言
- 一次处理多个语言环境
- 以后可以轻松进行修改，以便支持更多的语言环境
资源包属于这样的系列，其成员共享一个公共的基本名称，但是名称中还有标识其语言环境的其他组件。例如，某个资源包系列的基本名称可能是 "MyResources"。该系列应该有一个默认资源包，其名称与其系列名相同（ "MyResources"），如果不支持指定的语言环境，则应该将此资源包用作最后的手段。然后，此系列可根据需要提供特定于语言环境的成员，例如一个 名为 "MyResources_de" 的德语资源包。
一个系列中的每个资源包都包含相同的项，但是这些项已经针对该资源包所代表的语言环境进行了翻译。例如，"MyResources" 和 "MyResources_de" 可能有用在取消操作按钮上的 String 。在 "MyResources" 中，String 可能包含 "Cancel"，而 "MyResources_de" 中则可能包含 "Abbrechen"。
如果不同的国家/地区有不同的资源，则可以对它们进行限定：例如，"MyResources_de_CH" 包含瑞士 (CH) 中包含德语 (de) 的对象。如果只想修改限定中的某些资源，就可以这样做。
当程序需要特定于语言环境的对象时，它使用 getBundle 方法加载 ResourceBundle 类：
ResourceBundle myResources =
ResourceBundle.getBundle("MyResources", currentLocale);
资源包包含键/值对。键唯一地标识了包中特定于语言环境的对象。下面是一个 ListResourceBundle 示例，它包含两个键/值对：
public class MyResources extends ListResourceBundle {
protected Object[][] getContents() {
return new Object[][] {
// LOCALIZE THE SECOND STRING OF EACH ARRAY (e.g., "OK")
{"OkKey", "OK"},
{"CancelKey", "Cancel"},
// END OF MATERIAL TO LOCALIZE
};
}
}
键始终为 String 类型。在此示例中，两个键是 "OkKey" 和 "CancelKey"。在上面的示例中，值也是 String 类型，即 "OK" 和 "Cancel"，但并非必须如此。值可以是任意对象类型。
可以使用适当的获取方法从资源包中获取某个对象。因为 "OkKey" 和 "CancelKey" 都是字符串，所以应该使用 getString 获取它们：
button1 = new Button(myResources.getString("OkKey"));
button2 = new Button(myResources.getString("CancelKey"));
所有获取方法都需要将键作为参数并返回对象（如果找到的话）。如果未找到对象，则获取方法将抛出 MissingResourceException 。
除了 getString 之外，ResourceBundle 还提供了获取字符串数组的方法 getStringArray ，以及用于其他任意对象类型的 getObject 方法。使用 getObject 时，必须将结果强制转换为适当的类型。例如：
int[] myIntegers = (int[]) myResources.getObject("intList");
Java 平台提供了两个 ResourceBundle 的子类，即 ListResourceBundle 和 PropertyResourceBundle ，这为创建资源提供了一种相当简单的方式。正如在前面示例中所看到的，ListResourceBundle 以键/值对的列表方式管理其资源。PropertyResourceBundle 则使用一个属性文件来管理其资源。
如果 ListResourceBundle 或 PropertyResourceBundle 无法满足需求，那么可以编写自己的 ResourceBundle 子类。子类必须重写两个方法：handleGetObject 和 getKeys() 。
ResourceBundle.Control
ResourceBundle.Control 类提供通过带 ResourceBundle.Control 实例的 getBundle 工厂方法执行包加载进程所需的信息。为了启用非标准资源包格式、更改搜索策略或定义缓存参数，可以实现自己的子类。有关细节请参考类和 getBundle 工厂方法的描述。
缓存管理
getBundle 工厂方法创建的资源包实例是默认缓存的，如果资源包实例已经缓存，那么这些工厂方法将多次返回相同的资源包实例。getBundle 客户端可以清除缓存、使用生存时间值管理已缓存资源包实例的生命周期，或者指定不缓存资源包实例。有关细节请参考getBundle 工厂方法 、clearCache 、ResourceBundle.Control.getTimeToLive 和 ResourceBundle.Control.needsReload 的描述。
示例
下面是一个极其简单的 ResourceBundle 子类示例 MyResources ，它管理两个资源（对于大量的资源，应该使用 Map ）。注意，如果某个“父级”ResourceBundle 处理具有相同值的相同键（如下面的 okKey），则无需提供值。
// default (English language, United States)
public class MyResources extends ResourceBundle {
public Object handleGetObject(String key) {
if (key.equals("okKey")) return "Ok";
if (key.equals("cancelKey")) return "Cancel";
return null;
}
public Enumeration getKeys() {
return Collections.enumeration(keySet());
}
// Overrides handleKeySet() so that the getKeys() implementation
// can rely on the keySet() value.
protected Set handleKeySet() {
return new HashSet(Arrays.asList("okKey", "cancelKey"));
}
}
// German language
public class MyResources_de extends MyResources {
public Object handleGetObject(String key) {
// don't need okKey, since parent level handles it.
if (key.equals("cancelKey")) return "Abbrechen";
return null;
}
protected Set handleKeySet() {
return new HashSet(Arrays.asList("cancelKey"));
}
}
不必限制只使用 ResourceBundle 的单个系列。例如，可以有异常消息 ExceptionResources 的包集（ExceptionResources_fr 、ExceptionResources_de 等）和窗口小部件 WidgetResource 的包集（WidgetResources_fr 、WidgetResources_de 等）；可以按自己喜欢的方式分解资源。
- 从以下版本开始：
- JDK1.1
- 另请参见：
-
ListResourceBundle,PropertyResourceBundle,MissingResourceException
| 嵌套类摘要 | |
|---|---|
static class |
ResourceBundle.Control ResourceBundle.Control 定义一个回调方法集，它在包加载进程中由 ResourceBundle.getBundle 工厂方法调用。 |
| 字段摘要 | |
|---|---|
protected ResourceBundle |
parent 此包的父包。 |
| 构造方法摘要 | |
|---|---|
ResourceBundle () 唯一的构造方法（由子类构造方法调用，通常是隐式的）。 |
|
| 方法摘要 | |
|---|---|
static void |
clearCache () 从已经使用调用者的类加载器加载的缓存中移除所有资源包。 |
static void |
clearCache (ClassLoader loader) 从已经使用给定类加载器加载的缓存中移除所有资源包。 |
boolean |
containsKey (String key) 确定给定 key 是否包含在此 ResourceBundle 及其父包中。 |
static ResourceBundle |
getBundle (String baseName) 使用指定的基本名称、默认的语言环境和调用者的类加载器获取资源包。 |
static ResourceBundle |
getBundle (String baseName, Locale locale) 使用指定的基本名称、语言环境和调用者的类加载器获取资源包。 |
static ResourceBundle |
getBundle (String baseName, Locale locale, ClassLoader loader) 使用指定的基本名称、语言环境和类加载器获取资源包。 |
static ResourceBundle |
getBundle (String baseName, Locale targetLocale, ClassLoader loader, ResourceBundle.Control control) 使用指定基本名称、目标语言环境、类加载器和控件返回资源包。 |
static ResourceBundle |
getBundle (String baseName, Locale targetLocale, ResourceBundle.Control control) 使用指定基本名称、目标语言环境和控件、调用者的类加载器返回一个资源包。 |
static ResourceBundle |
getBundle (String baseName, ResourceBundle.Control control) 使用指定基本名称、默认语言环境和指定控件返回一个资源包。 |
abstract Enumeration |
getKeys () 返回键的枚举。 |
Locale |
getLocale () 返回此资源包的语言环境。 |
Object |
getObject (String key) 从此资源包或它的某个父包中获取给定键的对象。 |
String |
getString (String key) 从此资源包或它的某个父包中获取给定键的字符串。 |
String [] |
getStringArray (String key) 从此资源包或它的某个父包中获取给定键的字符串数组。 |
protected abstract Object |
handleGetObject (String key) 从此资源包中获取给定键的对象。 |
protected Set |
handleKeySet () 返回只 包含在此 ResourceBundle 中的键的 Set 。 |
Set |
keySet () 返回此 ResourceBundle 及其父包中包含的所有键的 Set 。 |
protected void |
setParent (ResourceBundle parent) 设置此包的父包。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
| 字段详细信息 |
|---|
parent
protected ResourceBundle parent
-
此包的父包。当此包不包含特定资源时，由
getObject搜索父包。
| 构造方法详细信息 |
|---|
ResourceBundle
public ResourceBundle ()
-
唯一的构造方法（由子类构造方法调用，通常是隐式的）。
| 方法详细信息 |
|---|
getString
public final String getString (String key)
-
从此资源包或它的某个父包中获取给定键的字符串。调用此方法等同于调用
(String)。getObject(key) -
- 参数：
-
key- 所需字符串的键 - 返回：
- 给定键的字符串
- 抛出：
-
NullPointerException- 如果key为null -
MissingResourceException- 如果未找到给定键的对象 -
ClassCastException- 如果为给定键找到的对象是不是字符串
getStringArray
public final String [] getStringArray (String key)
-
从此资源包或它的某个父包中获取给定键的字符串数组。调用此方法等同于调用
(String[])。getObject(key) -
- 参数：
-
key- 所需字符串数组的键 - 返回：
- 给定键的字符串数组
- 抛出：
-
NullPointerException- 如果key为null -
MissingResourceException- 如果未找到给定键的对象 -
ClassCastException- 如果为给定键找到的对象不是字符串数组
getObject
public final Object getObject (String key)
-
从此资源包或它的某个父包中获取给定键的对象。此方法首先尝试使用
handleGetObject从此资源包中获取对象。如果不成功，并且父资源包不为 null，则调用父包的getObject方法。如果仍不成功，则抛出 MissingResourceException。 -
- 参数：
-
key- 所需对象的键 - 返回：
- 给定键的对象
- 抛出：
-
NullPointerException- 如果key为null -
MissingResourceException- 如果未找到给定键的对象
getLocale
public Locale getLocale ()
-
返回此资源包的语言环境。调用 getBundle() 后可使用此方法来确定返回的资源包是真正对应于所请求的语言环境，还是只是一个回退。
-
- 返回：
- 此资源包的语言环境
setParent
protected void setParent (ResourceBundle parent)
-
设置此包的父包。当此包不包含特定的资源时，通过
getObject来搜索父包。 -
- 参数：
-
parent- 此包的父包。
getBundle
public static final ResourceBundle getBundle (String baseName)
-
使用指定的基本名称、默认的语言环境和调用者的类加载器获取资源包。调用此方法等同于调用
不同之处在于要使用getBundle(baseName, Locale.getDefault(), this.getClass().getClassLoader())，ResourceBundle的安全特权来运行getClassLoader()。有关搜索和实例化策略的信息，请参阅getBundle。 -
- 参数：
-
baseName- 资源包的基本名称，是一个完全限定类名 - 返回：
- 具有给定基本名称和默认语言环境的资源包
- 抛出：
-
NullPointerException- 如果baseName为null -
MissingResourceException- 如果未找到指定基本名称的资源包
getBundle
public static final ResourceBundle
getBundle
(String
baseName,
ResourceBundle.Control
control)
-
使用指定基本名称、默认语言环境和指定控件返回一个资源包。调用此方法等同于调用
getBundle(baseName, Locale.getDefault(), this.getClass().getClassLoader(), control)，不同之处在于要使用ResourceBundle的安全特权来运行getClassLoader()。有关带ResourceBundle.Control的资源包加载进程的完整描述，请参阅getBundle。 -
- 参数：
-
baseName- 资源包的基本名称，一个完全限定类名 -
control- 为资源包加载进程提供信息的控件 - 返回：
- 用于给定基本名称和默认语言环境的资源包
- 抛出：
-
NullPointerException- 如果baseName或control为null -
MissingResourceException- 如果没有找到用于指定基本名称的资源包 -
IllegalArgumentException- 如果给定control没有正确执行（例如，control.getCandidateLocales返回 null。）注意，control的验证是根据需要执行的。 - 从以下版本开始：
- 1.6
getBundle
public static final ResourceBundle
getBundle
(String
baseName,
Locale
locale)
-
使用指定的基本名称、语言环境和调用者的类加载器获取资源包。调用此方法等同于调用
不同之处在于要使用getBundle(baseName, locale, this.getClass().getClassLoader())，ResourceBundle的安全特权来运行getClassLoader()。有关搜索和实例化策略的信息，请参阅getBundle。 -
- 参数：
-
baseName- 资源包的基本名称，是一个完全限定类名 -
locale- 资源包所需的语言环境 - 返回：
- 具有给定基本名称和语言环境的资源包
- 抛出：
-
NullPointerException- 如果baseName或locale为null -
MissingResourceException- 如果未找到指定基本名称的资源包
getBundle
public static final ResourceBundle
getBundle
(String
baseName,
Locale
targetLocale,
ResourceBundle.Control
control)
-
使用指定基本名称、目标语言环境和控件、调用者的类加载器返回一个资源包。调用此方法等同于调用
getBundle(baseName, targetLocale, this.getClass().getClassLoader(), control)，不同之处在于要使用ResourceBundle的安全特权来运行getClassLoader()。有关带ResourceBundle.Control的资源包加载进程的完整描述，请参阅getBundle。 -
- 参数：
-
baseName- 资源包的基本名称，一个完全限定类名 -
targetLocale- 资源包所需的语言环境 -
control- 为资源包加载进程提供信息的控件 - 返回：
-
用于给定基本名称和
locales中某个Locale的资源包 - 抛出：
-
NullPointerException- 如果baseName、locales或control为null -
MissingResourceException- 如果在任何locales中都无法找到用于指定基本名称的资源包。 -
IllegalArgumentException- 如果给定control没有正确执行（例如，control.getCandidateLocales返回 null。）注意，control的验证是根据需要执行的。 - 从以下版本开始：
- 1.6
getBundle
public static ResourceBundle
getBundle
(String
baseName,
Locale
locale,
ClassLoader
loader)
-
使用指定的基本名称、语言环境和类加载器获取资源包。
从概念上讲，
getBundle使用下列策略来搜索并实例化资源包：
baseName + "_" + language1 + "_" + country1 + "_" + variant1 baseName + "_" + language1 + "_" + country1 baseName + "_" + language1 baseName + "_" + language2 + "_" + country2 + "_" + variant2 baseName + "_" + language2 + "_" + country2 baseName + "_" + language2 baseNamegetBundle使用基本名称、指定的语言环境和默认语言环境（从Locale.getDefault获得）来生成候选包名称 序列。如果指定语言环境的语言、国家/地区和变量都是空字符串，则基本名称就是唯一的候选包名称。否则，从指定语言环境（language1、 country1 和 variant1）和默认语言环境（language2、country2 和 variant2）的属性值生成下列序列：省略最后部分为空字符串的候选包名称。例如，如果 country1 是一个空字符串，则省略第二个候选包名称。
然后
首先，它试图使用候选包名称加载一个类。如果可以找到这样的类并使用指定的类加载器加载，而且此类的分配与 ResourceBundle 兼容，可通过 ResourceBundle 访问，并可以被实例化，那么getBundle在候选包名称上进行迭代，找到第一个可实例化 为实际资源包的候选包名称。对于每个候选包名称，它都试图创建资源包：getBundle将创建此类的一个新实例，并使用它作为 结果资源包 。 否则，getBundle尝试搜索属性资源文件。它从候选包名称生成一个路径名，用 "/" 替换所有的 "." 字符，并添加字符串 ".properties"。然后尝试用ClassLoader.getResource找到一个具有此名称的“资源”（注意，getResource获得的“资源”与资源包中的内容没有任何关系，它只是一个数据的容器，如文件）。如果它找到一个“资源”，则会尝试用其内容创建一个新的PropertyResourceBundle。如果成功，那么此实例就成为 结果资源包 。如果未找到结果资源包，则抛出
MissingResourceException。找到了结果资源包后，它的父链 将被实例化。
getBundle在可以获得的候选包名称中进行迭代，获得名称的方法是从结果资源包的包名称中连续移除变量、国家/地区和语言（每次都用前缀 "_"）。如上所述，省略最后部分为空字符串的候选包名称。对于每个候选包名称，都尝试实例化一个资源包，如上所述。只要能够成功，就用新的资源包调用先 前已实例化资源包的setParent方法，除非先前已实例化的资源包已经有非 null 的父包。getBundle可以缓存已实例化的资源包，并且可以多次返回相同的资源包实例。baseName参数应该是一个完全限定类名。但是，为了与早期的版本兼容，Sun 的 Java SE Runtime Environment 并不对此进行检查，所以可通过指定路径名（使用 "/"）而不是完全限定类名（使用 "."）来访问PropertyResourceBundle。示例：
提供了下面的类和属性文件：MyResources.class MyResources.properties MyResources_fr.properties MyResources_fr_CH.class MyResources_fr_CH.properties MyResources_en.properties MyResources_es_ES.class所有文件的内容都是有效的（也就是说 ".class" 文件是 ResourceBundle 的公共非抽象子类，".properties" 文件的语法正确）。默认的语言环境是Locale("en", "GB")。使用给出的语言环境参数值调用
Locale("fr", "CH")：结果 MyResources_fr_CH.class、父 MyResources_fr.properties、父 MyResources.class Locale("fr", "FR")：结果 MyResources_fr.properties、父 MyResources.class Locale("de", "DE")：结果 MyResources_en.properties、父 MyResources.class Locale("en", "US")：结果 MyResources_en.properties、父 MyResources.class Locale("es", "ES")：结果 MyResources_es_ES.class、父 MyResources.classgetBundle将实例化取自以下源的资源包：不使用 MyResources_fr_CH.properties 文件，因为它被 MyResources_fr_CH.class 隐藏了。类似地，MyResources.properties 也被 MyResources.class 隐藏了。
- 参数：
baseName - 资源包的基本名称，是一个完全限定类名
locale - 资源包所需的语言环境
loader - 加载资源包的类加载器
返回： 用于给定基本名称和语言环境的资源包
抛出：
NullPointerException - 如果
baseName 、
locale 或
loader 为
null
MissingResourceException - 如果未找到指定基本名称的资源包
从以下版本开始： 1.2
getBundle
public static ResourceBundle
getBundle
(String
baseName,
Locale
targetLocale,
ClassLoader
loader,
ResourceBundle.Control
control)
-
使用指定基本名称、目标语言环境、类加载器和控件返回资源包。与 不带
control参数的getBundle工厂方法 不同，给定control指定查找和实例化资源包的方式。从概念上说，具有给定control的包加载进程是按以下步骤执行的。- 此工厂方法在缓存中为指定
baseName、targetLocale和loader查找资源包。如果在缓存中找到所请求的资源包实例，并且该实例及其所有父实例的生存时间都已经到期，则向调用者返回该实例。否则，此工厂方法继续进行以下加载进程。 - 调用
control.getFormats方法获取生成包名称或资源名称的资源包格式。字符串"java.class"和"java.properties"分别指定基于类和基于属性 的资源包。其他以"java."开头的字符串被保留，供以后扩展使用，不必将它们用于应用程序定义的格式。其他字符串指定应用程序定义的格式。 - 可以调用带有目标语言环境的
control.getCandidateLocales方法获取用于已搜索到的资源包的候选Locale列表。 - 可以调用
control.newBundle方法实例化针对基本包名称、候选语言环境和某种格式的ResourceBundle。（参考下方关于缓存查找的注释。）此步骤在所有候选语言环境和格式上进行迭代，直到newBundle方法返回一个ResourceBundle实例，或者该迭代已经用完了所有的组合。例如，如果候选语言环境是Locale("de", "DE")、Locale("de")和Locale("")，而格式是"java.class"和"java.properties"，那么以下是用来调用control.newBundle的语言环境和格式组合的序列。语言环境 格式 Locale("de", "DE") java.class Locale("de", "DE") java.properties Locale("de") java.class Locale("de") java.properties Locale("") java.class Locale("") java.properties - 如果前面的步骤未找到资源包，则前进到步骤 6。如果已经找到用作基本包的包（
Locale("")的包），以及只包含Locale("")的候选语言环境列表，则向调用者返回该包。如果已经找到作为基本包的包，但候选语言环境列表包含 Locale("") 之外的语言环境，则暂时搁置该包并前进到步骤 6。如果找到一个不是基本包的包，则前进到步骤 7。 - 可调用
control.getFallbackLocale方法获取一个回退语言环境（当前目标语言环境的替代），以尝试进一步寻找资源包。如果该方法返回一个非 null 语言环境，那么该语言环境将变成下一个目标语言环境，并且加载进程将从步骤 3 开始。否则，如果找到一个基本包并在前面的步骤 5 中暂时被搁置，那么现在要将该语言环境返回给调用者。否则抛出 MissingResourceException。 - 此时，我们已经找到一个不是基本包的包。如果此包在其实例化期间设置其父链，则将此包返回给调用者。否则，根据从中找到此包的候选语言环境列表，将此包的父链 实例化。最后将该包返回给调用者。
在进行上述资源包加载进程期间，此工厂方法将在调用
control.newBundle方法之前查找缓存。如果在该缓存中找到的资源包的生存时间已到期，则该工厂方法将调用control.needsReload方法确定是否需要重载资源包。如果需要重载，则该工厂方法将调用control.newBundle重载资源包。如果control.newBundle返回null，则该工厂方法将在缓存中放一个伪资源包，以此作为不存在资源包的标记，从而避免后续请求所带来的查找开销。这类伪资源包同样受到control所指定的到期时间控制。所有已加载的资源包都是在默认情况下被缓存的。有关细节请参阅
control.getTimeToLive。以下是带有默认
ResourceBundle.Control实现的包加载进程的示例。条件：
- 基本包的名称：
foo.bar.Messages - 所请求的
Locale：Locale.ITALY - 默认
Locale：Locale.FRENCH - 可用的资源包：
foo/bar/Messages_fr.properties和foo/bar/Messages.properties
首先，
getBundle试图按以下顺序加载资源包。- 类
foo.bar.Messages_it_IT - 文件
foo/bar/Messages_it_IT.properties - 类
foo.bar.Messages_it - 文件
foo/bar/Messages_it.properties - 类
foo.bar.Messages - 文件
foo/bar/Messages.properties
此时，
getBundle找到一个foo/bar/Messages.properties，该包被搁置，因为它不是一个基本包。getBundle调用返回Locale.FRENCH的control.getFallbackLocale("foo.bar.Messages", Locale.ITALY)。接着，getBundle试图按以下顺序加载一个包。- 类
foo.bar.Messages_fr - 文件
foo/bar/Messages_fr.properties - 类
foo.bar.Messages - 文件
foo/bar/Messages.properties
getBundle查找foo/bar/Messages_fr.properties并创建一个ResourceBundle实例。然后，getBundle根据候选语言环境列表设置其父链。在该列表中只有foo/bar/Messages.properties，并且getBundle创建一个ResourceBundle实例，该实例成为用于foo/bar/Messages_fr.properties的实例的父实例。 - 此工厂方法在缓存中为指定
-
- 参数：
-
baseName- 资源包的基本名称，一个完全限定类名 -
targetLocale- 资源包所需的语言环境 -
loader- 加载资源包的类加载器 -
control- 为资源包加载进程提供信息的控件 - 返回：
- 用于给定基本名称和语言环境的资源包
- 抛出：
-
NullPointerException- 如果baseName、targetLocale、loader或control为null -
MissingResourceException- 如果没有找到用于指定基本名称的资源包 -
IllegalArgumentException- 如果给定control没有正确执行（例如，control.getCandidateLocales返回 null。）注意，control的验证是根据需要执行的。 - 从以下版本开始：
- 1.6
clearCache
public static final void clearCache ()
-
从已经使用调用者的类加载器加载的缓存中移除所有资源包。
-
- 从以下版本开始：
- 1.6
- 另请参见：
-
ResourceBundle.Control.getTimeToLive(String,Locale)
clearCache
public static final void clearCache (ClassLoader loader)
-
从已经使用给定类加载器加载的缓存中移除所有资源包。
-
- 参数：
-
loader- 类加载器 - 抛出：
-
NullPointerException- 如果loader为 null - 从以下版本开始：
- 1.6
- 另请参见：
-
ResourceBundle.Control.getTimeToLive(String,Locale)
handleGetObject
protected abstract Object handleGetObject (String key)
-
从此资源包中获取给定键的对象。如果此资源包未包含给定键的对象，则返回 null。
-
- 参数：
-
key- 所需对象的键 - 返回：
- 给定键的对象，或者返回 null
- 抛出：
-
NullPointerException- 如果key为null
getKeys
public abstract EnumerationgetKeys ()
-
返回键的枚举。
-
- 返回：
-
此
ResourceBundle及其父包中所包含键的Enumeration。
containsKey
public boolean containsKey (String key)
-
确定给定
key是否包含在此ResourceBundle及其父包中。 -
- 参数：
-
key- 资源key - 返回：
-
如果给定
key包含在此ResourceBundle或其父包中，则返回true；否则返回false。 - 抛出：
-
NullPointerException- 如果key为null - 从以下版本开始：
- 1.6
keySet
public SetkeySet ()
-
返回此
ResourceBundle及其父包中包含的所有键的Set。 -
- 返回：
-
此
Set及其父包中包含的所有键的Set。 - 从以下版本开始：
- 1.6
handleKeySet
protected SethandleKeySet ()
-
返回
只 包含在此
ResourceBundle中的键的Set。默认实现返回
getKeys方法返回的键的Set，那些handleGetObject方法返回null的键除外。创建Set后，该值就被保存在此ResourceBundle中，以避免在下次调用中产生相同的Set。可在子类实现中重写此方法，以便更快地进行处理。 -
- 返回：
-
只包含于此
ResourceBundle中的键的Set - 从以下版本开始：
- 1.6