Struct RpcBindingResolver 

pub struct RpcBindingResolver { /* private fields */ }

RPC: the op id axum decoded from /rpc/{op_id}, batch for /rpc/batch (decision D11), and subscribe/<op id> for a subscription. The op id and the body digest bind the call, so path parameters are empty (ADR 0006 §4), except under a parameterised mount (nest("/t/{tenant}", ..)), whose values are bound for the same reason as super::RestBindingResolver’s.

Query (for cratestack#1007’s client): an RPC call binds the request’s canonical query like a REST one does. Generated RPC clients send none, so it is null; a client that adds one (a cache-buster, a gateway’s routing parameter) must bind it too, or the call is a 401.

The op id is validated, not looked up in OPS (decision B2): the unary template binds only an op id a generated op can have, one with a . and no / that is not batch. Anything else (/rpc/%62atch, which axum decodes to batch, or /rpc/a%2Fb) is Resolution::NotAnOp: a COSE body is refused, a plain one passes to the router, whose 404 it is. A well-formed but unknown op id is bound anyway, so the router’s 404 for it is sealed like any other error. Only POST is an op on the unary and batch routes, only GET (and HEAD, which axum routes to it) on the subscription route.

Implementations

impl RpcBindingResolver

pub fn new(prefix: &str) -> RpcBindingResolver

For a router mounted at prefix, as for super::RestBindingResolver::new.

Trait Implementations

impl BindingResolver for RpcBindingResolver

fn resolve(&self, request: &RouteRequest<'_>) -> Resolution

The op request addresses, if it is one.

impl Clone for RpcBindingResolver

fn clone(&self) -> RpcBindingResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcBindingResolver

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

Formats the value using the given formatter.