You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by ja...@apache.org on 2026/10/07 19:48:59 UTC

(juneau) branch docs updated: Document the application/jsonlines and application/json5lines media-type aliases and the negotiated NDJSON Content-Type echo in the reactive response processor (10.0.0 release notes, JSONL and JSON5L topics, reactive server topic).

This is an automated email from the ASF dual-hosted git repository.

jamesbognar pushed a commit to branch docs
in repository https://gitbox.apache.org/repos/asf/juneau.git


The following commit(s) were added to refs/heads/docs by this push:
     new 122c686592 Document the application/jsonlines and application/json5lines media-type aliases and the negotiated NDJSON Content-Type echo in the reactive response processor (10.0.0 release notes, JSONL and JSON5L topics, reactive server topic).
122c686592 is described below

commit 122c686592b4d769e6b14555d915d915ca2de08b
Author: James Bognar <ja...@apache.org>
AuthorDate: Wed Oct 7 15:48:52 2026 -0400

    Document the application/jsonlines and application/json5lines media-type aliases and the negotiated NDJSON Content-Type echo in the reactive response processor (10.0.0 release notes, JSONL and JSON5L topics, reactive server topic).
---
 pages/release-notes/10.0.0.md            | 1 +
 pages/topics/03.39.00.JsonlSupport.md    | 2 +-
 pages/topics/03.39.01.Json5l.md          | 2 +-
 pages/topics/10.49.RestServerReactive.md | 2 +-
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/pages/release-notes/10.0.0.md b/pages/release-notes/10.0.0.md
index dec3de105e..dcbe047e6b 100644
--- a/pages/release-notes/10.0.0.md
+++ b/pages/release-notes/10.0.0.md
@@ -892,6 +892,7 @@ Juneau 10.0 adds **JSON5L** — a new line-delimited format combining the relaxe
 - **Full JSON5 parse leniency** — the parser accepts the full JSON5 dialect on each line (comments, unquoted/single-quoted keys, trailing commas, relaxed numbers). Because JSON5 is a strict superset of JSON, it also reads plain JSONL input unchanged. Blank and comment-only lines are skipped; inline comments are tolerated; `/* ... */` block comments must open and close on the same line.
 - **Token-streaming and array-record streaming parity** with JSONL (O(1) memory line cursor).
 - **First-class REST media type** `application/json5l` (`text/json5l`, plus reduced-q-value cross-acceptance of the JSONL family), registered in `BasicUniversalConfig` and the `RestClient.universal()` set.
+- **Media-type aliases** — `application/jsonlines` (the type suggested by the JSON Lines spec) is accepted as an alias of `application/jsonl`, and `application/json5lines` as an alias of `application/json5l`, for both `Accept` and `Content-Type` negotiation. Produced responses keep the canonical `application/jsonl` / `application/json5l` Content-Type. `ContentType.APPLICATION_JSONLINES` and `ContentType.APPLICATION_JSON5LINES` constants are added.
 
 See the new <a href="/docs/topics/Json5l">JSON5L Basics</a> topic page.
 
diff --git a/pages/topics/03.39.00.JsonlSupport.md b/pages/topics/03.39.00.JsonlSupport.md
index 15f6f6ec07..1083427e1d 100644
--- a/pages/topics/03.39.00.JsonlSupport.md
+++ b/pages/topics/03.39.00.JsonlSupport.md
@@ -75,7 +75,7 @@ The conversion follows the <a href="https://jsonlines.org/" target="_blank">JSON
 ## Media Types
 
 - **Produces**: `application/jsonl`
-- **Accepts**: `application/jsonl`, `application/x-ndjson`, `text/jsonl`
+- **Accepts**: `application/jsonl`, `application/jsonlines` (the JSON Lines spec's suggested type; alias), `application/x-ndjson`, `text/jsonl`
 
 ## REST Integration
 
diff --git a/pages/topics/03.39.01.Json5l.md b/pages/topics/03.39.01.Json5l.md
index ab193831d8..0ec4b56082 100644
--- a/pages/topics/03.39.01.Json5l.md
+++ b/pages/topics/03.39.01.Json5l.md
@@ -73,7 +73,7 @@ JSON5L follows JSON5 comment rules line-by-line:
 ## Media Types
 
 - **Produces**: `application/json5l`
-- **Accepts**: `application/json5l`, `text/json5l`, and (at a reduced q-value) the JSONL family `application/jsonl`, `application/x-ndjson`, `text/jsonl`.
+- **Accepts**: `application/json5l`, `application/json5lines` (alias), `text/json5l`, and (at a reduced q-value) the JSONL family `application/jsonl`, `application/jsonlines`, `application/x-ndjson`, `text/jsonl`.
 
 ## REST Integration
 
diff --git a/pages/topics/10.49.RestServerReactive.md b/pages/topics/10.49.RestServerReactive.md
index ab8cc08e66..cdffc8eb2e 100644
--- a/pages/topics/10.49.RestServerReactive.md
+++ b/pages/topics/10.49.RestServerReactive.md
@@ -84,7 +84,7 @@ A streaming publisher is rendered as one of three shapes, **selected by the nego
 |---|---|---|
 | **Buffer** (default) | anything else / unspecified | All elements collected into a `List` and serialized through the normal serializer chain (e.g. a JSON array). The collection is wrapped in a `CompletableFuture` and handed to the async path, so a slow producer never blocks the request thread. |
 | **SSE** | `text/event-stream` | Each element emitted as a Server-Sent-Events frame. `SseEvent` elements are written verbatim; any other element type is JSON-encoded into the `data:` field. |
-| **NDJSON** | `application/x-ndjson`, `application/jsonl`, `application/json-seq` | Each element JSON-encoded on its own line. |
+| **NDJSON** | `application/x-ndjson`, `application/jsonl`, `application/jsonlines`, `application/json5l`, `application/json5lines`, `application/json-seq` | Each element JSON-encoded on its own line. |
 
 The default-to-buffer choice is deliberate: a bare `Flux<Article>` with no content-type hint produces a normal JSON array, which is the least surprising result for the majority of callers. Streaming is an explicit opt-in via the content type.