Struct Codec

pub struct Codec<T>(pub T);

Codec extractor / response.

The serialized data is not specified. Upon deserialization, the request’s Content-Type header is used to determine the format of the data.

By default, only JSON is supported. To enable other formats, use the corresponding feature flags.

Note that IntoResponse is not implemented for this type, as the headers are not available when serializing the data. Instead, use Codec::to_response to create a response with the appropriate Content-Type header extracted from the request with Accept.

Examples

#[axum_codec::apply(decode)]
struct Greeting {
  hello: String,
}

let bytes = b"{\"hello\": \"world\"}";
let content_type = ContentType::Json;

let Codec(data) = Codec::<Greeting>::from_bytes(bytes, content_type).unwrap();

assert_eq!(data.hello, "world");

Tuple Fields

0: T

Implementations

impl<'b, T> Codec<T>

where T: Deserialize<'b>,

pub fn from_json(bytes: &'b [u8]) -> Result<Self, Error>

Attempts to deserialize the given bytes as JSON.

Errors

See serde_json::from_slice.

pub fn from_form(bytes: &'b [u8]) -> Result<Self, Error>

Attempts to deserialize the given bytes as URL-encoded form data.

Errors

See serde_urlencoded::from_bytes.

pub fn from_msgpack(bytes: &'b [u8]) -> Result<Self, Error>

Attempts to deserialize the given bytes as MessagePack. Does not perform any validation if the validator feature is enabled. For validation, use Self::from_bytes.

Errors

See rmp_serde::from_slice.

pub fn from_yaml(text: &'b str) -> Result<Self, Error>

Attempts to deserialize the given text as YAML. Does not perform any validation if the validator feature is enabled. For validation, use Self::from_bytes.

Errors

See serde_yaml::from_slice.

pub fn from_toml(text: &'b str) -> Result<Self, Error>

Attempts to deserialize the given text as TOML. Does not perform any validation if the validator feature is enabled. For validation, use Self::from_bytes.

Errors

See toml::from_str.

impl<'b, T> Codec<T>

pub fn from_bincode(bytes: &'b [u8]) -> Result<Self, DecodeError>

where T: BorrowDecode<'b>,

Attempts to deserialize the given bytes as Bincode. Does not perform any validation if the validator feature is enabled. For validation, use Self::from_bytes.

Errors

See bincode::decode_from_slice.

pub fn from_bitcode(bytes: &'b [u8]) -> Result<Self, Error>

where T: Decode<'b>,

Attempts to deserialize the given bytes as Bitcode. Does not perform any validation if the validator feature is enabled. For validation, use Self::from_bytes.

Errors

See bitcode::decode.

pub fn from_bytes( bytes: &'b [u8], content_type: ContentType, ) -> Result<Self, CodecRejection>

where T: CodecDecode<'b>,

Attempts to deserialize the given bytes as the specified ContentType.

Errors

See CodecRejection.

impl<T> Codec<T>

where T: Serialize,

pub fn to_json(&self) -> Result<Vec<u8>, Error>

Attempts to serialize the given value as JSON.

Errors

See serde_json::to_vec.

pub fn to_form(&self) -> Result<Vec<u8>, Error>

Attempts to serialize the given value as URL-encoded form data.

Errors

See serde_urlencoded::to_string.

pub fn to_msgpack(&self) -> Result<Vec<u8>, Error>

Attempts to serialize the given value as MessagePack.

Errors

See rmp_serde::to_vec_named.

pub fn to_yaml(&self) -> Result<String, Error>

Attempts to serialize the given value as YAML.

Errors

See [serde_yaml::to_vec].

pub fn to_toml(&self) -> Result<String, Error>

Attempts to serialize the given value as TOML.

Errors

See toml::to_string.

impl<T> Codec<T>

pub fn to_bincode(&self) -> Result<Vec<u8>, EncodeError>

where T: Encode,

Attempts to serialize the given value as Bincode

Errors

See [bincode::serialize].

pub fn to_bitcode(&self) -> Vec<u8>

where T: Encode,

Attempts to serialize the given value as Bitcode

Errors

See bitcode::encode.

pub fn to_bytes(&self, content_type: ContentType) -> Result<Vec<u8>, Error>

where T: CodecEncode,

Attempts to serialize the given value as the specified ContentType.

Errors

See [Error].

impl<T> Codec<T>

pub fn into_inner(self) -> T

Consumes the Codec and returns the inner value.

impl<T> Codec<T>

where T: CodecEncode,

pub fn to_response<C: Into<ContentType>>(&self, content_type: C) -> Response

Converts the inner value into a response with the given content type.

If serialization fails, the rejection is converted into a response. See encode::Error for possible errors.

Trait Implementations

impl<T: Clone> Clone for Codec<T>

fn clone(&self) -> Codec<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Codec<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Codec<T>

fn default() -> Codec<T>

Returns the “default value” for a type.

impl<T> Deref for Codec<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for Codec<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Display> Display for Codec<T>

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

Formats the value using the given formatter.

impl<T, S> FromRequest<S> for Codec<T>

where T: for<'de> CodecDecode<'de>, S: Send + Sync + 'static,

type Rejection = Response<Body>

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request(req: Request, state: &S) -> Result<Self, Self::Rejection>

Perform the extraction.

impl<T: Hash> Hash for Codec<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<D> IntoCodecResponse for Codec<D>

where D: CodecEncode, Self: OperationOutput,

fn into_codec_response(self, content_type: ContentType) -> Response

impl<T> OperationInput for Codec<T>

where T: JsonSchema,

fn operation_input(ctx: &mut GenContext, operation: &mut Operation)

Modify the operation.

fn inferred_early_responses( ctx: &mut GenContext, operation: &mut Operation, ) -> Vec<(Option<u16>, Response)>

Inferred early responses are used to document early returns for extractors, guards inside handlers. For example these could represent JSON parsing errors, authentication failures.

impl<T> OperationOutput for Codec<T>

where T: JsonSchema,

type Inner = T

The type that is used in examples.

fn operation_response( ctx: &mut GenContext, operation: &mut Operation, ) -> Option<Response>

Return a response documentation for this type, alternatively modify the operation if required.

fn inferred_responses( ctx: &mut GenContext, operation: &mut Operation, ) -> Vec<(Option<u16>, Response)>

Inferred responses are used when the type is used as a request handler return type.

impl<T: Ord> Ord for Codec<T>

fn cmp(&self, other: &Codec<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq> PartialEq for Codec<T>

fn eq(&self, other: &Codec<T>) -> 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<T: PartialOrd> PartialOrd for Codec<T>

fn partial_cmp(&self, other: &Codec<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> Validate for Codec<T>

where T: Validate,

fn validate(&self) -> Result<(), ValidationErrors>

impl<T: Eq> Eq for Codec<T>

impl<T> StructuralPartialEq for Codec<T>