mirror of https://github.com/fafhrd91/actix-web
f615e41b78
What -- Refactor `ResourceMap` struct to remove hard references to parent ResourceMap. How -- Assuming the child resource maps are always nested within a parent, then we can always assume the parent will be there and use a weak reference to refer back to it. > A Weak pointer is useful for keeping a temporary reference to the allocation managed by Rc without preventing its inner value from being dropped. It is also used to prevent circular references between Rc pointers, since mutual owning references would never allow either Rc to be dropped. For example, a tree could have strong Rc pointers from parent nodes to children, and Weak pointers from children back to their parents. [ref](https://doc.rust-lang.org/nightly/std/rc/struct.Weak.html) |
||
|---|---|---|
| .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.