# Java Properties format

The Java Properties class, java.util.Properties, is like a Java Map of Java String key and value pairs. The Java Properties class can write the key, value pairs to a properties file on disk, and read the properties back in again. This is an often used mechanism for storing simple configuration properties for Java applications.

# Dependencies

DataTree API supports 2 Java Property reader/writer implementations. The default (built-in) Property adapter has no dependencies.

// Parsing Java Properties file
String properties = "< ... properties ...>";
Tree document = new Tree(properties, "properties");

// Getting / setting values
boolean value = document.get("array[2].subItem.value", false);
document.put("path.to.item", true);

// Generating Java Properties string from Tree
String properties = document.toString("properties");

If there is more than one Promerties implementation on classpath, the preferred implementation is adjustable with the following System Properties:

// Using Jackson API:
-Ddatatree.properties.reader=io.datatree.dom.adapters.PropertiesJackson
-Ddatatree.properties.writer=io.datatree.dom.adapters.PropertiesJackson

// Using built-in API:
-Ddatatree.properties.reader=io.datatree.dom.adapters.PropertiesBuiltin
-Ddatatree.properties.writer=io.datatree.dom.adapters.PropertiesBuiltin

# Required dependencies of Java Property adapters