Enum StreamFormat 

pub enum StreamFormat {
    Json,
    NdJson,
    ServerSentEvents,
    Binary,
}

Streaming format types

Variants

Json

Standard JSON array streaming

NdJson

Newline-delimited JSON

ServerSentEvents

Server-Sent Events

Binary

Binary PJS protocol

Implementations

impl StreamFormat

pub fn from_accept_header(headers: &HeaderMap) -> Self

Picks a streaming format for the request’s Accept header.

Negotiation is RFC 9110 §12.5.1-conformant for this route’s supported media ranges, delegated to headers_accept::Accept::negotiate: candidates are ranked by q value first and by media-range specificity as the tiebreaker (exact match > application/* > */*).

• q=0 is an explicit rejection of that media range and drops the entry.
• A q parameter that is non-finite (nan/inf/-inf) or otherwise fails to parse as a float drops its entry — a malformed preference is treated as “no preference stated”, not “highest preference”. This is validated before delegating to headers_accept, whose own default treats an unparsable q as absent (i.e. 1.0, the highest priority) rather than dropping the entry.
• A finite but out-of-range q (e.g. q=5) is clamped to [0.0, 1.0] and the entry is kept — matching the pre-migration hand-rolled parser’s .clamp(0.0, 1.0) exactly (not dropped; only q=0, non-finite, and unparsable q are dropped).
• Wildcard matching is restricted to exactly */* and application/* (case-insensitive), which vote for Self::Json at their own q. Any other range containing a * (e.g. text/*, */x-ndjson) is rejected rather than delegated to headers_accept’s more general type/*/*/* matching, which is broader than this route’s historical, scoped wildcard support.
• Each surviving entry is validated as a well-formed media type independently, before negotiation; a malformed entry (e.g. garbage!!) is dropped individually and does not discard the rest of the header — headers_accept::Accept::from_str itself fails the entire header on a single bad entry, so this crate is never handed anything but already-validated, surviving entries.
• At most MAX_ACCEPT_ENTRIES (16) comma-separated entries are considered; any beyond that bound are silently ignored. This bound is enforced by truncating the raw header string before it reaches headers_accept’s parser, since that crate does not itself bound entry count.
• A missing header, an unparsable header value, or no entry surviving negotiation all fall back to Self::Json.

pub fn content_type(&self) -> &'static str

MIME type that corresponds to this streaming format.

Trait Implementations

impl Clone for StreamFormat

fn clone(&self) -> StreamFormat

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for StreamFormat

impl Debug for StreamFormat

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.