Skip to content

Commit 0058bdf

Browse files
author
Simon Massey
authored
Update README.md
1 parent 0d46e7c commit 0058bdf

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

README.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
11
# java.util.json Backport for JDK 21+
22

3-
Early access to the future `java.util.json` API - tracking OpenJDK sandbox development.
3+
Early access to the future `java.util.json` API - taken from OpenJDK sandbox July 2025.
44

55
## Project Vision
66

77
This project provides Java developers with early access to the future `java.util.json` API patterns today, allowing code written against this API to migrate seamlessly when the official API is released. Rather than adopting third-party JSON libraries that will never align with future JDK standards, developers can start using tomorrow's API patterns today.
88

99
## Current Status
1010

11-
This code is derived from the official OpenJDK sandbox repository at commit [d22dc2ba89789041c3908cdaafadc1dcf8882ebf](https://github.com/openjdk/jdk-sandbox/commit/d22dc2ba89789041c3908cdaafadc1dcf8882ebf) (3 days ago - "Improve hash code spec wording").
11+
This code is derived from the official OpenJDK sandbox repository at commit [d22dc2ba89789041c3908cdaafadc1dcf8882ebf](https://github.com/openjdk/jdk-sandbox/commit/d22dc2ba89789041c3908cdaafadc1dcf8882ebf) (Mid July 2025 "Improve hash code spec wording").
1212

1313
The original proposal and design rationale can be found in the included PDF: [Towards a JSON API for the JDK.pdf](Towards%20a%20JSON%20API%20for%20the%20JDK.pdf)
1414

15-
## Project Goals
15+
## Back Port Project Goals
1616

1717
- **Enable early adoption**: Let developers use future Java JSON patterns today on JDK 21+
18-
- **Smooth migration path**: Code written against this API should require minimal changes when migrating to the official release
19-
- **API compatibility over performance**: Focus on matching the API design rather than competing with existing JSON libraries on speed
18+
- **Smooth migration path**: Code written against this API should require less changes when migrating to the eventual official release
19+
- **API compatibility over performance**: Focus on matching the emerging "batteries included" API design rather than competing with existing JSON libraries on speed
2020

2121
## Non-Goals
2222

23-
- **Performance competition**: This is not intended to be the fastest JSON library
24-
- **Feature additions**: No features beyond what's in the official sandbox/preview
25-
- **Production optimization**: The official implementation will have JVM-level optimizations unavailable to a backport
26-
- **API stability**: This backport may evolve as the official specification develops (if folks find it useful)
23+
- **Performance competition**: This is not intended to be the fastest JSON library the JDK internal annotations had to be removed.
24+
- **Feature additions**: No features beyond what's in the official sandbox/preview.
25+
- **Production optimization**: The final official implementation will have JVM-level optimizations unavailable to a backport on Java 21.
26+
- **API stability**: This backport may evolve as the official specification develops (only if folks find it useful)
2727

2828
## Modifications
2929

@@ -220,4 +220,4 @@ String formatted = Json.toDisplayString(data, 2);
220220
// 95
221221
// ]
222222
// }
223-
```
223+
```

0 commit comments

Comments
 (0)