Java Platform 1.2

Class PropertyResourceBundle


public class PropertyResourceBundle
extends ResourceBundle

PropertyResourceBundle is a concrete subclass of ResourceBundle that manages resources for a locale using a set of static strings from a property file. See ResourceBundle for more information about resource bundles in general.

Unlike other types of resource bundle, you don't subclass PropertyResourceBundle. Instead, you supply properties files containing the resource data. ResourceBundle.getBundle() will automatically look for the appropriate properties file and create a PropertyResourceBundle that refers to it. The resource bundle name that you pass to ResourceBundle.getBundle() is the file name of the properties file, not the class name of the object that is returned.

For example, if you say ResourceBundle.getBundle("MyResources", new Locale("fr", "FR")); the resource bundle lookup mechanism will search the class path for a file called

If a real class and a properties file with a particular name both exist, the class wins; the properties file will only be used if there is no class with the desired name.

In the following example, the keys are of the form "s1"... 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.

 s3=3 Mar 96
 s4=Der disk '{1}' a {0} a {2}.
 s6=keine Datein
 s8=ein Datei
 s10={0}|3 Datein
 s11=Der Format worf ein Exception: {0}

See Also:
ResourceBundle, ListResourceBundle

Fields inherited from class java.util.ResourceBundle
Constructor Summary
PropertyResourceBundle(InputStream stream)
          Creates a property resource
Method Summary
 Enumeration getKeys()
          Implementation of ResourceBundle.getKeys.
 Object handleGetObject(String key)
          Override of ResourceBundle, same semantics
Methods inherited from class java.util.ResourceBundle
getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, setParent
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public PropertyResourceBundle(InputStream stream)
                       throws IOException
Creates a property resource
stream - property file to read from.
Method Detail


public Object handleGetObject(String key)
Override of ResourceBundle, same semantics
handleGetObject in class ResourceBundle


public Enumeration getKeys()
Implementation of ResourceBundle.getKeys.
getKeys in class ResourceBundle

Java Platform 1.2

Submit a bug or feature Version 1.2 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.