Repository navigation
Track the upstream move to the jdk.incubator.json module #145
Description
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 is43325738c(2026-08-27).
Needed
- Track the new location: point the API tracker (and the sync process documented in
json-java21/AGENTS.md) at thesrc/jdk.incubator.jsonmodule 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.
Activity
simbo1905 commentedon Aug 29, 2026
Verified upstream state as of 2026-08-29 (direct API/raw fetches, not cached):
jsonbranch:43325738c(2026-08-27). Last local sync:c1a4f80(2026-02-05). Gap: ~2572 commits (inflated by routine mainline-jdk merges; recent JSON commits Aug 25-27 are API doc/wording refinements).openjdk/jdk-sandbox), same branch (json) — no repo/branch move. The code was restructured within the branch:src/java.base/share/classes/jdk/internal/util/json/andjava/util/json/are gone (404)src/jdk.incubator.json/share/classes/jdk/incubator/json/with nestedimpl/subpackage. Verifiedpackage jdk.incubator.json;in fetched sources.JsonValueException(public API), and in impl:JsonGenerator,JsonValueSupport.Tracker tooling note:
daily-api-tracker.ymlcurrently fetches the deadjava.util.jsonpaths, so the daily drift check 404s. Infrastructure work from this issue (tracker URL updates + a pinnedUPSTREAM_COMMITfile + an upstream-commits check mode) is now in progress.[-]Upgrade to track jdk.incubator.json[/-][+]Track the upstream move to the jdk.incubator.json module[/+]Issue #145 uplift upstream jdk.incubator.json sources at 43325738c
Issue #145 apply upstream API renames across modules
Issue #145 port upstream tests, verify #118 closed, bump frontier docs
Issue #145 harden JSON number math test coverage
Issue #145 remove dead code and stale docs from backport