FAQ

Why isn't support included for Maven, Gradle, or any other tools?

When this app was first written, there was not a single universally agreed upon build tool. This still seems to be the case. Periodically, Maven Repository releases are built and distributed here: http://mvnrepository.com/artifact/org.json/json

Why isn't ordering allowed in JSONObjects?

Support for ordering is one of the most popular requests, along with adding some type of build support. However, from the JSON spec RFC 7159: "An object is an unordered collection of zero or more name/value pairs". As a reference app, the design is required to stay as close to the spec as possible, so ordering in JSONObjects is not supported.

Will ordering ever be allowed in JSONObjects?

There are no current plans to support ordering. It is not expected that this will ever change.

Where are the unit tests?

The unit tests can be found in https://github.com/stleary/JSON-Java-unit-test, along with instructions for combining the tests with this app.

What is the goal of this project?

• Continue in maintenance mode, in terms of stability, availability, and accessibility of the project
• Make sure it continues to compile against new Java versions
• Fix reported bugs.
• Maintain compatibility with RFC 7159 and ECMA-404
• Avoid any actions that would affect the ability of users to access and use the software
• Provide some technical documentation and answer questions regarding the project design and use
• Provide unit tests

What kind of changes will be accepted for this project?

• Bug fixes and incompatibilities with the specs are given high priority.
• Build enhancements will not be accepted (although build enhancements to the unit tests are welcome).
• Style and formatting changes will not be accepted.
• Adding new functionality will be considered.
• Changing the behavior of the lib has a high bar for acceptance.

Why doesn't this project have a distributable jar file? It should. Will try to come up with some reasonable support soon.