Skip to content

Commit ca45b02

Browse files
authored
Merge pull request stleary#381 from fleipold/maven-badge
Adding maven badge to readme
2 parents 28e09dc + b6efbab commit ca45b02

File tree

1 file changed

+38
-32
lines changed

1 file changed

+38
-32
lines changed
Lines changed: 38 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
11
JSON 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

36
JSON is a light-weight, language independent, data interchange format.
47
See http://www.JSON.org/
@@ -18,64 +21,63 @@ package.
1821
The 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`
2225
to produce a map-like object. The object provides methods for manipulating its
2326
contents, 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`
2629
to produce a vector-like object. The object provides methods for manipulating
2730
its 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
3336
by 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
3740
JSON Pointers both in the form of string representation and URI fragment
3841
representation.
3942

40-
JSONString.java: The JSONString interface requires a toJSONString method,
43+
**JSONString.java**: The `JSONString` interface requires a `toJSONString` method,
4144
allowing 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
4447
building 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
4750
JSON 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
5154
delimited 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
5659
cookie 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:
7073
https://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

8082
Although 1.6 compatibility is currently supported, it is not a project goal and may be
8183
removed 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

9193
Release history:
94+
95+
~~~
9296
20171018 Checkpoint for recent commits.
9397
9498
20170516 Roll up recent commits.
9599
96100
20160810 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,
99103
it is not recommended for use.
100104
Java 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.
102106
Contains the latest code as of 7 Aug, 2016
103107
104108
20160212 Java 1.6 compatibility, OSGi bundle. Contains the latest code as of 12 Feb, 2016.
105109
106110
20151123 JSONObject and JSONArray initialization with generics. Contains the
107111
latest 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:
114120
https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.json%22%20AND%20a%3A%22json%22

0 commit comments

Comments
 (0)