Struct HttpRpcProtocol 

pub struct HttpRpcProtocol<C> { /* private fields */ }

An HTTP protocol for RPC-style APIs that put everything in the body.

This protocol ignores HTTP binding traits and serializes the entire input into the request body using the provided codec. Used by protocols like awsJson1_0, awsJson1_1, and rpcv2Cbor.

Type parameters

• C — the payload codec (ex: JsonCodec, CborCodec)

Implementations

impl<C: Codec> HttpRpcProtocol<C>

pub fn new( protocol_id: ShapeId<'static>, codec: C, content_type: &'static str, ) -> Self

Creates a new HTTP RPC protocol.

pub fn codec(&self) -> &C

Returns a reference to the body codec. Used by wrapper protocols that need to read the codec’s settings before rebuilding it via Self::with_codec.

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

Returns the Content-Type string this protocol stamps onto the outgoing request. Used by wrapper protocols that rebuild the inner HttpRpcProtocol when reconfiguring the codec.

pub fn with_codec(self, codec: C) -> Self

Replaces the body codec, returning a new protocol instance with all other fields preserved. Used by wrapper protocols (e.g. AWS JSON RPC) that need to swap in a reconfigured codec.

Trait Implementations

impl<C> ClientProtocolInner for HttpRpcProtocol<C>

where C: Codec + Send + Sync + Debug + 'static, for<'a> C::Deserializer<'a>: ShapeDeserializer,

type Request = Request

The protocol’s request message type (e.g., http::Request).

type Response = Response

The protocol’s response message type (e.g., http::Response).

fn protocol_id(&self) -> &ShapeId<'static>

Returns the Smithy shape ID of this protocol.

fn serialize_request( &self, input: &dyn SerializableStruct, input_schema: &Schema<'_>, endpoint: &str, cfg: &ConfigBag, ) -> Result<Request, SerdeError>

Serializes an operation input into a request message.

fn deserialize_response<'a>( &self, response: &'a Response, _output_schema: &Schema<'_>, _cfg: &'a ConfigBag, ) -> Result<Box<dyn ShapeDeserializer + 'a>, SerdeError>

Deserializes a response message, returning a boxed ShapeDeserializer that supplies every member of output_schema this protocol carries in the response.

fn payload_codec(&self) -> Option<&dyn DynCodec>

Returns the codec used for payload (de)serialization, if any.

fn update_endpoint( &self, request: &mut Request, endpoint: &Endpoint, cfg: &ConfigBag, ) -> Result<(), SerdeError>

Updates a previously serialized request with a resolved endpoint.

fn parse_error_metadata( &self, response: &Self::Response, cfg: &ConfigBag, ) -> Result<ErrorMetadataBuilder, SerdeError>

Extracts canonical error metadata (code, message, request id) from a response’s wire envelope.

fn deserialize_error_response<'a>( &self, response: &'a Self::Response, cfg: &'a ConfigBag, ) -> Result<Box<dyn ShapeDeserializer + 'a>, SerdeError>

Returns a ShapeDeserializer positioned at the body of an error response — inside the protocol’s error envelope, where applicable.

fn event_stream_media_type(&self) -> Option<&str>

The media type used to label a structured event-stream payload, if this protocol supports event streams — for example application/cbor or application/json.

fn parse_event_stream_error_metadata( &self, payload: &[u8], ) -> Result<ErrorMetadataBuilder, SerdeError>

Extracts canonical error metadata from the payload of an event-stream exception frame.

impl<C: Debug> Debug for HttpRpcProtocol<C>

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

Formats the value using the given formatter.