ResourceBundle.Control Classe

Definizione

[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

Ereditarietà

Object

Object

ResourceBundle.Control

Attributi

RegisterAttribute

Commenti

ResourceBundle.Control definisce un set di metodi di callback richiamati dai ResourceBundle#getBundle(String, Locale, ClassLoader, Control) ResourceBundle.getBundle metodi factory durante il processo di caricamento del bundle. In altre parole, un oggetto ResourceBundle.Control collabora con i metodi factory per caricare i bundle di risorse. L'implementazione predefinita dei metodi di callback fornisce le informazioni necessarie per i metodi factory per eseguire il comportamento predefinito.

Oltre ai metodi di callback, i #toBundleName(String, Locale) toBundleName metodi e #toResourceName(String, String) toResourceName vengono definiti principalmente per praticità nell'implementazione dei metodi di callback. Tuttavia, è possibile eseguire l'override del toBundleName metodo per fornire convenzioni diverse nell'organizzazione e la creazione di pacchetti di risorse localizzate. Il toResourceName metodo consiste final nell'evitare l'uso di separatori di risorse e nomi di classe errati.

Due metodi #getControl(List) factory e #getNoFallbackControl(List), forniscono ResourceBundle.Control istanze che implementano varianti comuni del processo di caricamento del bundle predefinito.

I formati restituiti dalle Control#getFormats(String) getFormats impostazioni locali del metodo e dei candidati restituiti dal ResourceBundle.Control#getCandidateLocales(String, Locale) getCandidateLocales metodo devono essere coerenti in tutte le ResourceBundle.getBundle chiamate per lo stesso bundle di base. In caso contrario, i ResourceBundle.getBundle metodi possono restituire bundle imprevisti. Ad esempio, se viene restituito solo "java.class" dal getFormats metodo per la prima chiamata a ResourceBundle.getBundle e solo "java.properties" per la seconda chiamata, la seconda chiamata restituirà quella basata sulla classe memorizzata nella cache durante la prima chiamata.

Un'istanza ResourceBundle.Control deve essere thread-safe se viene usata contemporaneamente da più thread. ResourceBundle.getBundle non esegue la sincronizzazione per chiamare i ResourceBundle.Control metodi. Le implementazioni predefinite dei metodi sono thread-safe.

Le applicazioni possono specificare ResourceBundle.Control istanze restituite dai getControl metodi factory o create da una sottoclasse di ResourceBundle.Control per personalizzare il processo di caricamento del bundle. Di seguito sono riportati esempi di modifica del processo di caricamento del bundle predefinito.

<b>Esempio 1</b>

Il codice seguente consente di ResourceBundle.getBundle cercare solo le risorse basate sulle proprietà.

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

Dato che i bundle di risorse nell'esempio nella ResourceBundle.getBundle descrizione, questa ResourceBundle.getBundle chiamata carica MyResources_fr_CH.properties il cui padre è il cui padre è MyResources_fr.properties MyResources.properties. (MyResources_fr_CH.properties non è nascosto, ma MyResources_fr_CH.class è.

<b>Esempio 2</b>

Di seguito è riportato un esempio di caricamento di bundle basati su XML tramite Properties#loadFromXML(java.io.InputStream) Properties.loadFromXML.

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() {
                    ...
                }
            }

Aggiunta nella versione 1.6.

Documentazione java per java.util.ResourceBundle.Control.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Costruttori

Campi

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Metodi di estensione

Si applica a