1
0
mirror of https://github.com/actix/actix-website synced 2025-01-22 16:15:56 +01:00

remove outdated info about force closing connections

This commit is contained in:
Rob Ede 2022-03-05 23:54:23 +00:00
parent 91d61f5be6
commit f504c65862
No known key found for this signature in database
GPG Key ID: 97C636207D3EF933
3 changed files with 2 additions and 20 deletions

View File

@ -91,14 +91,10 @@ Actix Web keeps connections open to wait for subsequent requests.
{{< include-example example="server" file="keep_alive.rs" section="keep-alive" >}} {{< include-example example="server" file="keep_alive.rs" section="keep-alive" >}}
If the first option above is selected, then _keep alive_ state is calculated based on the response's _connection-type_. By default `HttpResponse::connection_type` is not defined. In that case -keep-alive is defined by the request's HTTP version. If the first option above is selected, then keep-alive is enabled for HTTP/1.1 requests if the response does not explicitly disallow it by, for example, setting the [connection type][httpconnectiontype] to `Close` or `Upgrade`. Force closing a connection can be done with [the `force_close()` method on `HttpResponseBuilder`](https://docs.rs/actix-web/3/actix_web/dev/struct.HttpResponseBuilder.html#method.force_close)
> Keep-alive is **off** for HTTP/1.0 and is **on** for HTTP/1.1 and HTTP/2.0. > Keep-alive is **off** for HTTP/1.0 and is **on** for HTTP/1.1 and HTTP/2.0.
_Connection type_ can be changed with `HttpResponseBuilder::connection_type()` method.
{{< include-example example="server" file="keep_alive_tp.rs" section="example" >}}
## Graceful shutdown ## Graceful shutdown
`HttpServer` supports graceful shutdown. After receiving a stop signal, workers have a specific amount of time to finish serving requests. Any workers still alive after the timeout are force-dropped. By default the shutdown timeout is set to 30 seconds. You can change this parameter with the [`HttpServer::shutdown_timeout()`][shutdowntimeout] method. `HttpServer` supports graceful shutdown. After receiving a stop signal, workers have a specific amount of time to finish serving requests. Any workers still alive after the timeout are force-dropped. By default the shutdown timeout is set to 30 seconds. You can change this parameter with the [`HttpServer::shutdown_timeout()`][shutdowntimeout] method.
@ -121,3 +117,4 @@ _Connection type_ can be changed with `HttpResponseBuilder::connection_type()` m
[exampleopenssl]: https://github.com/actix/examples/tree/master/security/openssl [exampleopenssl]: https://github.com/actix/examples/tree/master/security/openssl
[shutdowntimeout]: https://docs.rs/actix-web/3/actix_web/struct.HttpServer.html#method.shutdown_timeout [shutdowntimeout]: https://docs.rs/actix-web/3/actix_web/struct.HttpServer.html#method.shutdown_timeout
[disablesignals]: https://docs.rs/actix-web/3/actix_web/struct.HttpServer.html#method.disable_signals [disablesignals]: https://docs.rs/actix-web/3/actix_web/struct.HttpServer.html#method.disable_signals
[httpconnectiontype]: https://docs.rs/actix-web/3/actix_web/http/enum.ConnectionType.html

View File

@ -1,14 +0,0 @@
// <example>
use actix_web::{http, HttpRequest, HttpResponse};
async fn index(req: HttpRequest) -> HttpResponse {
HttpResponse::Ok()
.connection_type(http::ConnectionType::Close) // <- Close connection
.force_close() // <- Alternative method
.finish()
}
// </example>
// ConnectionType::Close
// ConnectionType::KeepAlive
// ConnectionType::Upgrade

View File

@ -1,5 +1,4 @@
pub mod keep_alive; pub mod keep_alive;
// pub mod keep_alive_tp;
pub mod signals; pub mod signals;
pub mod ssl; pub mod ssl;
pub mod workers; pub mod workers;