NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central
Maven Central, #1268 by repository stars
JSON is a light-weight, language independent, data interchange format. See http://www.JSON.org/ The files in this package implement JSON encoders/decoders in Java. It also includes the capability to convert between JSON and XML, HTTP headers, Cookies, and CDL. This is a reference implementation. There are a large number of JSON packages in Java. Perhaps someday the Java community will standardize on one. Until then, choose carefully.
Latest stable
20260814
Last release 3 months ago
14 Aug 2026
Ships fairly regularly
a new release about every 4 months
Most releases are documented
notes for 28 of 34 stable releases
Nothing withdrawn
no release was ever pulled
19 years old
34 releases · first in 2007
Drag across the ruler to compare, or tap a release to open it.
| #1070 | Fix XML.unescape for valid whitespace chars |
| Pull Request | Description |
|---|---|
| #1070 | Fix XML.unescape for valid whitespace chars |
| #1067 | bound BigDecimal→BigInteger expansion in objectToBigInteger (completes CVE-2026-59171 fix) |
| Pull Request | Description |
|---|---|
| #1069 | pre-release-20260719 prep for next release |
| #1068 | Max number length config for BigInteger and BigDecimal |
| #1067 | bound BigDecimal→BigInteger expansion in objectToBigInteger (completes CVE-2026-59171 fix) |
| #1065 | Fixes CVE-2026-59171 |
| #1062 | Refactor CDL row serialization for readability |
| #1061 | Restore lenient jsonarray allow consecutive commas and insert null |
| #1058 | Docs and warnings cleanup |
Your coding agent can read these notes before it upgrades. Set up the MCP server →
| #1054 | pre-release-20260522 prep for next release |
| Pull Request | Description |
|---|---|
| #1054 | pre-release-20260522 prep for next release |
| #1053 | update security.md with key data |
| #1046 | Validate XML numeric character references before string construction |
| #1044 | Ignore static fields in JSONObject.fromJson() |
| #1041 | Enhance README with license clarification |
| #1039 | Fix XML forceList parsing issue |
| #1038 | Fix input validation in XMLTokener.unescapeEntity() |
| #1037 | Fix ClassCastException in JSONML.toJSONArray and toJSONObject |
| #1029 | add badge to external hosted javadoc |
| #1028 | Refactoring: Fix sonarqube reliability issues |
| #1027 | Save/restore default locale in test |
| #1021 | Add LTS JDK 25 build to github actions |
| Pull Request | Description |
|---|---|
| #1021 | Add LTS JDK 25 build to github actions |
| #1020 | Record type support |
| #1017 | Refactoring: Fix some SonarQube issues |
| #1014 | Refactoring: String check logic in CDL |
| #1013 | Refactoring: FIx Sonarqube issues in JSONArray |
| #1011 | Refactoring: Fix SonarQube issues in JSONObject |
| #1009 | Fix strict mode check for period after number |
| #1008 | Fixed JSONArray strict mode check for leading comma |
| #1006 | JSONObject.fromJson() with unit tests |
| #1005 | Refactoring: Fix sonarQube issues in JSONObject |
| #1004 | Refactoring: Fix sonarcube issues in JSONObject |
| #1001 | Refactoring: sonarqube issues in JSONObject |
| #1000 | Refactoring: Fix some sonarcube issues from recent commits |
| #999 | fixed some strict mode issues |
| #995 | Fix regression XML parsing null with keepStrings |
| #994 | Add Jacoco option to build, restore method check in populateMap() |
| #993 | Added JUnit tests for XMLTokenerTest |
| #992 | Added JUnit test cases for HTTPTokener |
| #991 | update CodeQL to v3 |
| #990 | Refactoring: fix SonarQube issues in populateMap() |
| #989 | Refactoring: Remove unused code |
| #988 | Refactoring: Remove unused method from jsonobject |
| #987 | Refactor: Check equality with literal on lhs |
| #983 | Allow retaining null-valued bean properties in JSONObjects |
|#949|deprecated unnecessary setter method|
|#930 | pre-release-20250107: updates for next release|
| Pull Request | Description |
|---|---|
| #930 | pre-release-20250107: updates for next release |
| #929 | restore moditect in pom.xml |
|#924 | pre-release-20241224: updates for next release|
| Pull Request | Description |
|---|---|
| #924 | pre-release-20241224: updates for next release |
| #907 | Fix a bug when calling JSONArray.addAll() with Collection as Object |
| #894 | update jsonpath from 2.4.0 to 2.9.0 |
| #889 | Fixed non-idempotent unit tests in JSONObjectTest |
| #879 | Extend syntax error information |
| #877, #886, #888, #911, #921 | Strict mode opt-in feature |
| #876 | Remove jsonparserconfig ctor- just use withOverwriteDuplicateKey |
| #867 | Improve performance in toString() |
| #875 | 20240303-pre-release-updates|
| Pull Request | Description |
|---|---|
| #875 | 20240303-pre-release-updates |
| #874 | Deployment and Pipeline action updates |
| #869 | Revert recent obj long get long changes |
| #860 | Added missing Javadocs for Java 21 |
| #858 | cleanup-after-commit for #854 and #856 |
| #856 | add ability for custom delimiters |
| #855 | Fix JSONArrayTest testRecursiveDepthArrayFor1000Levels() |
|#792| update the docs for release 20231013|
| Pull Request | Description |
|---|---|
| #793 | Reverted #761 |
| #792 | update the docs for release 20231013 |
| #783 | optLong vs getLong inconsistencies |
| #782 | Fix XMLTest.testIndentComplicatedJsonObjectWithArrayAndWithConfig() for Windows |
| #779 | add validity check for JSONObject constructors |
| #778 | Fix XMLTest.testIndentComplicatedJsonObjectWithArrayAndWithConfig() for Windows |
| #776 | Update [JUnit to version 4.13.2 |
| #774 | Removing unneeded synchronization |
| #773 | Add optJSONArray method to JSONObject with a default value |
| #772 | Disallow nested objects and arrays as keys in objects |
| #779 | Unit test cleanup |
| #769 | Addressed Java 17 compile warnings |
| #764 | Update CodeQL action version |
| #761 | Add module-info |
| #759 | JSON parsing should detect embedded |
| #753 | Updated new object methods |
| #752 | Fixes possible unit test bug when compiling/testing on Windows |
|---------------|--------------|
| #720 | Limit the XML nesting depth for CVE-2022-45688 |
| Pull Request | Description |
|---|---|
| #723 | Protect JSONML from stack overflow exceptions caused by recursion |
| #720 | Limit the XML nesting depth for CVE-2022-45688 |
| #711 | Revert pull 707 - interviewbit spam |
| #704 | Move javadoc comments above the interface definition to make it visible |
| #703 | Update Releases.md for JSONObject(Map): Throws NPE if key is null |
| #696 | Update JSONPointerTest for NonDex compatibility |
| #694 | Pretty print XML |
| #692 | Example.md syntax highlight and indentation |
| #691 | Create unit tests for various number formats |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #688 | Update copyright to Public Domain |
| #687 | Fix a typo |
| #685 | JSONObject map type unit tests |
| #684 | Remove v7 build from pipeline |
| #682 | JSONString similarity |
| #675 | https://github.com/stleary/JSON-java/pull/675 |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #660 | Wrap StackOverflow with JSONException |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #651 | IdentityHashSet for JSONObject cycle detection |
| #646 | XMLParserConfiguration defined json arrays option |
| #645 | Handle circular references in Java beans |
| #640 | Unit tests for multiple backslashes in JSONPointer |
| #637 | Reorganized README.md |
| #634 | Update README with Unix examples |
| #631 | Refactor JSONPointerTest |
| #626 | Add CODE_OF_CONDUCT.md |
| #622 | Clean up readme.md |
| #621 | Clean up comments |
| #617 | JSONObject.similar() numeric compare bug fix |
| #613 | JsonObject.similar() number entry check bug fix |
| #610 | optJSONObject() add default value |
| #607 | Add Security.md policy page |
| #606 | Clean up comments, add suppressWarning annotation |
| #604 | Fixed incorrect cast getting float from array |
| #601 | Added Examples.md for new users |
| #594 | JSONStringer.java: fix max nesting level in javadoc |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #575 | Fix similar compare numbers |
| #577 | Added clear() methods to JSONObject and JSONArray |
| #581 | Use built-in Gradle shorthand notation for Maven Central repository |
| #583 | Checked the length of key for checker framework |
| #588 | JSONPointer should not process reverse solidus or double-quote chars in tokens |
NOTE:
#588 is a potentially breaking change to JSONPointer. Embedded double quote and backslash chars are now handled differently (they are basically ignored by the JSONPointer parser). If this causes problems to your project, post an issue on the JSON-Java GitHub page.
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #515 | Merge tests and pom and code |
| #519 | Gradle support |
| #521 | Updates Cookie class to be more generic in attribute parsing and emit |
| #524 | JSONArray does not have constructor to allocate the specified initial capacity |
| #525 | Unit test fixes |
| #526 | Comment out some broken unit tests |
| #527 | Fixes for Unit tests and supports GitHub Actions |
| #529 | Added putAll(Collection) and putAll(Array) methods |
| #532 | Verifies BigDecimal support does not have a regression |
| #538 | Explain local builds in the readme, fix a couple of typos |
| #539 | Bring Junit tests to Java 1.6 compatibility |
| #540 | Added type conversion support |
| #542 | Fix xml hex entity parse |
| #543 | Refactor XMLConfiguration to use Builder Pattern |
| #549 | Update readme.md |
| #552 | Updates for JSONArray.putAll methods |
| #570 | Readme - fix spelling and usage, per Grammarly |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #502 | Update JSONTokener text in README |
| #499 | Add copyright to some files |
| #495 | Refactor typos from code |
| #494 | Replace JSONObject constructor string arrays with var args |
| #492 | Clarify output of JSONArray toList() |
| #486 | Standardize some exception messages |
| #485 | Fix EOF error when Meta tag isn't closed at end of input. |
| #483 | Update README.md to point to latest released jar |
| #481 | Clarify exception when parser reads JSON |
| #475 | Make private methods static where possible |
| #474 | Replaces an internally used inefficient StringBuffer class |
|---------------|--------------|
| Pull Request | Description |
|---|---|
| #467 | add configuration for xsi:nil="true" conversion to null |
| #452 | Adds check for EOF |
| #440 | Corrections to BigDecimal consistency |
| #432 | Update README.md |
| #421 | add isEmpty and isNotEmpty methods |
| #417 | fix double ctor in JSONWriter |
| #412 | Initial implementation of XMLParserConfig object for flexible XML Parsing |
| #407 | Fix for invalid processing of trailing / for JSON Pointer |
| #406 | Adds annotations to customize field names during Bean serialization |
Pull Request | Description ---- | ---- #405 | Update javadoc to match actual exceptions thrown. BREAKING CHANGE: JSONObject(Map) now throws an excepti
| Pull Request | Description |
|---|---|
| #405 | Update javadoc to match actual exceptions thrown. BREAKING CHANGE: JSONObject(Map) now throws an exception if any of a map keys are null. |
| #403 | Ignore Intellij Idea project files |
| #400 | XML toJSONObject(Reader reader) |
Pull Request | Description ------------ | ------------- #392| Remove wrong apostrophe #381 | Adding maven badge to readme #380 | Fix for false positiv
| Pull Request | Description |
|---|---|
| #392 | Remove wrong apostrophe |
| #381 | Adding maven badge to readme |
| #380 | Fix for false positives in similar functions |
| #375 | fixes wrapped exceptions |
| #373 | Fixes Unclosed json array stack overflow |
Pull Request | Description ------------ | ------------- #362 | Fixes XML Unescaping #360 | Creating a JSONObject from a string that contains a duplica
| Pull Request | Description |
|---|---|
| #362 | Fixes XML Unescaping |
| #360 | Creating a JSONObject from a string that contains a duplicate key (any level) throws a JSONException that includes location |
| #357 | Update javadoc according to issue #356 |
| #354 | Updates for populateMap based on discussion in #279 and #264 |
| #352 | Error message position fixes |
| #348 | Capacity improvements for internal structures |
| #347 | A comment added to explain the use of HashMap |
| #345 | Adds JSONException for write value errors |
| #341 | Optimize loops |
| #337 | Optimizes opt* functions |
| #336 | Numeric enhancements, Refactoring, Fix spelling |
Pull Request | Description ------------ | ------------- #324 | Allow user to invoke query and optQuery ,with a JSONPointer #317 | make sure locale ind
| Pull Request | Description |
|---|---|
| #324 | Allow user to invoke query and optQuery ,with a JSONPointer |
| #317 | make sure locale independent data is not upper/lowercased incorrectly |
| #304 | Update README |
| #292 | Provides "#" string evaluation support for JSON Pointer |
| #288 | Bug fixes for XML Encoding and Decoding |
| #274 | Fix for number output bug. |
| #271 | Update enum support to be more fully featured. |
| #261 | Revert "reduces the use of unnecessary exceptions" |
| Pull request | Description |
|---|---|
| #261 | Revert "reduces the use of unnecessary exceptions" |
| https://github.com/stleary/JSON-java/pull/253 | Optional type conversion for XML reading |
| Pull Request | Description |
|---|---|
| https://github.com/stleary/JSON-java/pull/253 | Optional type conversion for XML reading |
| https://github.com/stleary/JSON-java/pull/249 | Reduce the use of unnecessary exceptions |
| https://github.com/stleary/JSON-java/pull/246 | Add License file |
| https://github.com/stleary/JSON-java/pull/242 | Update readme |
| https://github.com/stleary/JSON-java/pull/236 | Make nextString throw a JSONException instead of a NumberFormatException |
| https://github.com/stleary/JSON-java/pull/234 | JSONPointer fix |
| https://github.com/stleary/JSON-java/pull/226 | fix to compile with 1.6.0_45 |
| https://github.com/stleary/JSON-java/pull/222 | JSON Pointer implementation |
| https://github.com/stleary/JSON-java/pull/219 | Added CSV change to CDL.java |
| https://github.com/stleary/JSON-java/pull/203 | Adds JSONArray toList method and JSONObject toMap method |
Extending backwards compatibility to Java 1.6. The unit tests [https://github.com/stleary/JSON-Java-unit-test] still require Java 1.8. Includes the fo
Extending backwards compatibility to Java 1.6. The unit tests [https://github.com/stleary/JSON-Java-unit-test] still require Java 1.8. Includes the following commits:
| Pull Request | Description |
|---|---|
| https://github.com/stleary/JSON-java/pull/195 | Java 1.6 compatibility |
| https://github.com/stleary/JSON-java/pull/188 | Fix negative zero |
| https://github.com/stleary/JSON-java/pull/186 | Update README with number information |
| https://github.com/stleary/JSON-java/pull/185 | change to public: write(writer, indentfactor, indent) |
| https://github.com/stleary/JSON-java/pull/180 | Remove executable bit |
| https://github.com/stleary/JSON-java/pull/179 | Update JavaDoc for JSONObject Constructors |
Support initializing a JSONObject with Map<?,?> and JSONArray with Collection<?>. Includes the following commits:
Support initializing a JSONObject with Map<?,?> and JSONArray with Collection<?>. Includes the following commits:
| Pull request | Description |
|---|---|
| #168 | Update Readme for Maven release |
| #160 | Fixe possible NullPointerException |
| #159 | Properly override Exception class |
| #153 | JSONObject and JSONArray initialization |
Code changes since the most recent Maven release (20141113):
Code changes since the most recent Maven release (20141113):
| Existing feature enhancements | Pull request |
|---|---|
| New methods for Enum type | https://github.com/douglascrockford/JSON-java/pull/140 |
| BigDecimal and BigInteger methods | https://github.com/douglascrockford/JSON-java/pull/135 |
| Iterable JSONArray | https://github.com/douglascrockford/JSON-java/pull/132 |
| Remove compiler cast warnings | https://github.com/douglascrockford/JSON-java/pull/122 |
| JavaDoc fix in CDL | https://github.com/douglascrockford/JSON-java/pull/120 |
| Fix for JSONML.toString() | https://github.com/douglascrockford/JSON-java/pull/118 |
| Fix for JSONArray.toString() | (direct commit) https://github.com/douglascrockford/JSON-java/commit/d6ba31819c48db39be068c8b3b1fa985df09ea65 |
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.