Struct Transcoder 

pub struct Transcoder { /* private fields */ }

Transcodes application messages between JSON and binary protobuf, keyed by gRPC method path (/pkg.Service/Method), and maps google.api.http REST bindings onto gRPC methods.

Implementations

impl Transcoder

pub fn from_file_descriptor_set(bytes: &[u8]) -> Result<Self, TranscodeError>

Build from an encoded FileDescriptorSet.

pub fn has_http_rules(&self) -> bool

Whether any google.api.http REST bindings were found.

pub fn transcode_http_request( &self, method: &str, path: &str, query: Option<&str>, body: &[u8], ) -> Result<Option<HttpCall>, TranscodeError>

Map a REST request (method, path, query, body) onto a gRPC call, or Ok(None) if no HTTP binding matches.

pub fn match_ws(&self, path: &str, query: Option<&str>) -> Option<WsBinding>

Resolve a WebSocket annotation route from its upgrade path, or None if the path matches no binding.

pub fn is_annotated_method(&self, grpc_method: &str) -> bool

Whether a gRPC method has any HTTP annotation (used to keep an annotated RPC’s main route off the plain-HTTP surface).

pub fn has_method(&self, path: &str) -> bool

Whether path (/pkg.Service/Method) resolves to a known method — i.e. this transcoder can handle it. Callers use it to distinguish “unknown method” (UNIMPLEMENTED) from a genuine transcode/validation failure.

pub fn request_json_to_proto( &self, path: &str, json: &[u8], ) -> Result<Vec<u8>, TranscodeError>

JSON request message -> binary protobuf. Empty input is the default message.

pub fn response_proto_to_json( &self, path: &str, proto: &[u8], ) -> Result<Vec<u8>, TranscodeError>

Binary protobuf response message -> JSON.

Trait Implementations

impl Clone for Transcoder

fn clone(&self) -> Transcoder

Returns a duplicate of the value.

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

Performs copy-assignment from source.