mirror of https://github.com/fafhrd91/actix-web
As per RFC7230 section 3.3.2 <https://datatracker.ietf.org/doc/html/rfc7230#section-3.3.2>: > A server MAY send a Content-Length header field in a 304 (Not > Modified) response to a conditional GET request (Section 4.1 of > [RFC7232]); > a server MUST NOT send Content-Length in such a response > unless its field-value equals the decimal number of octets that would > have been sent in the payload body of a 200 (OK) response to the same > request. And per RFC7232 section 4.1 <https://datatracker.ietf.org/doc/html/rfc7232#section-4.1>: > A 304 response cannot contain a message-body; it is always terminated > by the first empty line after the header fields. Previously a `Content-Length: 0` header was sent because `.finish()` sets the body to `Body::Empty`, which indicates a zero-sized response. |
||
---|---|---|
.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 | ||
rustfmt.toml |
README.md
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.