Struct RequestId 

pub struct RequestId(/* private fields */);

Unique identifier for tracking a request through the system.

Request IDs enable correlation of logs, metrics, and traces across different components and services. They can be extracted from incoming headers or generated automatically.

Implementations

impl RequestId

pub fn new() -> Self

Generates a new random request ID using UUID v4.

pub fn from_string(s: impl Into<String>) -> Self

Creates a request ID from a string value.

This is useful when extracting request IDs from headers or other sources. For a fallible variant, use RequestId::from_str() from the FromStr trait.

pub fn from_header(header: &HeaderValue) -> Option<Self>

Attempts to extract a request ID from an HTTP header.

Returns None if the header value is not valid UTF-8.

pub fn from_request<B>(req: &Request<B>) -> Self

Extracts a request ID from the request headers, or generates a new one.

Looks for the X-Request-ID header first. If not present or invalid, generates a new random ID.

pub fn as_str(&self) -> &str

Returns the request ID as a string slice.

pub fn into_string(self) -> String

Consumes the request ID and returns the inner string.

Trait Implementations

impl Clone for RequestId

fn clone(&self) -> RequestId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestId

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

Formats the value using the given formatter.

impl Default for RequestId

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RequestId

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RequestId

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

Formats the value using the given formatter.

impl From<RequestId> for String

fn from(id: RequestId) -> Self

Converts to this type from the input type.

impl From<String> for RequestId

fn from(s: String) -> Self

Converts to this type from the input type.

impl FromStr for RequestId

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for RequestId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RequestId

fn eq(&self, other: &RequestId) -> 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 Serialize for RequestId

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RequestId

impl StructuralPartialEq for RequestId