11JSON in Java [ package org.json]
2+ ===============================
3+
4+ [ ![ Maven Central] ( https://img.shields.io/maven-central/v/org.json/json.svg )] ( https://mvnrepository.com/artifact/org.json/json )
25
36JSON is a light-weight, language independent, data interchange format.
47See http://www.JSON.org/
@@ -18,64 +21,63 @@ package.
1821The package compiles on Java 1.6-1.8.
1922
2023
21- JSONObject.java: The JSONObject can parse text from a String or a JSONTokener
24+ ** JSONObject.java** : The ` JSONObject ` can parse text from a ` String ` or a ` JSONTokener `
2225to produce a map-like object. The object provides methods for manipulating its
2326contents, and for producing a JSON compliant object serialization.
2427
25- JSONArray.java: The JSONArray can parse text from a String or a JSONTokener
28+ ** JSONArray.java** : The ` JSONArray ` can parse text from a String or a ` JSONTokener `
2629to produce a vector-like object. The object provides methods for manipulating
2730its contents, and for producing a JSON compliant array serialization.
2831
29- JSONTokener.java: The JSONTokener breaks a text into a sequence of individual
30- tokens. It can be constructed from a String, Reader, or InputStream.
32+ ** JSONTokener.java** : The ` JSONTokener ` breaks a text into a sequence of individual
33+ tokens. It can be constructed from a ` String ` , ` Reader ` , or ` InputStream ` .
3134
32- JSONException.java: The JSONException is the standard exception type thrown
35+ ** JSONException.java** : The ` JSONException ` is the standard exception type thrown
3336by this package.
3437
35- JSONPointer.java: Implementation of
38+ ** JSONPointer.java** : Implementation of
3639[ JSON Pointer (RFC 6901)] ( https://tools.ietf.org/html/rfc6901 ) . Supports
3740JSON Pointers both in the form of string representation and URI fragment
3841representation.
3942
40- JSONString.java: The JSONString interface requires a toJSONString method,
43+ ** JSONString.java** : The ` JSONString ` interface requires a ` toJSONString ` method,
4144allowing an object to provide its own serialization.
4245
43- JSONStringer.java: The JSONStringer provides a convenient facility for
46+ ** JSONStringer.java** : The ` JSONStringer ` provides a convenient facility for
4447building JSON strings.
4548
46- JSONWriter.java: The JSONWriter provides a convenient facility for building
49+ ** JSONWriter.java** : The ` JSONWriter ` provides a convenient facility for building
4750JSON text through a writer.
4851
4952
50- CDL.java: CDL provides support for converting between JSON and comma
53+ ** CDL.java** : ` CDL ` provides support for converting between JSON and comma
5154delimited lists.
5255
53- Cookie.java: Cookie provides support for converting between JSON and cookies.
56+ ** Cookie.java** : ` Cookie ` provides support for converting between JSON and cookies.
5457
55- CookieList.java: CookieList provides support for converting between JSON and
58+ ** CookieList.java** : ` CookieList ` provides support for converting between JSON and
5659cookie lists.
5760
58- HTTP.java: HTTP provides support for converting between JSON and HTTP headers.
61+ ** HTTP.java** : ` HTTP ` provides support for converting between JSON and HTTP headers.
5962
60- HTTPTokener.java: HTTPTokener extends JSONTokener for parsing HTTP headers.
63+ ** HTTPTokener.java** : ` HTTPTokener ` extends ` JSONTokener ` for parsing HTTP headers.
6164
62- XML.java: XML provides support for converting between JSON and XML.
65+ ** XML.java** : ` XML ` provides support for converting between JSON and XML.
6366
64- JSONML.java: JSONML provides support for converting between JSONML and XML.
67+ ** JSONML.java** : ` JSONML ` provides support for converting between JSONML and XML.
6568
66- XMLTokener.java: XMLTokener extends JSONTokener for parsing XML text.
69+ ** XMLTokener.java** : ` XMLTokener ` extends ` JSONTokener ` for parsing XML text.
6770
68- Unit tests are maintained in a separate project. Contributing developers can test
69- JSON-java pull requests with the code in this project:
71+ Unit tests are maintained in a separate project. Contributing developers can test
72+ JSON-java pull requests with the code in this project:
7073https://github.com/stleary/JSON-Java-unit-test
7174
72- Numeric types in this package comply with ECMA-404: The JSON Data Interchange Format
73- (http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf) and
74- RFC 7159: The JavaScript Object Notation (JSON) Data Interchange Format
75- (https://tools.ietf.org/html/rfc7159#section-6).
76- This package fully supports Integer, Long, and Double Java types. Partial support
77- for BigInteger and BigDecimal values in JSONObject and JSONArray objects is provided
78- in the form of get(), opt(), and put() API methods.
75+ Numeric types in this package comply with
76+ [ ECMA-404: The JSON Data Interchange Format] ( http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf ) and
77+ [ RFC 7159: The JavaScript Object Notation (JSON) Data Interchange Format] ( https://tools.ietf.org/html/rfc7159#section-6 ) .
78+ This package fully supports ` Integer ` , ` Long ` , and ` Double ` Java types. Partial support
79+ for ` BigInteger ` and ` BigDecimal ` values in ` JSONObject ` and ` JSONArray ` objects is provided
80+ in the form of ` get() ` , ` opt() ` , and ` put() ` API methods.
7981
8082Although 1.6 compatibility is currently supported, it is not a project goal and may be
8183removed in some future release.
@@ -89,26 +91,30 @@ invalid number formats (1.2e6.3) will cause errors as such documents can not be
8991 reliably.
9092
9193Release history:
94+
95+ ~~~
929620171018 Checkpoint for recent commits.
9397
949820170516 Roll up recent commits.
9599
9610020160810 Revert code that was breaking opt*() methods.
97101
98- 20160807 This release contains a bug in the JSONObject.opt*() and JSONArray.opt*() methods,
102+ 20160807 This release contains a bug in the JSONObject.opt*() and JSONArray.opt*() methods,
99103it is not recommended for use.
100104Java 1.6 compatability fixed, JSONArray.toList() and JSONObject.toMap(),
101- RFC4180 compatibility, JSONPointer, some exception fixes, optional XML type conversion.
105+ RFC4180 compatibility, JSONPointer, some exception fixes, optional XML type conversion.
102106Contains the latest code as of 7 Aug, 2016
103107
10410820160212 Java 1.6 compatibility, OSGi bundle. Contains the latest code as of 12 Feb, 2016.
105109
10611020151123 JSONObject and JSONArray initialization with generics. Contains the
107111latest code as of 23 Nov, 2015.
108112
109- 20150729 Checkpoint for Maven central repository release. Contains the latest code
110- as of 29 July, 2015.
113+ 20150729 Checkpoint for Maven central repository release. Contains the latest code
114+ as of 29 July, 2015.
115+ ~~~
116+
111117
112- JSON-java releases can be found by searching the Maven repository for groupId "org.json"
113- and artifactId "json". For example:
118+ JSON-java releases can be found by searching the Maven repository for groupId "org.json"
119+ and artifactId "json". For example:
114120https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.json%22%20AND%20a%3A%22json%22
0 commit comments