#web-request #actix-web #actix-web-middleware #middleware #request-id #actix-middleware #observer

actix-request-hook

Actix web middleware hook for requests. Enables subscribing to request start and end, request id, elapsed time between requests and more.

2 releases

1.0.0-beta.4 Jul 6, 2022

#1646 in Web programming

Download history 693/week @ 2024-03-13 245/week @ 2024-03-20 329/week @ 2024-03-27 276/week @ 2024-04-03 420/week @ 2024-04-10 266/week @ 2024-04-17 177/week @ 2024-04-24 363/week @ 2024-05-01 88/week @ 2024-05-08 219/week @ 2024-05-15 291/week @ 2024-05-22 340/week @ 2024-05-29 563/week @ 2024-06-05 373/week @ 2024-06-12 361/week @ 2024-06-19 310/week @ 2024-06-26

1,686 downloads per month

MIT/Apache

22KB
340 lines

Actix Request Hook Continuous Integration cargo-badge license-badge

Actix web middleware hook for requests. Enables subscribing to request start and end, request id, elapsed time between requests and more.

Example

Code:

struct RequestLogger;

impl Observer for RequestLogger {
    fn on_request_started(&self, data: RequestStartData) {
        println!("started {}", data.uri)
    }
    fn on_request_ended(&self, data: RequestEndData) {
        println!("ended {} after {}ms", data.uri, data.elapsed.as_millis())
    }
}

struct UselessObserver {
    started: RefCell<bool>,
    ended: RefCell<bool>,
}

impl Default for UselessObserver {
    fn default() -> Self {
        Self {
            started: RefCell::new(false),
            ended: RefCell::new(false),
        }
    }
}

impl Observer for UselessObserver {
    fn on_request_started(&self, _data: RequestStartData) {
        *self.started.borrow_mut() = true;
    }

    // testing if request ended receives mutated property
    fn on_request_ended(&self, _data: RequestEndData) {
        let is_started = self.started.borrow();
        if *is_started {
            *self.ended.borrow_mut() = true;
        }
    }
}

async fn index() -> Result<String, Error> {
    Ok("Hi there!".to_string())
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        // You can register many different observers.
        // One could be for logging, other for notifying other parts of the system etc.
        let request_hook = RequestHook::new()
            .exclude("/bye") // bye route shouldn't be logged
            .exclude_regex("^/\\d$") // excludes any numbered route like "/123456"
            .register(Rc::new(RequestLogger {}))
            .register(Rc::new(UselessObserver::default()));
        
        App::new()
            .wrap(request_hook)
            .route("/bye", web::get().to(index))
            .route("/hey", web::get().to(index))
    }).bind("127.0.0.1:0").expect("Can not bind to 127.0.0.1:0")
        .run().await
}

Possible Use Cases

  • logging requests when started and ended
  • notifying sentry with all request data ...

What can you use

In request start there are:

  • request_id - unique id of a request, same for request start and end.
  • req - borrowed ServiceRequest.
  • uri - uri of request.
  • method - body of request.
  • body - body of request. Useful when debugging client requests e.g. maybe use it in Sentry.

In request end there are:

  • request_id - unique id of a request, same for request start and end.
  • elapsed - elapsed time between request start and end hook.
  • uri - uri of request.
  • method - body of request.
  • status - response status.

Caveats

Including RequestHook middleware might affect performance of your actix webapp. Observers are executed in a blocking manner, and there's also request body repacking on each request.

Contributing

This project welcomes all kinds of contributions. No contribution is too small!

If you want to contribute to this project but don't know how to begin or if you need help with something related to this project, feel free to send me an email https://www.eisberg-labs.com/ (contact form at the bottom).

Some pointers on contribution are in Contributing.md

Code of Conduct

This project follows the Rust Code of Conduct.

License

Distributed under the terms of MIT license and Apache license.

Dependencies

~17–28MB
~508K SLoC