ResourceBundle.Control 类

定义

[Android.Runtime.Register("java/util/ResourceBundle$Control", DoNotGenerateAcw=true)]
public class ResourceBundle.Control : Java.Lang.Object

[<Android.Runtime.Register("java/util/ResourceBundle$Control", DoNotGenerateAcw=true)>]
type ResourceBundle.Control = class
    inherit Object

继承

Object

Object

ResourceBundle.Control

属性

RegisterAttribute

注解

ResourceBundle.Control 定义在捆绑加载过程中由工厂方法调用 ResourceBundle#getBundle(String, Locale, ClassLoader, Control) ResourceBundle.getBundle 的一组回调方法。 换句话说，与 ResourceBundle.Control 工厂方法协作以加载资源捆绑包。 回调方法的默认实现提供了执行默认行为所需的工厂方法所需的信息。

除了回调方法之外， #toBundleName(String, Locale) toBundleName 还主要定义和 #toResourceName(String, String) toResourceName 方法，以便于实现回调方法。 但是， toBundleName 可以重写此方法，以便在组织和打包本地化资源时提供不同的约定。 方法是toResourceNamefinal避免使用错误的资源和类名分隔符。

两个工厂方法， #getControl(List)ResourceBundle.Control并提供#getNoFallbackControl(List)实现默认捆绑加载过程的常见变体的实例。

方法返回 Control#getFormats(String) getFormats 的格式和该方法返回 ResourceBundle.Control#getCandidateLocales(String, Locale) getCandidateLocales 的候选区域设置必须在同一基本捆绑包的所有 ResourceBundle.getBundle 调用中保持一致。 否则， ResourceBundle.getBundle 方法可能会返回意外捆绑包。 例如，如果仅 "java.class" 由 getFormats 第一次调用 ResourceBundle.getBundle 的方法返回，并且只 "java.properties" 返回第二次调用，则第二次调用将返回在第一次调用期间缓存的基于类的调用。

ResourceBundle.Control如果实例同时由多个线程使用，则必须是线程安全的。 ResourceBundle.getBundle 不同步以调用 ResourceBundle.Control 方法。 方法的默认实现是线程安全的。

应用程序可以指定 ResourceBundle.Control 工厂方法返回 getControl 的实例，也可以从子类 ResourceBundle.Control 创建，以自定义捆绑包加载过程。 下面是更改默认捆绑包加载过程的示例。

<b>示例 1</b>

以下代码 ResourceBundle.getBundle 仅查找基于属性的资源。

import java.util.*;
            import static java.util.ResourceBundle.Control.*;
            ...
            ResourceBundle bundle =
              ResourceBundle.getBundle("MyResources", new Locale("fr", "CH"),
                                       ResourceBundle.Control.getControl(FORMAT_PROPERTIES));

给定说明中示例中 ResourceBundle.getBundle 的资源捆绑包，此 ResourceBundle.getBundle 调用将加载 MyResources_fr_CH.properties 其父级为 MyResources_fr.properties 父 MyResources.properties级的资源捆绑包。 （MyResources_fr_CH.properties 不是隐藏的，而是 MyResources_fr_CH.class 。

<b>示例 2</b>

下面是使用 Properties#loadFromXML(java.io.InputStream) Properties.loadFromXML.. 加载基于 XML 的捆绑包的示例。

ResourceBundle rb = ResourceBundle.getBundle("Messages",
                new ResourceBundle.Control() {
                    public List<String> getFormats(String baseName) {
                        if (baseName == null)
                            throw new NullPointerException();
                        return Arrays.asList("xml");
                    }
                    public ResourceBundle newBundle(String baseName,
                                                    Locale locale,
                                                    String format,
                                                    ClassLoader loader,
                                                    boolean reload)
                                     throws IllegalAccessException,
                                            InstantiationException,
                                            IOException {
                        if (baseName == null || locale == null
                              || format == null || loader == null)
                            throw new NullPointerException();
                        ResourceBundle bundle = null;
                        if (format.equals("xml")) {
                            String bundleName = toBundleName(baseName, locale);
                            String resourceName = toResourceName(bundleName, format);
                            InputStream stream = null;
                            if (reload) {
                                URL url = loader.getResource(resourceName);
                                if (url != null) {
                                    URLConnection connection = url.openConnection();
                                    if (connection != null) {
                                        // Disable caches to get fresh data for
                                        // reloading.
                                        connection.setUseCaches(false);
                                        stream = connection.getInputStream();
                                    }
                                }
                            } else {
                                stream = loader.getResourceAsStream(resourceName);
                            }
                            if (stream != null) {
                                BufferedInputStream bis = new BufferedInputStream(stream);
                                bundle = new XMLResourceBundle(bis);
                                bis.close();
                            }
                        }
                        return bundle;
                    }
                });

            ...

            private static class XMLResourceBundle extends ResourceBundle {
                private Properties props;
                XMLResourceBundle(InputStream stream) throws IOException {
                    props = new Properties();
                    props.loadFromXML(stream);
                }
                protected Object handleGetObject(String key) {
                    return props.getProperty(key);
                }
                public Enumeration<String> getKeys() {
                    ...
                }
            }

已在 1.6 中添加。

Java文档java.util.ResourceBundle.Control。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。