mirror of https://github.com/fafhrd91/actix-web
31348a2339
What
--
Define a new `route` attribute macro that supports defining multiple
HTTP methods to routed to (handled by) a single handler.
The attribute macro syntax looks like this
```rust
use actix_web::route;
async fn multi_methods() -> &'static str {
"Hello world!\r\n"
}
```
How
--
This implementation extends the [`GuardType`][1] enum in actix-web-codegen to have a
new `GuardType::Multi` variant that denotes when multiple method guards
are used.
A new `methods` attribute in the `route` attribute macro provides a
comma-separated list of HTTP methods to provide guard for.
The code parses the methods list, matches them to the respective
`GuardType` and uses the `AnyGuard` struct to combine them together.
A constructor method for [`AnyGuard`][2] is added to support this.
The generated code looks like this:
```rust
pub struct multi_methods;
impl actix_web::dev::HttpServiceFactory for multi_methods {
fn register(self, __config: &mut actix_web::dev::AppService) {
¦ async fn multi_methods() -> &'static str {
¦ ¦ "Hello world!\r\n"
¦ }
¦ let __resource = actix_web::Resource::new("/multi")
¦ ¦ .name("multi_methods")
¦ ¦ .guard(actix_web:💂:AnyGuard::new(<[_]>::into_vec(box [
¦ ¦ ¦ Box::new(actix_web:💂:Get()),
¦ ¦ ¦ Box::new(actix_web:💂:Post()),
¦ ¦ ])))
¦ ¦ .to(multi_methods);
¦ actix_web::dev::HttpServiceFactory::register(__resource, __config)
}
}
```
**NOTE: This is my first attempt that implementing this feature.
Feedback and mentorship is highly welcome to improve it :-)**
Why
--
This fixes https://github.com/actix/actix-web/issues/1360
[1]: https://github.com/actix/actix-web/blob/master/actix-web-codegen/src/route.rs#L21
[2]: https://github.com/actix/actix-web/blob/master/src/guard.rs#L104s
|
||
|---|---|---|
| .github | ||
| actix-files | ||
| actix-http | ||
| actix-multipart | ||
| actix-web-actors | ||
| actix-web-codegen | ||
| awc | ||
| benches | ||
| docs/graphs | ||
| examples | ||
| src | ||
| test-server | ||
| tests | ||
| .gitignore | ||
| CHANGES.md | ||
| CODE_OF_CONDUCT.md | ||
| Cargo.toml | ||
| LICENSE-APACHE | ||
| LICENSE-MIT | ||
| MIGRATION.md | ||
| README.md | ||
| codecov.yml | ||
| rust-toolchain | ||
| rustfmt.toml | ||
README.md
Actix web
Actix web is a powerful, pragmatic, and extremely fast web framework for Rust
Features
- Supports HTTP/1.x and HTTP/2
- Streaming and pipelining
- Keep-alive and slow requests handling
- Client/server WebSockets support
- Transparent content compression/decompression (br, gzip, deflate)
- Powerful request routing
- Multipart streams
- Static assets
- SSL support using OpenSSL or Rustls
- Middlewares (Logger, Session, CORS, etc)
- Includes an async HTTP client
- Supports Actix actor framework
- Runs on stable Rust 1.42+
Documentation
Example
Dependencies:
[dependencies]
actix-web = "3"
Code:
use actix_web::{get, web, App, HttpServer, Responder};
#[get("/{id}/{name}/index.html")]
async fn index(web::Path((id, name)): web::Path<(u32, String)>) -> impl Responder {
format!("Hello {}! id:{}", name, id)
}
#[actix_web::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(|| App::new().service(index))
.bind("127.0.0.1:8080")?
.run()
.await
}
More examples
- Basic Setup
- Application State
- JSON Handling
- Multipart Streams
- Diesel Integration
- r2d2 Integration
- Simple WebSocket
- Tera Templates
- Askama Templates
- HTTPS using Rustls
- HTTPS using OpenSSL
- WebSocket Chat
You may consider checking out this directory for more examples.
Benchmarks
One of the fastest web frameworks available according to the TechEmpower Framework Benchmark.
License
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Code of Conduct
Contribution to the actix-web crate is organized under the terms of the Contributor Covenant, the maintainers of Actix web, promises to intervene to uphold that code of conduct.