Controladores Socket.IO
En Sword, un controlador Socket.IO es un struct anotado con #[controller(kind = Controller::SocketIo, namespace = "...")] cuyos métodos manejan eventos declarados con #[on("...")].
Definir un controlador
rust
use sword::prelude::*;
use sword::socketio::*;
#[controller(kind = Controller::SocketIo, namespace = "/chat")]
pub struct ChatController;
impl ChatController {
#[on("connection")]
async fn on_connect(&self, socket: SocketContext) {
println!("Client connected: {}", socket.id());
let query: Option<MyQuery> = socket.query().unwrap();
println!("Query params: {:?}", query);
}
#[on("message")]
async fn on_message(&self, socket: SocketContext) {
let Ok(message) = socket.try_data::<String>() else {
return;
};
socket.emit("message", &message).ok();
}
}Leyendo parámetros de query
El método socket.query::<T>() deserializa los parámetros de query de la URL de conexión:
rust
#[on("connection")]
async fn on_connect(&self, socket: SocketContext) {
let query: Option<MyQuery> = socket.query().unwrap();
}Eventos soportados
Eventos especiales
#[on("connection")]#[on("disconnection")]#[on("fallback")]
Eventos personalizados
#[on("message")]#[on("chat-message")]#[on("room:join")]
Registro en un módulo
rust
use sword::prelude::*;
pub struct ChatModule;
impl Module for ChatModule {
fn register_controllers(controllers: &ControllerRegistry) {
controllers.register::<ChatController>();
}
}