mirror of
https://github.com/actix/actix-web.git
synced 2024-12-24 09:00:34 +00:00
116 lines
3.7 KiB
Markdown
116 lines
3.7 KiB
Markdown
# Actix web [](https://travis-ci.org/actix/actix-web) [](https://ci.appveyor.com/project/fafhrd91/actix-web-hdy9d/branch/master) [](https://codecov.io/gh/actix/actix-web) [](https://crates.io/crates/actix-web)
|
|
|
|
Asynchronous web framework for [Actix](https://github.com/actix/actix).
|
|
|
|
* [API Documentation (Development)](http://actix.github.io/actix-web/actix_web/)
|
|
* [API Documentation (Releases)](https://docs.rs/actix-web/)
|
|
* Cargo package: [actix-http](https://crates.io/crates/actix-web)
|
|
* Minimum supported Rust version: 1.20 or later
|
|
|
|
---
|
|
|
|
Actix web is licensed under the [Apache-2.0 license](http://opensource.org/licenses/APACHE-2.0).
|
|
|
|
## Features
|
|
|
|
* HTTP 1.1 and 1.0 support
|
|
* Streaming and pipelining support
|
|
* Keep-alive and slow requests support
|
|
* [WebSockets support](https://actix.github.io/actix-web/actix_web/ws/index.html)
|
|
* Configurable request routing
|
|
* Multipart streams
|
|
* Middlewares
|
|
|
|
## Usage
|
|
|
|
To use `actix-web`, add this to your `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
actix-web = "0.1"
|
|
```
|
|
|
|
## Example
|
|
|
|
* [Basic](https://github.com/actix/actix-web/tree/master/examples/basic.rs)
|
|
* [Stateful](https://github.com/actix/actix-web/tree/master/examples/state.rs)
|
|
* [Mulitpart streams](https://github.com/actix/actix-web/tree/master/examples/multipart)
|
|
* [Simple websocket session](https://github.com/actix/actix-web/tree/master/examples/websocket.rs)
|
|
* [Tcp/Websocket chat](https://github.com/actix/actix-web/tree/master/examples/websocket-chat)
|
|
|
|
|
|
```rust
|
|
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");
|
|
Arbiter::system().send(msgs::SystemExit(0));
|
|
let _ = sys.run();
|
|
}
|
|
```
|