diff -r fd16c54261b3 -r 90ce3da70b43 jdk/src/share/classes/sun/util/resources/OpenListResourceBundle.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jdk/src/share/classes/sun/util/resources/OpenListResourceBundle.java Sat Dec 01 00:00:00 2007 +0000 @@ -0,0 +1,148 @@ +/* + * Portions Copyright 2005-2007 Sun Microsystems, Inc. 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. Sun designates this + * particular file as subject to the "Classpath" exception as provided + * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, + * CA 95054 USA or visit www.sun.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 sun.util.resources; + +import java.util.Enumeration; +import java.util.HashMap; +import java.util.Map; +import java.util.ResourceBundle; +import java.util.Set; +import sun.util.ResourceBundleEnumeration; + +/** + * Subclass of ResourceBundle which mimics + * ListResourceBundle, but provides more hooks + * for specialized subclass behavior. For general description, + * see {@link java.util.ListResourceBundle}. + *

+ * This class leaves handleGetObject non-final, and + * adds a method createMap which allows subclasses to + * use specialized Map implementations. + */ +public abstract class OpenListResourceBundle extends ResourceBundle { + /** + * Sole constructor. (For invocation by subclass constructors, typically + * implicit.) + */ + protected OpenListResourceBundle() { + } + + // Implements java.util.ResourceBundle.handleGetObject; inherits javadoc specification. + public Object handleGetObject(String key) { + if (key == null) { + throw new NullPointerException(); + } + + loadLookupTablesIfNecessary(); + return lookup.get(key); // this class ignores locales + } + + /** + * Implementation of ResourceBundle.getKeys. + */ + public Enumeration getKeys() { + ResourceBundle parent = this.parent; + return new ResourceBundleEnumeration(handleGetKeys(), + (parent != null) ? parent.getKeys() : null); + } + + /** + * Returns a set of keys provided in this resource bundle + */ + public Set handleGetKeys() { + loadLookupTablesIfNecessary(); + + return lookup.keySet(); + } + + /** + * Returns the parent bundle + */ + public OpenListResourceBundle getParent() { + return (OpenListResourceBundle)parent; + } + + /** + * See ListResourceBundle class description. + */ + abstract protected Object[][] getContents(); + + /** + * Load lookup tables if they haven't been loaded already. + */ + void loadLookupTablesIfNecessary() { + if (lookup == null) { + loadLookup(); + } + } + + /** + * We lazily load the lookup hashtable. This function does the + * loading. + */ + private synchronized void loadLookup() { + if (lookup != null) + return; + + Object[][] contents = getContents(); + Map temp = createMap(contents.length); + for (int i = 0; i < contents.length; ++i) { + // key must be non-null String, value must be non-null + String key = (String) contents[i][0]; + Object value = contents[i][1]; + if (key == null || value == null) { + throw new NullPointerException(); + } + temp.put(key, value); + } + lookup = temp; + } + + /** + * Lets subclasses provide specialized Map implementations. + * Default uses HashMap. + */ + protected Map createMap(int size) { + return new HashMap(size); + } + + private Map lookup = null; +}