- All Implemented Interfaces:
Serializable
,Cloneable
,Map<Object,Object>
- Direct Known Subclasses:
Provider
Properties
class represents a persistent set of
properties. The Properties
can be saved to a stream
or loaded from a stream. Each key and its corresponding value in
the property list is a string.
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.
Because Properties
inherits from Hashtable
, the
put
and putAll
methods can be applied to a
Properties
object. Their use is strongly discouraged as they
allow the caller to insert entries whose keys or values are not
Strings
. The setProperty
method should be used
instead. If the store
or save
method is called
on a "compromised" Properties
object that contains a
non-String
key or value, the call will fail. Similarly,
the call to the propertyNames
or list
method
will fail if it is called on a "compromised" Properties
object that contains a non-String
key.
The iterators returned by the iterator
method of this class's
"collection views" (that is, entrySet()
, keySet()
, and
values()
) may not fail-fast (unlike the Hashtable implementation).
These iterators are guaranteed to traverse elements as they existed upon
construction exactly once, and may (but are not guaranteed to) reflect any
modifications subsequent to construction.
The load(Reader)
/
store(Writer, String)
methods load and store properties from and to a character based stream
in a simple line-oriented format specified below.
The load(InputStream)
/