Plexus-Mirror/toml4j
1
0
Fork 0
mirror of https://github.com/plexusorg/toml4j.git synced 2024-12-29 11:42:15 +00:00
Code Issues Projects Releases Wiki Activity

Update README for the 0.5.0 release.

Browse source
This commit is contained in:
Jonathan Wood 2016-01-14 08:23:11 -08:00
parent b1436c557d
commit aacd2bf319
1 changed files with 10 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
README.md
View file

@ -14,7 +14,7 @@ Add the following dependency to your POM (or equivalent for other dependency man
<dependency> <dependency>
<groupId>com.moandjiezana.toml</groupId> <groupId>com.moandjiezana.toml</groupId>
<artifactId>toml4j</artifactId> <artifactId>toml4j</artifactId>
<version>0.4.0</version> <version>0.5.0</version>
</dependency> </dependency>
``` ```
@ -23,7 +23,7 @@ Requires Java 1.6.
## Quick start ## Quick start
```java ```java
Toml toml = new Toml().parse(getTomlFile()); Toml toml = new Toml().read(getTomlFile());
String someValue = toml.getString("someKey"); String someValue = toml.getString("someKey");
Date someDate = toml.getDate("someTable.someDate"); Date someDate = toml.getDate("someTable.someDate");
MyClass myClass = toml.to(MyClass.class); MyClass myClass = toml.to(MyClass.class);
@ -31,10 +31,10 @@ MyClass myClass = toml.to(MyClass.class);
## Usage ## Usage
A `com.moandjiezana.toml.Toml` instance is populated by calling one of `parse(File)`, `parse(InputStream)`, `parse(Reader)` or `parse(String)`. A `com.moandjiezana.toml.Toml` instance is populated by calling one of `read(File)`, `read(InputStream)`, `read(Reader)` or `read(String)`.
```java ```java
Toml toml = new Toml().parse("a=1"); Toml toml = new Toml().read("a=1");
``` ```
An exception is thrown if the source is not valid TOML. An exception is thrown if the source is not valid TOML.
@ -70,7 +70,7 @@ class User {
``` ```
```java ```java
User user = new Toml().parse(tomlFile).to(User.class); User user = new Toml().read(tomlFile).to(User.class);
assert user.name.equals("Mwanji Ezana"); assert user.name.equals("Mwanji Ezana");
assert user.address.street.equals("123 A Street"); assert user.address.street.equals("123 A Street");
@ -146,7 +146,7 @@ title = "TOML Example"
``` ```
```java ```java
Toml toml = new Toml().parse(getTomlFile()); Toml toml = new Toml().read(getTomlFile());
String title = toml.getString("title"); String title = toml.getString("title");
String subTitle = toml.getString("\"sub title\""); String subTitle = toml.getString("\"sub title\"");
@ -191,8 +191,8 @@ a = 1
``` ```
```java ```java
Toml defaults = new Toml().parse(getDefaultsFile()); Toml defaults = new Toml().read(getDefaultsFile());
Toml toml = new Toml(defaults).parse(getTomlFile()); Toml toml = new Toml(defaults).read(getTomlFile());
Long a = toml.getLong("a"); // returns 1, not 2 Long a = toml.getLong("a"); // returns 1, not 2
Long b = toml.getLong("b"); // returns 3, taken from defaults provided to constructor Long b = toml.getLong("b"); // returns 3, taken from defaults provided to constructor
@ -217,7 +217,7 @@ for (Map.Entry<String, Object> entry : myToml.entrySet()) {
You can also convert a Toml instance to a `Map<String, Object>`: You can also convert a Toml instance to a `Map<String, Object>`:
```java ```java
Toml toml = new Toml().parse("a = 1"); Toml toml = new Toml().read("a = 1");
Map<String, Object> map = toml.to(Map.class); Map<String, Object> map = toml.to(Map.class);
``` ```
@ -225,7 +225,7 @@ Map<String, Object> map = toml.to(Map.class);
```java ```java
Toml toml = new Toml().parse("a = 1"); Toml toml = new Toml().read("a = 1");
toml.contains("a"); // true toml.contains("a"); // true
toml.conatinsKey("a"); // true toml.conatinsKey("a"); // true