Struct RpcSpec 

pub struct RpcSpec {
    pub path: &'static str,
    pub service: &'static str,
    pub service_full: &'static str,
    pub method: &'static str,
    pub alias: &'static str,
    pub operation_kind: &'static str,
    pub read_only: bool,
    pub replay_safe: bool,
    pub client_streaming: bool,
    pub server_streaming: bool,
    pub http_method: &'static str,
    pub http_path: &'static str,
}

One RPC, as the contract declares it.

Fields

path: &'static str

Full gRPC method path, e.g. /udb.services.v1.DataBroker/Select.

service: &'static str

Service short name, e.g. DataBroker.

service_full: &'static str

Fully-qualified service name, e.g. udb.services.v1.DataBroker.

method: &'static str

Method name as it appears on the wire, e.g. Select.

alias: &'static str

Snake-case alias used by the SDK surfaces.

operation_kind: &'static str

Declared operation kind: read_only, mutation, or destructive.

read_only: bool

True when the RPC performs no mutation.

replay_safe: bool

True when the contract EXPLICITLY declares this mutation replayable (idempotency_contract). false also means “no contract declared”, which is why most read-only RPCs report false here. Do not read this alone before retrying — call RpcSpec::retry_safe.

client_streaming: bool

server_streaming: bool

http_method: &'static str

REST verb and path from the google.api.http annotation, when annotated.

http_path: &'static str

Implementations

impl RpcSpec

pub fn is_streaming(&self) -> bool

Whether this RPC streams in either direction.

pub fn retry_safe(&self) -> bool

Whether repeating this call is safe.

TWO independent facts, and both matter:

• read_only comes from operation_kind. A read applies no mutation, so repeating it is safe regardless of what else is declared.
• replay_safe comes from an OPTIONAL idempotency_contract, and is false when that contract is simply absent. It marks the handful of MUTATIONS the broker guarantees are replayable.

Reading replay_safe alone would therefore treat “no contract declared” as “unsafe” and refuse to retry any read — the overwhelming majority of the surface. Consult this, not either field on its own.

Trait Implementations

impl Clone for RpcSpec

fn clone(&self) -> RpcSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RpcSpec

impl Debug for RpcSpec

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

Formats the value using the given formatter.

impl Eq for RpcSpec

impl PartialEq for RpcSpec

fn eq(&self, other: &RpcSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RpcSpec