Actix web

Asynchronous web framework for Actix.

User Guide
API Documentation (Development)
API Documentation (Releases)
Cargo package: actix-web
Minimum supported Rust version: 1.20 or later

Actix web is licensed under the Apache-2.0 license.

Features

Supported HTTP/1 and HTTP/2 protocols
Streaming and pipelining
Keep-alive and slow requests handling
WebSockets
Transparent content compression/decompression (br, gzip, deflate)
Configurable request routing
Multipart streams
Middlewares (Logger, Session included)

Usage

To use actix-web, add this to your Cargo.toml:

[dependencies]
actix-web = { git = "https://github.com/actix/actix-web" }

HTTP/2

Actix web automatically upgrades connection to http/2 if possible.

Negotiation

HTTP/2 protocol over tls without prior knowlage requires tls alpn. At the moment only rust-openssl supports alpn.

[dependencies]
actix-web = { git = "https://github.com/actix/actix-web", features=["alpn"] }

Upgrade to http/2 schema described in rfc section 3.2 is not supported. Starting http/2 with prior knowledge is supported for both clear text connection and tls connection. rfc section 3.4

tls example

Example

# extern crate actix;
# extern crate actix_web;
# 
use actix::*;
use actix_web::*;

fn index(req: HttpRequest) -> String {
    format!("Hello {}!", &req.match_info()["name"])
}

fn main() {
    let sys = actix::System::new("ws-example");

    HttpServer::new(
        Application::default("/")
            .resource("/{name}", |r| r.method(Method::GET).f(index)))
        .serve::<_, ()>("127.0.0.1:8080").unwrap();

    Arbiter::system().send(msgs::SystemExit(0));
    let _ = sys.run();
}

3.2 KiB Raw Blame History