Struct ReadOp 

pub struct ReadOp {
    pub target: Target,
    pub id: String,
    pub routing: Option<String>,
    pub protocol: Protocol,
    pub trace: Option<TraceContext>,
    pub forward_headers: Vec<(String, String)>,
}

A read-by-id operation against a resolved Target.

The id is already the physical id (the tenancy adapter mapped the client’s logical id, docs/04 §5); the reader does no rewriting.

Fields

target: Target

The physical destination to read from.

id: String

The physical document id to fetch.

routing: Option<String>

The _routing value (the partition id), if the placement routes.

protocol: Protocol

The upstream wire protocol this read is dispatched over. Defaults to Protocol::Http1.

trace: Option<TraceContext>

The W3C trace context to forward downstream (traceparent), so the upstream’s spans join this request’s distributed trace. None = no propagation header is sent.

forward_headers: Vec<(String, String)>

Client headers to relay verbatim to the upstream (the forwarding policy’s output). Applied before trace. Empty by default.

Implementations

impl ReadOp

pub fn new( target: Target, id: impl Into<String>, routing: Option<String>, ) -> Self

Constructs a read operation (defaulting to HTTP/1.1 upstream).

pub fn with_protocol(self, protocol: Protocol) -> Self

Sets the upstream protocol for this op (builder style).

pub fn with_trace(self, trace: Option<TraceContext>) -> Self

Sets the trace context to propagate downstream (builder style).

pub fn with_forward_headers(self, headers: Vec<(String, String)>) -> Self

Sets the client headers to relay verbatim to the upstream (builder style).

Trait Implementations

impl Clone for ReadOp

fn clone(&self) -> ReadOp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadOp

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

Formats the value using the given formatter.

impl Eq for ReadOp

impl PartialEq for ReadOp

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ReadOp