Trait Codec 

pub trait Codec {
    type EncodeItem: ?Sized;
    type DecodeItem;
    type Error: Error;

    const CONTENT_TYPE: &'static str;

    // Required methods
    fn encode(
        &mut self,
        item: &Self::EncodeItem,
        destination: &mut Vec<u8>,
    ) -> Result<(), Self::Error>;
    fn decode(
        &mut self,
        payload: &[u8],
    ) -> Result<Self::DecodeItem, Self::Error>;
}

Encodes and decodes message payloads independently of gRPC wire framing.

A codec may retain reusable serialization state. Implementations do not need to be thread safe. Payloads exclude the five-byte gRPC frame prefix, and the transport is responsible for compression and message size limits.

Required Associated Constants

const CONTENT_TYPE: &'static str

HTTP content type identifying this serialization format.

Required Associated Types

type EncodeItem: ?Sized

Message type accepted by the encoder.

type DecodeItem

Owned message type returned by the decoder.

type Error: Error

Serialization or deserialization failure.

Required Methods

fn encode( &mut self, item: &Self::EncodeItem, destination: &mut Vec<u8>, ) -> Result<(), Self::Error>

Appends one serialized message to destination.

The caller may reuse the buffer between messages. An implementation may leave partially appended bytes on failure; callers must discard them.

Errors

Returns an implementation-defined error when the message cannot be encoded.

fn decode(&mut self, payload: &[u8]) -> Result<Self::DecodeItem, Self::Error>

Decodes exactly one message payload.

Errors

Returns an implementation-defined error when the payload is invalid for this codec, including unsupported trailing bytes where applicable.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl Codec for PayloadCodec

const CONTENT_TYPE: &'static str = "application/grpc"

type EncodeItem = Vec<u8>

type DecodeItem = Vec<u8>

type Error = Status

impl<E, D> Codec for ProstCodec<E, D>

where E: Message, D: Message + Default,

const CONTENT_TYPE: &'static str = Self::CONTENT_TYPE

type EncodeItem = E

type DecodeItem = D

type Error = ProstCodecError