Struct RequestIdMiddleware 

pub struct RequestIdMiddleware { /* private fields */ }

Middleware that adds unique request IDs to requests and responses.

This middleware:

1. Checks for an existing X-Request-ID header from the client
2. If present and valid, uses it; otherwise generates a new ID
3. Stores the ID in request extensions for handlers to access
4. Adds the ID to response headers

Example

use fastapi_core::middleware::RequestIdMiddleware;

let mut stack = MiddlewareStack::new();
stack.push(RequestIdMiddleware::new());

// In your handler:
async fn handler(ctx: &RequestContext, req: &Request) -> Response {
    if let Some(request_id) = req.get_extension::<RequestId>() {
        println!("Request ID: {}", request_id);
    }
    Response::ok()
}

Implementations

impl RequestIdMiddleware

pub fn new() -> Self

Creates a new request ID middleware with default configuration.

pub fn with_config(config: RequestIdConfig) -> Self

Creates a new request ID middleware with the given configuration.

Trait Implementations

impl Clone for RequestIdMiddleware

fn clone(&self) -> RequestIdMiddleware

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestIdMiddleware

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

Formats the value using the given formatter.

impl Default for RequestIdMiddleware

fn default() -> Self

Returns the “default value” for a type.

impl Middleware for RequestIdMiddleware

fn before<'a>( &'a self, _ctx: &'a RequestContext, req: &'a mut Request, ) -> BoxFuture<'a, ControlFlow>

Called before the handler executes.

fn after<'a>( &'a self, _ctx: &'a RequestContext, req: &'a Request, response: Response, ) -> BoxFuture<'a, Response>

Called after the handler executes.

fn name(&self) -> &'static str

Returns the middleware name for debugging and logging.