How tokio-rs/axum works
Axum is a Rust HTTP routing and request-handling library. Its main workflow accepts an HTTP request at a listener, dispatches it through a router and method-specific handler, extracts typed inputs, and converts the handler result into an HTTP response. Supporting branches provide Tower-compatible middleware and services, derive macros, and axum-extra extractors, routing, bodies, and response types. The README documents these capabilities; some links below are documented or index-backed because their implementation excerpts were not provided.
Main entry points: extract/mod.rs Extractor traits · handler/mod.rs Handler service · routing/mod.rs Path router · response/mod.rs Response conversion
Components 23
HTTP runtime
- HTTP serving
axum/src/serve/mod.rs - Path router
axum/src/routing/mod.rs - Route dispatch
axum/src/routing/path_router.rs - Method routing
axum/src/routing/method_routing.rs - Handler service
axum/src/handler/mod.rs
Request processing
- Extractor traits
axum-core/src/extract/mod.rs - Request extractors
axum/src/extract/mod.rs - Query parsing
axum/src/extract/query.rs - Connection info
axum/src/extract/connect_info.rs - HTTP body
axum-core/src/body.rs
Responses
- Response conversion
axum-core/src/response/mod.rs - Response types
axum/src/response/mod.rs - Server events
axum/src/response/sse.rs
Ecosystem extensions
- Tower middleware
axum/src/middleware/mod.rs - Extra extractors
axum-extra/src/extract - Extra responses
axum-extra/src/response - Extra routing
axum-extra/src/routing/mod.rs - Extra body tools
axum-extra/src/body
Derive macros
- Procedural macros
axum-macros/src/lib.rs - Attribute parsing
axum-macros/src/attr_parsing.rs - Handler diagnostics
axum-macros/src/debug_handler.rs
Other components
- HTTP client
- Tower ecosystem
Connections 20
- HTTP client → HTTP serving: sends requests
README.md - HTTP serving → Path router: serves service
axum/src/serve/mod.rs - Path router → Route dispatch: dispatches paths
axum/src/routing/mod.rs - Route dispatch → Method routing: selects route
axum/src/routing/path_router.rs - Method routing → Handler service: calls handler
axum/src/routing/method_routing.rs - Handler service → Extractor traits: extracts arguments
axum/src/handler/mod.rs - Request extractors → Extractor traits: implements traits
axum/src/extract/mod.rs - Query parsing → Extractor traits: implements extraction
axum/src/extract/query.rs - Connection info → Extractor traits: implements extraction
axum/src/extract/connect_info.rs - Extractor traits → HTTP body: consumes request body
axum-core/src/extract/mod.rs - Handler service → Response conversion: converts result
axum-core/src/response/mod.rs - Response types → Response conversion: uses conversion traits
axum/src/response/mod.rs - Response types → Server events: exports events
axum/src/response/mod.rs - Handler service → Tower middleware: uses service layers
README.md - Tower ecosystem → Tower middleware: provides services
README.md - Extra extractors → Extractor traits: extends extraction
- Extra responses → Response conversion: extends responses
- Extra routing → Path router: extends routing
- Procedural macros → Attribute parsing: parses attributes
axum-macros/src/lib.rs - Procedural macros → Handler diagnostics: provides diagnostics
axum-macros/src/lib.rs