Validación de datos

Al igual que en controladores web, es posible validar datos entrantes en eventos Socket.IO usando el crate validator.

Para la referencia completa de try_data y try_validated_data, revisa Manejo de eventos y referencia de SocketContext.

Habilitar validation-validator

Para usar validación en SocketContext, debes habilitar la feature validation-validator.

[dependencies]
sword = { version = "x.y.z", features = ["validation-validator"] }
serde = { version = "x.y.z", features = ["derive"] }
validator = { version = "x.y.z", features = ["derive"] }

Ejemplo de uso

dtos.rs

use serde::Deserialize;
use validator::Validate;

#[derive(Debug, Deserialize, Validate)]
struct IncomingDataDto {
    #[validate(length(min = 1, max = 200))]
    pub content: String,
}

controller.rs

use sword::prelude::*;
use sword::socketio::*;

#[controller(kind = Controller::SocketIo, namespace = "/chat")]
pub struct ChatController;

impl ChatController {
    #[on("message")]
    async fn handle_message(&self, socket: SocketContext) {
        let Ok(data) = socket.try_validated_data::<IncomingDataDto>() else {
            eprintln!("Failed to validate message data");
            return;
        };

        socket.emit("message", &data.content).ok();
    }
}

Diferencia con try_data

• try_data::<T>() solo deserializa el payload.
• try_validated_data::<T>() deserializa y luego ejecuta Validate.

Si la validación falla, el método retorna un error y puedes decidir cómo manejarlo dentro del handler.