211 lines
8.0 KiB
Java
211 lines
8.0 KiB
Java
|
/*
|
||
|
|
* Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
|
||
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||
|
|
*
|
||
|
|
* This code is free software; you can redistribute it and/or modify it
|
||
|
|
* under the terms of the GNU General Public License version 2 only, as
|
||
|
|
* published by the Free Software Foundation. Oracle designates this
|
||
|
|
* particular file as subject to the "Classpath" exception as provided
|
||
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
||
|
|
*
|
||
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
||
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
||
|
|
* accompanied this code).
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU General Public License version
|
||
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
||
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
||
|
|
*
|
||
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
||
|
|
* or visit www.oracle.com if you need additional information or have any
|
||
|
|
* questions.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
* (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved
|
||
|
|
* (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved
|
||
|
|
*
|
||
|
|
* The original version of this source code and documentation
|
||
|
|
* is copyrighted and owned by Taligent, Inc., a wholly-owned
|
||
|
|
* subsidiary of IBM. These materials are provided under terms
|
||
|
|
* of a License Agreement between Taligent and Sun. This technology
|
||
|
|
* is protected by multiple US and International patents.
|
||
|
|
*
|
||
|
|
* This notice and attribution to Taligent may not be removed.
|
||
|
|
* Taligent is a registered trademark of Taligent, Inc.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
package java.util;
|
||
|
|
|
||
|
|
import sun.util.ResourceBundleEnumeration;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* {@code ListResourceBundle} is an abstract subclass of
|
||
|
|
* {@code ResourceBundle} that manages resources for a locale
|
||
|
|
* in a convenient and easy to use list. See {@code ResourceBundle} for
|
||
|
|
* more information about resource bundles in general.
|
||
|
|
*
|
||
|
|
* <P>
|
||
|
|
* Subclasses must override {@code getContents} and provide an array,
|
||
|
|
* where each item in the array is a pair of objects.
|
||
|
|
* The first element of each pair is the key, which must be a
|
||
|
|
* {@code String}, and the second element is the value associated with
|
||
|
|
* that key.
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* The following <a id="sample">example</a> shows two members of a resource
|
||
|
|
* bundle family with the base name "MyResources".
|
||
|
|
* "MyResources" is the default member of the bundle family, and
|
||
|
|
* "MyResources_fr" is the French member.
|
||
|
|
* These members are based on {@code ListResourceBundle}
|
||
|
|
* (a related <a href="PropertyResourceBundle.html#sample">example</a> shows
|
||
|
|
* how you can add a bundle to this family that's based on a properties file).
|
||
|
|
* The keys in this example are of the form "s1" etc. The actual
|
||
|
|
* keys are entirely up to your choice, so long as they are the same as
|
||
|
|
* the keys you use in your program to retrieve the objects from the bundle.
|
||
|
|
* Keys are case-sensitive.
|
||
|
|
* <blockquote>
|
||
|
|
* <pre>
|
||
|
|
*
|
||
|
|
* public class MyResources extends ListResourceBundle {
|
||
|
|
* protected Object[][] getContents() {
|
||
|
|
* return new Object[][] {
|
||
|
|
* // LOCALIZE THIS
|
||
|
|
* {"s1", "The disk \"{1}\" contains {0}."}, // MessageFormat pattern
|
||
|
|
* {"s2", "1"}, // location of {0} in pattern
|
||
|
|
* {"s3", "My Disk"}, // sample disk name
|
||
|
|
* {"s4", "no files"}, // first ChoiceFormat choice
|
||
|
|
* {"s5", "one file"}, // second ChoiceFormat choice
|
||
|
|
* {"s6", "{0,number} files"}, // third ChoiceFormat choice
|
||
|
|
* {"s7", "3 Mar 96"}, // sample date
|
||
|
|
* {"s8", new Dimension(1,5)} // real object, not just string
|
||
|
|
* // END OF MATERIAL TO LOCALIZE
|
||
|
|
* };
|
||
|
|
* }
|
||
|
|
* }
|
||
|
|
*
|
||
|
|
* public class MyResources_fr extends ListResourceBundle {
|
||
|
|
* protected Object[][] getContents() {
|
||
|
|
* return new Object[][] {
|
||
|
|
* // LOCALIZE THIS
|
||
|
|
* {"s1", "Le disque \"{1}\" {0}."}, // MessageFormat pattern
|
||
|
|
* {"s2", "1"}, // location of {0} in pattern
|
||
|
|
* {"s3", "Mon disque"}, // sample disk name
|
||
|
|
* {"s4", "ne contient pas de fichiers"}, // first ChoiceFormat choice
|
||
|
|
* {"s5", "contient un fichier"}, // second ChoiceFormat choice
|
||
|
|
* {"s6", "contient {0,number} fichiers"}, // third ChoiceFormat choice
|
||
|
|
* {"s7", "3 mars 1996"}, // sample date
|
||
|
|
* {"s8", new Dimension(1,3)} // real object, not just string
|
||
|
|
* // END OF MATERIAL TO LOCALIZE
|
||
|
|
* };
|
||
|
|
* }
|
||
|
|
* }
|
||
|
|
* </pre>
|
||
|
|
* </blockquote>
|
||
|
|
*
|
||
|
|
* <p>
|
||
|
|
* The implementation of a {@code ListResourceBundle} subclass must be thread-safe
|
||
|
|
* if it's simultaneously used by multiple threads. The default implementations
|
||
|
|
* of the methods in this class are thread-safe.
|
||
|
|
*
|
||
|
|
* @see ResourceBundle
|
||
|
|
* @see PropertyResourceBundle
|
||
|
|
* @since 1.1
|
||
|
|
*/
|
||
|
|
public abstract class ListResourceBundle extends ResourceBundle {
|
||
|
|
/**
|
||
|
|
* Sole constructor. (For invocation by subclass constructors, typically
|
||
|
|
* implicit.)
|
||
|
|
*/
|
||
|
|
public ListResourceBundle() {
|
||
|
|
}
|
||
|
|
|
||
|
|
// Implements java.util.ResourceBundle.handleGetObject; inherits javadoc specification.
|
||
|
|
public final Object handleGetObject(String key) {
|
||
|
|
// lazily load the lookup hashtable.
|
||
|
|
if (lookup == null) {
|
||
|
|
loadLookup();
|
||
|
|
}
|
||
|
|
if (key == null) {
|
||
|
|
throw new NullPointerException();
|
||
|
|
}
|
||
|
|
return lookup.get(key); // this class ignores locales
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an {@code Enumeration} of the keys contained in
|
||
|
|
* this {@code ResourceBundle} and its parent bundles.
|
||
|
|
*
|
||
|
|
* @return an {@code Enumeration} of the keys contained in
|
||
|
|
* this {@code ResourceBundle} and its parent bundles.
|
||
|
|
* @see #keySet()
|
||
|
|
*/
|
||
|
|
public Enumeration<String> getKeys() {
|
||
|
|
// lazily load the lookup hashtable.
|
||
|
|
if (lookup == null) {
|
||
|
|
loadLookup();
|
||
|
|
}
|
||
|
|
|
||
|
|
ResourceBundle parent = this.parent;
|
||
|
|
return new ResourceBundleEnumeration(lookup.keySet(),
|
||
|
|
(parent != null) ? parent.getKeys() : null);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a {@code Set} of the keys contained
|
||
|
|
* <em>only</em> in this {@code ResourceBundle}.
|
||
|
|
*
|
||
|
|
* @return a {@code Set} of the keys contained only in this
|
||
|
|
* {@code ResourceBundle}
|
||
|
|
* @since 1.6
|
||
|
|
* @see #keySet()
|
||
|
|
*/
|
||
|
|
protected Set<String> handleKeySet() {
|
||
|
|
if (lookup == null) {
|
||
|
|
loadLookup();
|
||
|
|
}
|
||
|
|
return lookup.keySet();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an array in which each item is a pair of objects in an
|
||
|
|
* {@code Object} array. The first element of each pair is
|
||
|
|
* the key, which must be a {@code String}, and the second
|
||
|
|
* element is the value associated with that key. See the class
|
||
|
|
* description for details.
|
||
|
|
*
|
||
|
|
* @return an array of an {@code Object} array representing a
|
||
|
|
* key-value pair.
|
||
|
|
*/
|
||
|
|
protected abstract Object[][] getContents();
|
||
|
|
|
||
|
|
// ==================privates====================
|
||
|
|
|
||
|
|
/**
|
||
|
|
* We lazily load the lookup hashtable. This function does the
|
||
|
|
* loading.
|
||
|
|
*/
|
||
|
|
private synchronized void loadLookup() {
|
||
|
|
if (lookup != null)
|
||
|
|
return;
|
||
|
|
|
||
|
|
Object[][] contents = getContents();
|
||
|
|
HashMap<String,Object> temp = new HashMap<>(contents.length);
|
||
|
|
for (Object[] content : contents) {
|
||
|
|
// key must be non-null String, value must be non-null
|
||
|
|
String key = (String) content[0];
|
||
|
|
Object value = content[1];
|
||
|
|
if (key == null || value == null) {
|
||
|
|
throw new NullPointerException();
|
||
|
|
}
|
||
|
|
temp.put(key, value);
|
||
|
|
}
|
||
|
|
lookup = temp;
|
||
|
|
}
|
||
|
|
|
||
|
|
private volatile Map<String,Object> lookup;
|
||
|
|
}
|