maljson

Looking for a json parser?

Looking to parse json? You should probably use Jackson.

Project Summary

org.json is the original java library prototype for handling json. It is unfortunately only available under a non-free license.

The Android team created a cleanroom library that is api compatible with org.json but licensed under the Apache license version 2. maljson re-packages the Android work as a stand alone library. If you need a json parser, you should use Jackson, but if you need org.json compatibility then maljson might be of help.

Difference from Android upstream:

• Syntax exceptions include line/column numbers
• New getters for retrieving line/column numbers of JSONObject and JSONArray items
• Trailing commas in objects are allowed
• Trailing commas in arrays are not interpreted as null
• A few missing methods (such as keySet()) were added.

Android copyright notices and comments have been retained in the classes that originated there. Diverged from Android libcore at d62e296abe060ff7557e731fe70f240dbaa142e8.

Praise should go to the Android team for the work that they have done, but bugs should be reported here (not on the Android tracker).

Building

maljson uses Apache Maven which is beyond the scope to detail. The super simple quick start is:

mvn test

Use

<dependency>
  <groupId>com.addthis</groupId>
  <artifactId>maljson</artifactId>
  <version>latest-and-greatest</version>
</dependency>

You can either install locally, or releases will eventually make their way to maven central.

Administrative

Versioning

It's x.y.z where:

• x: something major happened
• y: next release
• z: bug fix only

License

maljson is released under the Apache License Version 2.0. See Apache or the LICENSE for details.