What
The upstream OpenJDK jdk-sandbox json branch has moved the JSON API out of java.base into a dedicated incubator module:
- Public API:
src/jdk.incubator.json/share/classes/jdk/incubator/json/
- Implementation:
src/jdk.incubator.json/share/classes/jdk/incubator/json/impl/
The old locations (java/util/json, jdk/internal/util/json under src/java.base/) no longer exist upstream — every fetch against them returns 404. Context: JEP 540 "Simple JSON API (Incubator)" is targeted at JDK 28 (https://openjdk.org/jeps/540).
Why
- This backport tracks the upstream API; the daily API tracker still fetches the dead paths, so drift detection is blind.
- The local code is pinned at upstream commit
c1a4f80 (2026-02-05); upstream HEAD is 43325738c (2026-08-27).
Needed
- Track the new location: point the API tracker (and the sync process documented in
json-java21/AGENTS.md) at the src/jdk.incubator.json module paths.
- Run the mechanical sync cycle: take upstream HEAD as the new frontier, diff only the files in the JSON package against the last recorded frontier, and align this backport with whatever changed — added, modified, or removed files.
- While syncing, review any changes to the upstream implementation classes that suggest bugs or fixes, and backport those fixes to our copy as well (documented in the README "Upstream Bug Fixes" section, as with previous syncs).
The approach is the established one: grab the upstream files and check them; no commit-counting or revision-guessing machinery.
What
The upstream OpenJDK jdk-sandbox
jsonbranch has moved the JSON API out ofjava.baseinto a dedicated incubator module:src/jdk.incubator.json/share/classes/jdk/incubator/json/src/jdk.incubator.json/share/classes/jdk/incubator/json/impl/The old locations (
java/util/json,jdk/internal/util/jsonundersrc/java.base/) no longer exist upstream — every fetch against them returns 404. Context: JEP 540 "Simple JSON API (Incubator)" is targeted at JDK 28 (https://openjdk.org/jeps/540).Why
c1a4f80(2026-02-05); upstream HEAD is43325738c(2026-08-27).Needed
json-java21/AGENTS.md) at thesrc/jdk.incubator.jsonmodule paths.The approach is the established one: grab the upstream files and check them; no commit-counting or revision-guessing machinery.