mirror of https://github.com/fafhrd91/actix-web
The existing pipelining behavior of the h1 dispatcher can cause client timeouts if the entire request body isn't read. It puts the dispatcher into a state where it refuses to read more (payload dropped) but there are still bytes in the buffer from the request body. This solution adds the SHUTDOWN flag in addition to the FINISHED flag when completing a response when both the following are true: 1. There are no messages in `this.messages` 2. There is still a payload in `this.payload` This combination implies two things. First, that we have not parsed a pipelined request after the request we have just responded to. Second, that the current request payload has not been fed an EOF. Because there are no pipelined requests, we know that the current request payload belongs to the request we have just responded to, and because the request payload has not been fed an EOF, we know we never finished reading it. When this occurs, adding the SHUTDOWN flag to the dispatcher triggers a `flush` and a `poll_shutdown` on the IO resource on the next poll. |
||
---|---|---|
.github | ||
actix-files | ||
actix-http | ||
actix-http-test | ||
actix-multipart | ||
actix-multipart-derive | ||
actix-router | ||
actix-test | ||
actix-web | ||
actix-web-actors | ||
actix-web-codegen | ||
awc | ||
docs/graphs | ||
scripts | ||
.clippy.toml | ||
.codecov.yml | ||
.cspell.yml | ||
.gitignore | ||
.prettierrc.yml | ||
.rustfmt.toml | ||
.taplo.toml | ||
CHANGES.md | ||
CODE_OF_CONDUCT.md | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE-APACHE | ||
LICENSE-MIT | ||
README.md | ||
justfile |
README.md
Features
- Supports HTTP/1.x and HTTP/2
- Streaming and pipelining
- Powerful request routing with optional macros
- Full Tokio compatibility
- Keep-alive and slow requests handling
- Client/server WebSockets support
- Transparent content compression/decompression (br, gzip, deflate, zstd)
- Multipart streams
- Static assets
- SSL support using OpenSSL or Rustls
- Middlewares (Logger, Session, CORS, etc)
- Integrates with the
awc
HTTP client - Runs on stable Rust 1.72+
Documentation
Example
Dependencies:
[dependencies]
actix-web = "4"
Code:
use actix_web::{get, web, App, HttpServer, Responder};
#[get("/hello/{name}")]
async fn greet(name: web::Path<String>) -> impl Responder {
format!("Hello {name}!")
}
#[actix_web::main] // or #[tokio::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(|| {
App::new().service(greet)
})
.bind(("127.0.0.1", 8080))?
.run()
.await
}
More Examples
- Hello World
- Basic Setup
- Application State
- JSON Handling
- Multipart Streams
- MongoDB Integration
- Diesel Integration
- SQLite Integration
- Postgres Integration
- Tera Templates
- Askama Templates
- HTTPS using Rustls
- HTTPS using OpenSSL
- Simple WebSocket
- 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 the following licenses, at your option:
- 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])
Code of Conduct
Contribution to the actix/actix-web
repo is organized under the terms of the Contributor Covenant. The Actix team promises to intervene to uphold that code of conduct.