Struct BytesFallback 

pub struct BytesFallback<F>(/* private fields */);

Represents bytes as bytes, with a fallback for formats without native bytes.

The bytes are serialized as bytes which carry the format F as fallback (see Bytes::fallback). Formats with native bytes (like CBOR) write them as bytes, formats without native bytes (like JSON and TOML) write them in F: strings in an encoding or sequences of integers for IntSeq. When deserializing native bytes and the representation of F are accepted. It supports the types of BytesBuf.

use deser::adapters::{Base64Url, BytesFallback, IntSeq};
use deser::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
pub struct Blob {
    // URL-safe base64 in JSON and TOML, bytes in CBOR
    #[deser(as = BytesFallback<Base64Url>)]
    sha1: [u8; 20],
    #[deser(as = Option<BytesFallback<Base64Url>>)]
    signature: Option<Vec<u8>>,
    // `[1, 2]` in JSON and TOML, bytes in CBOR
    #[deser(as = BytesFallback<IntSeq>)]
    legacy: Vec<u8>,
}

To use an encoding in all formats, use the encoding as adapter (for instance #[deser(as = Base64Url)]). To change the representation of all bytes, configure the format instead.

Trait Implementations

impl<'de, T: BytesBuf, F: BytesFallbackFormat> Deserialize<'de, T> for BytesFallback<F>

fn deserialize_into<'out>( out: &'out mut Option<T>, state: &mut State, ) -> SinkHandle<'out, 'de>

Creates a sink that deserializes the value into the given slot.

fn expecting() -> Cow<'static, str>

Returns what the value expects, for error messages.

fn deserialize_atom( slot: &mut Slot<T, Self>, atom: Atom<'_>, state: &mut State, ) -> Result<(), Error>

Deserializes an atom into the slot.

fn deserialize_borrowed_atom( slot: &mut Slot<T, Self>, atom: Atom<'de>, state: &mut State, ) -> Result<(), Error>

Deserializes an atom that borrows from the data being deserialized into the slot.

fn describe_type(d: &mut dyn Describe)

Describes the Rust shape of the type.

fn initial_value() -> Option<T>

Provides the value of a missing struct field.

fn deserialize_update<'out>( value: &'out mut T, state: &mut State, ) -> SinkHandle<'out, 'de>

Creates a sink that updates an existing value.

impl<T: BytesBuf, F: BytesFallbackFormat> Serialize<T> for BytesFallback<F>

fn serialize<'a>(value: &'a T, _state: &mut State) -> Result<Emit<'a>, Error>

Serializes the value.

fn finish(value: &T, state: &mut State) -> Result<(), Error>

Invoked after the serialization finished.

fn is_optional(value: &T) -> bool

Checks if the value represents an optional value.

fn describe(value: &T, d: &mut dyn Describe)

Describes the Rust shape of the value.

fn container_shape(value: &T) -> ContainerShape

Returns the shape of the value if it’s a map or sequence.