10 releases
0.3.0 | Jul 20, 2024 |
---|---|
0.2.5 | Mar 10, 2022 |
0.1.0 | Sep 27, 2020 |
0.1.0-alpha.1 | May 8, 2020 |
0.1.0-alpha.0 | Apr 25, 2020 |
#8 in WebSocket
49,404 downloads per month
Used in 13 crates
(10 directly)
27KB
421 lines
actix-ws
WebSockets for Actix Web, without actors.
Example
use actix_web::{middleware::Logger, web, App, HttpRequest, HttpServer, Responder};
use actix_ws::Message;
async fn ws(req: HttpRequest, body: web::Payload) -> actix_web::Result<impl Responder> {
let (response, mut session, mut msg_stream) = actix_ws::handle(&req, body)?;
actix_web::rt::spawn(async move {
while let Some(Ok(msg)) = msg_stream.next().await {
match msg {
Message::Ping(bytes) => {
if session.pong(&bytes).await.is_err() {
return;
}
}
Message::Text(msg) => println!("Got text: {msg}"),
_ => break,
}
}
let _ = session.close(None).await;
});
Ok(response)
}
#[actix_web::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(move || {
App::new()
.wrap(Logger::default())
.route("/ws", web::get().to(ws))
})
.bind("127.0.0.1:8080")?
.run()
.await?;
Ok(())
}
Resources
- API Documentation
- Example Chat Project
- Minimum Supported Rust Version (MSRV): 1.75
License
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Dependencies
~15–26MB
~433K SLoC