What is the role of a "Extension" in actix-web?

Question

I'm trying to figure out how Extensions are created in the actix-web Rust library. I think I'm missing the concept of request extensions. What do request extensions do? How are they different from HTTP headers?

Flair

Answer 1

Extensions are used for storing request-local data. They are different than application data since it is specific to individual requests. And is different from headers since they are set within the server, not by the client.

This is primarily used for passing data between middleware and the handlers; like authentication or route-prefix processing. They can be set in the middleware by req.extensions_mut().insert(...) and can be retrieved in the handler via req.extensions().get<...>() or via the ReqData extractor.

See also:

• How to modify request data in actix-web middleware?
• How can I pass structs from an Actix middleware to the handler?
• Is there a way to bind a variable to a request in tower-http / hyper / axum?

Tol