Asynchronous web framework for Actix.
- API Documentation (Development)
- API Documentation (Releases)
- Cargo package: actix-http
- Minimum supported Rust version: 1.20 or later
Actix web is licensed under the Apache-2.0 license.
Features
- HTTP 1.1 and 1.0 support
- Streaming and pipelining support
- Keep-alive and slow requests support
- WebSockets support
- Configurable request routing
- Multipart streams
- Middlewares
Usage
To use actix-web, add this to your Cargo.toml:
[dependencies] actix-web = "0.1"
Example
extern crate actix; extern crate actix_web; extern crate env_logger; use actix::*; use actix_web::*; struct MyWebSocket; impl Actor for MyWebSocket { type Context = HttpContext<Self>; } impl Route for MyWebSocket { type State = (); fn request(req: &mut HttpRequest, payload: Payload, ctx: &mut HttpContext<Self>) -> RouteResult<Self> { let resp = ws::handshake(req)?; ctx.start(resp); ctx.add_stream(ws::WsStream::new(payload)); Reply::async(MyWebSocket) } } impl StreamHandler<ws::Message> for MyWebSocket { fn started(&mut self, ctx: &mut Self::Context) { println!("WebSocket session openned"); } fn finished(&mut self, ctx: &mut Self::Context) { println!("WebSocket session closed"); } } impl Handler<ws::Message> for MyWebSocket { fn handle(&mut self, msg: ws::Message, ctx: &mut HttpContext<Self>) -> Response<Self, ws::Message> { println!("WS: {:?}", msg); match msg { ws::Message::Ping(msg) => ws::WsWriter::pong(ctx, msg), ws::Message::Text(text) => ws::WsWriter::text(ctx, &text), ws::Message::Binary(bin) => ws::WsWriter::binary(ctx, bin), ws::Message::Closed | ws::Message::Error => { ctx.stop(); } _ => (), } Self::empty() } } fn main() { ::std::env::set_var("RUST_LOG", "actix_web=info"); let _ = env_logger::init(); let sys = actix::System::new("ws-example"); HttpServer::new( Application::default("/") // enable logger .middleware(Logger::new(None)) // websocket route .resource("/ws/", |r| r.get::<MyWebSocket>()) .route_handler("/", StaticFiles::new("examples/static/", true))) .serve::<_, ()>("127.0.0.1:8080").unwrap(); println!("Started http server: 127.0.0.1:8080"); let _ = sys.run(); }