<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Class java.util.Properties
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.util.html">This Package</a>  <a href="java.util.Observable.html#_top_">Previous</a>  <a href="java.util.PropertyResourceBundle.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.util.Properties
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----<a href="java.util.Dictionary.html#_top_">java.util.Dictionary</a>
           |
           +----<a href="java.util.Hashtable.html#_top_">java.util.Hashtable</a>
                   |
                   +----java.util.Properties
</pre>
<hr>
<dl>
  <dt> public class <b>Properties</b>
  <dt> extends <a href="java.util.Hashtable.html#_top_">Hashtable</a>
</dl>
The <code>Properties</code> class represents a persistent set of 
 properties. The <code>Properties</code> can be saved to a stream 
 or loaded from a stream. Each key and its corresponding value in 
 the property list is a string. 
 <p>
 A property list can contain another property list as its 
 "defaults"; this second property list is searched if 
 the property key is not found in the original property list.
<p>
<hr>
<a name="index"></a>
<h2>
  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
</h2>
<dl>
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#defaults"><b>defaults</b></a>
  <dd>  A property list that contains default values for any keys not 
 found in this property list.
</dl>
<h2>
  <img src="images/constructor-index.gif" width=275 height=38 alt="Constructor Index">
</h2>
<dl>
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#Properties()"><b>Properties</b></a>()
  <dd>  Creates an empty property list with no default values.
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#Properties(java.util.Properties)"><b>Properties</b></a>(Properties)
  <dd>  Creates an empty property list with the specified defaults.
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getProperty(java.lang.String)"><b>getProperty</b></a>(String)
  <dd>  Searches for the property with the specified key in this property list.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getProperty(java.lang.String, java.lang.String)"><b>getProperty</b></a>(String, String)
  <dd>  Searches for the property with the specified key in this property list.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#list(java.io.PrintStream)"><b>list</b></a>(PrintStream)
  <dd>  Prints this property list out to the specified output stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#list(java.io.PrintWriter)"><b>list</b></a>(PrintWriter)
  <dd>  Prints this property list out to the specified output stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#load(java.io.InputStream)"><b>load</b></a>(InputStream)
  <dd>  Reads a property list from an input stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#propertyNames()"><b>propertyNames</b></a>()
  <dd>  Returns an enumeration of all the keys in this property list, including
 the keys in the default property list.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#save(java.io.OutputStream, java.lang.String)"><b>save</b></a>(OutputStream, String)
  <dd>  Stores this property list to the specified output stream.
</dl>
<a name="variables"></a>
<h2>
  <img src="images/variables.gif" width=153 height=38 alt="Variables">
</h2>
<a name="defaults"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>defaults</b>
<pre>
 protected <a href="#_top_">Properties</a> defaults
</pre>
<dl>
  <dd> A property list that contains default values for any keys not 
 found in this property list.<p>
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="Properties"></a>
<a name="Properties()"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>Properties</b>
<pre>
 public Properties()
</pre>
<dl>
  <dd> Creates an empty property list with no default values.
<p>
</dl>
<a name="Properties(java.util.Properties)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>Properties</b>
<pre>
 public Properties(<a href="#_top_">Properties</a> defaults)
</pre>
<dl>
  <dd> Creates an empty property list with the specified defaults.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> defaults - the defaults.
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="load(java.io.InputStream)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="load"><b>load</b></a>
<pre>
 public synchronized void load(<a href="java.io.InputStream.html#_top_">InputStream</a> in) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Reads a property list from an input stream.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> in - the input stream.
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> if an error occurred when reading from the
               input stream.
  </dl></dd>
</dl>
<a name="save(java.io.OutputStream, java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="save"><b>save</b></a>
<pre>
 public synchronized void save(<a href="java.io.OutputStream.html#_top_">OutputStream</a> out,
                               <a href="java.lang.String.html#_top_">String</a> header)
</pre>
<dl>
  <dd> Stores this property list to the specified output stream. The 
 string header is printed as a comment at the beginning of the stream.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - an output stream.
    <dd> header - a description of the property list.
  </dl></dd>
</dl>
<a name="getProperty(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProperty"><b>getProperty</b></a>
<pre>
 public <a href="java.lang.String.html#_top_">String</a> getProperty(<a href="java.lang.String.html#_top_">String</a> key)
</pre>
<dl>
  <dd> Searches for the property with the specified key in this property list.
 If the key is not found in this property list, the default property list,
 and its defaults, recursively, are then checked. The method returns
 <code>null</code> if the property is not found.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> key - the property key.
    <dt> <b>Returns:</b>
    <dd> the value in this property list with the specified key value.
    <dt> <b>See Also:</b>
    <dd> <a href="#defaults">defaults</a>
  </dl></dd>
</dl>
<a name="getProperty(java.lang.String, java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProperty"><b>getProperty</b></a>
<pre>
 public <a href="java.lang.String.html#_top_">String</a> getProperty(<a href="java.lang.String.html#_top_">String</a> key,
                           <a href="java.lang.String.html#_top_">String</a> defaultValue)
</pre>
<dl>
  <dd> Searches for the property with the specified key in this property list.
 If the key is not found in this property list, the default property list,
 and its defaults, recursively, are then checked. The method returns the
 default value argument if the property is not found.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> key - the hashtable key.
    <dd> defaultValue - a default value.
    <dt> <b>Returns:</b>
    <dd> the value in this property list with the specified key value.
    <dt> <b>See Also:</b>
    <dd> <a href="#defaults">defaults</a>
  </dl></dd>
</dl>
<a name="propertyNames()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="propertyNames"><b>propertyNames</b></a>
<pre>
 public <a href="java.util.Enumeration.html#_top_">Enumeration</a> propertyNames()
</pre>
<dl>
  <dd> Returns an enumeration of all the keys in this property list, including
 the keys in the default property list.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> an enumeration of all the keys in this property list, including
          the keys in the default property list.
    <dt> <b>See Also:</b>
    <dd> <a href="java.util.Enumeration.html#_top_">Enumeration</a>, <a href="#defaults">defaults</a>
  </dl></dd>
</dl>
<a name="list(java.io.PrintStream)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="list"><b>list</b></a>
<pre>
 public void list(<a href="java.io.PrintStream.html#_top_">PrintStream</a> out)
</pre>
<dl>
  <dd> Prints this property list out to the specified output stream. 
 This method is useful for debugging.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - an output stream.
  </dl></dd>
</dl>
<a name="list(java.io.PrintWriter)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="list"><b>list</b></a>
<pre>
 public void list(<a href="java.io.PrintWriter.html#_top_">PrintWriter</a> out)
</pre>
<dl>
  <dd> Prints this property list out to the specified output stream. 
 This method is useful for debugging.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - an output stream.
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.util.html">This Package</a>  <a href="java.util.Observable.html#_top_">Previous</a>  <a href="java.util.PropertyResourceBundle.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
