A minimalistic yet highly functional JSON library

Features

• Lightweight - small filesize and no dependencies and quick parsing
• No boilerplate - as simplistic as possible, yet very flexible
• Easy mapping - Easily convert JSON to objects, and back

Examples

Presuming you have the following JSON stored as a string called "jsonString":

{
  "name":"Bob",
  "age":25,
  "siblings":[
    "Jeff",
    "Sarah"
  ],
  "address":{
    "road":"Roadway Drive",
    "house":123,
    "city":"Townington",
    "country":"Germany"
  }
}

Basic usage

You can easily access fields using the JSON and JSONArray objects:

JSON person = new JSON(jsonString);
System.out.println(person.string("name")); // prints "Bob"
System.out.println(person.array("siblings").string(0)); // prints "Jeff"
System.out.println(person.json("address").string("city")); // prints "Townington"

Object mapping

If you have the following classes, you are able to map the JSON object to a Person object. Notice the annotations, these will be elaborated upon later.

public class Person {
    @JSONField(key="name") private String name;
    @JSONField(key="age") private Integer age;
    @JSONField(key="siblings") private String[] siblings;
    @JSONField(key="address") private Address address;

    public String getName() { return name; }
    public Integer getAge() { return age; }
    public String[] getSiblings() { return siblings; }
    public Address getAddress() { return address; }
}

public class Address {
    @JSONField(key = "road") private String road;
    @JSONField(key =  "house") private int house;
    @JSONField(key = "city") private String city;
    @JSONField(key = "country") private String country;
    private String something;

    public String getRoad() { return road; }
    public int getHouse() { return house; }
    public String getCity() { return city; }
    public String getCountry() { return country; }
}

After creating the JSON object, you can then specify to marshal it to a Person object.

JSON person = new JSON(jsonString);
Person personObject = person.marshal(Person.class);
System.out.println(personObject.getAge()); // prints "25"

The annotation @JSONField specifies that the field should be set to the value of the key specified in the annotation. The keys specified in the variadic arguments will be ignored, regardless of annotation. This goes both ways, and is used when creating a JSON object from a Java object, only then the variadic arguments represent the ignored fields, rather than keys.

Usage

Add Kotys as a dependency to your project. Replace {version} with the version you would like, a list can be found here.

Maven

<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>
<dependencies>
  <dependency>
    <groupId>com.github.Arraying</groupId>
    <artifactId>Kotys</artifactId>
    <version>{version}</version>
  </dependency>
</dependencies>

Gradle

repositories {
  maven { 
    url 'https://jitpack.io' 
  }
}
dependencies {
  compile 'com.github.Arraying:Kotys:{version}'
}

Development & Contribution

I will be providing bugfixes and changes. If you'd like to contribute, great! Currently, the main focus on the library should be opimization. Just make any changes and PR.