Struct RequestContext 

pub struct RequestContext { /* private fields */ }

Request context maintained throughout the request lifecycle.

This struct uses a hybrid approach:

• Immutable fields (start_time) are private with getters
• Mutable fields are public(crate) for efficient access within the proxy module

Implementations

impl RequestContext

pub fn new() -> Self

Create a new empty request context with the current timestamp.

pub fn start_time(&self) -> Instant

Get the request start time.

pub fn elapsed(&self) -> Duration

Get elapsed duration since request start.

pub fn correlation_id(&self) -> &str

Get trace_id (alias for backwards compatibility with correlation_id usage).

pub fn trace_id(&self) -> &str

Get the trace ID.

pub fn route_id(&self) -> Option<&str>

Get the route ID, if set.

pub fn upstream(&self) -> Option<&str>

Get the upstream ID, if set.

pub fn upstream_attempts(&self) -> u32

Get the number of upstream attempts.

pub fn method(&self) -> &str

Get the HTTP method.

pub fn path(&self) -> &str

Get the request path.

pub fn query(&self) -> Option<&str>

Get the query string, if present.

pub fn client_ip(&self) -> &str

Get the client IP address.

pub fn user_agent(&self) -> Option<&str>

Get the User-Agent header, if present.

pub fn referer(&self) -> Option<&str>

Get the Referer header, if present.

pub fn host(&self) -> Option<&str>

Get the Host header, if present.

pub fn response_bytes(&self) -> u64

Get the response body size in bytes.

pub fn set_trace_id(&mut self, trace_id: impl Into<String>)

Set the trace ID.

pub fn set_route_id(&mut self, route_id: impl Into<String>)

Set the route ID.

pub fn set_upstream(&mut self, upstream: impl Into<String>)

Set the upstream ID.

pub fn inc_upstream_attempts(&mut self)

Increment upstream attempt counter.

pub fn set_response_bytes(&mut self, bytes: u64)

Set response bytes.

Trait Implementations

impl Default for RequestContext

fn default() -> Self

Returns the “default value” for a type.