Java Properties Class

---

---

Introduction

The Java Properties class is a class which represents a persistent set of properties. The Properties can be saved to a stream or loaded from a stream. Following are the important points about Properties −

• 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.

• This class is thread-safe; multiple threads can share a single Properties object without the need for external synchronization.

Class declaration

Following is the declaration for java.util.Properties class −

 public class Properties extends Hashtable<Object,Object> 

Field

Following are the fields for java.util.Properties class −

protected Properties defaults − This is the property list that contains default values for any keys not found in this property list.

Class constructors

Sr.No.	Constructor & Description
1	Properties() This constructs creates an empty property list with no default values.
2	Properties(int initialCapacity) This constructs creates an empty property list with no default values, and with an initial size accommodating the specified number of elements without the need to dynamically resize.
3	Properties(Properties defaults) This constructs creates an empty property list with the specified defaults.

Class methods

Sr.No.	Method & Description
1	String getProperty(String key) This method searches for the property with the specified key in this property list.
2	void list(PrintStream out) This method prints this property list out to the specified output stream.
3	void load(InputStream inStream) This method reads a property list (key and element pairs) from the input byte stream.
4	void loadFromXML(InputStream in) This method loads all of the properties represented by the XML document on the specified input stream into this properties table.
5	Enumeration<?> propertyNames() This method returns an enumeration of all the keys in this property list, including distinct keys in the default property list if a key of the same name has not already been found from the main properties list.
6	Object setProperty(String key, String value) This method calls the Hashtable method put.
7	void store(OutputStream out, String comments) The method writes this property list (key and element pairs) in this Properties table to the output stream in a format suitable for loading into a Properties table using the load(InputStream) method.
8	void storeToXML(OutputStream os, String comment) This method emits an XML document representing all of the properties contained in this table.
9	Set<String> stringPropertyNames() This method returns a set of keys in this property list where the key and its corresponding value are strings, including distinct keys in the default property list if a key of the same name has not already been found from the main properties list.

Methods inherited

This class inherits methods from the following classes −

• java.util.Hashtable
• java.util.Object

Getting an Enumeration of Properties Keys Example

The following example shows the usage of java.util.Properties.propertyNames() method.

 package com.tutorialspoint; import java.util.Enumeration; import java.util.Properties; public class PropertiesDemo { public static void main(String[] args) { Properties prop = new Properties(); // add some properties prop.put("Height", "200"); prop.put("Width", "15"); // assign the property names in a enumaration Enumeration<?> enumeration = prop.propertyNames(); // print the enumaration elements while(enumeration.hasMoreElements()) { System.out.println("" + enumeration.nextElement()); } } } 

Output

Let us compile and run the above program, this will produce the following result −

 Width Height