Enum CodecFormat 

#[non_exhaustive]
pub enum CodecFormat {
    Proto,
    Json,
}

Supported codec formats.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Proto

Binary protobuf format.

Json

JSON format.

Fully supported only when the json feature is enabled. The variant always exists (the wire-protocol enums are codec-total), but with the feature disabled a proto-only build rejects JSON at the edges: the server declines JSON content types at negotiation (from_content_type / from_codec return None), which yields HTTP 415 for Connect or a gRPC error status for gRPC/gRPC-Web; and message encode/decode returns ErrorCode::Unimplemented as a backstop. Connect error bodies are always JSON regardless.

Implementations

impl CodecFormat

pub fn from_content_type(content_type: &str) -> Option<Self>

Parse codec format from content type string.

With the json feature disabled (a proto-only build) a JSON content type returns None instead of CodecFormat::Json, so the server rejects it as an unsupported media type at content negotiation rather than accepting it and failing later at decode. The message-level encode/decode gating remains as a backstop.

pub fn from_codec(codec: &str) -> Option<Self>

Parse codec format from encoding name (used in GET request query params).

Accepts "proto", and "json" only when the json feature is enabled (the values used in the encoding query parameter). In a proto-only build "json" returns None, so a Connect GET requesting the JSON codec is rejected as an unsupported media type.

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

Get the content type string for this format (unary RPC).

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

Get the streaming content type string for this format.

pub fn is_streaming_content_type(content_type: &str) -> bool

Check if the given content type indicates a streaming request.

With the json feature disabled, the application/connect+json streaming content type is not recognized (a proto-only build treats it as an unsupported media type), matching Self::from_content_type.

Trait Implementations

impl Clone for CodecFormat

fn clone(&self) -> CodecFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CodecFormat

impl Debug for CodecFormat

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

Formats the value using the given formatter.

impl Display for CodecFormat

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

Formats the value using the given formatter.

impl Eq for CodecFormat

impl PartialEq for CodecFormat

fn eq(&self, other: &CodecFormat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CodecFormat