TOML Parser for Java
TOML Parser for Java
The JToml class has methods for parsing Toml from files, input streams, readers are just strings
jtoml does not need the entire toml in memory while parsing,
but reads it while parsing only keeping in memory the current line being read
Toml toml = JToml.parseString("foo = 42"); //Parsing a String
toml = JToml.parse(ExampleTomlTest.class.getResourceAsStream("/example.toml")); //From an input stream
toml = JToml.parse(new File("/example.toml")); //From a file
toml = JToml.parse(new StringReader("foo = 42")); // From a reader
Parsing a TOML file returns a Toml instance, which is the root keygroup.
KeyGroups have methods to return local values (directly in this keygroup)
or a relative value (e.g. getting "y.z." from keygroup "x" will return the value for "x.y.z").
toml.getValue("foo"); // Object
toml.getString("foo"); // String
toml.getBoolean("foo"); // Boolean
toml.getDate("foo"); // Date
toml.getDouble("foo"); // Double
toml.getLong("foo"); // Long
toml.getList("foo"); // List<Object>
toml.getKeyGroup("foo"); // KeyGroup
toml.getLocalValue("foo"); // returns the value for "foo", dots are not allowed
toml.getLocalXXX("foo"); //....
You can create a POJO class instance, filling it with values for a given keygroup.
Any field that isn't a type of String, Date, List, Boolean, Double, Long is assumed to be a nested POJO type and is
recursively mapped (it's value in the toml should be a keygroup).
[foo]
stringKey="a"
longKey=42
doubleKey=13.37
booleanKey=true
listKey=[1,2,3]
[foo.bar]
bazz="Hello"
dummy=459
Retrieving
class Foo {
String stringKey;
Long longKey;
Double doubleKey;
Boolean booleanKey;
List<Object> listKey;
Bar bar;
Boolean awesome;
}
class Bar {
String bazz;
Long dummy;
}
Foo foo = toml.getKeyGroup("foo").asObject(Foo.class);