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

• Basic
• Stateful
• Mulitpart streams
• Simple websocket session
• Tcp/Websocket chat
• SockJS Server

# 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();
}