Struct RequestGuard 

pub struct RequestGuard { /* private fields */ }

Available on crate feature core only.

A single-use capability token proving the holder owns the current request.

Created by QueryResource::accept_current_request, consumed by one of the complete_* methods. The guard is moved (not copied) into the completion method, which enforces the two-phase protocol at the type level: once a guard is used, it cannot be used again.

Two-phase protocol

1. Accept: resource.accept_current_request(request_id) validates that the request is still active and returns Some(RequestGuard).
2. Complete: resource.complete_success(guard, data, now_ms) consumes the guard and applies the result. Attempting to use the guard again is a compile error because it has been moved.

Why not Copy?

Previous versions derived Clone + Copy, which allowed the same guard to be passed to multiple complete_* calls. While the second call would be a no-op (the resource already cleared active_request_id), it was wasteful and could mask bugs. Taking the guard by value prevents this entirely.

Implementations

impl RequestGuard

pub fn request_id(&self) -> RequestId

The request id this guard protects (borrowed).

pub fn into_request_id(self) -> RequestId

Consume the guard and return the request id.

Useful when you want to extract the id and discard the guard.

Trait Implementations

impl Debug for RequestGuard

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

Formats the value using the given formatter.

impl Eq for RequestGuard

impl PartialEq for RequestGuard

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RequestGuard