Aplicações com Rullst I · Lição 06 / 14

Validar na fronteira certa

Uma chamada direta não passa pelas regras do formulário.

Vamos descobrir juntos

1
NewMission descreve o formato esperado; Deserialize lê JSON e deny_unknown_fields rejeita campos extras. Depois validate aplica regras do domínio. Conseguir converter JSON em uma struct não prova que um título vazio ou prioridade 9 faz sentido.
2
O título é aparado com trim, deve ter 1–80 pontos de código Unicode e não aceita caracteres de controle, como quebra de linha. chars().count() não conta bytes nem necessariamente símbolos percebidos: alguns emojis combinam vários pontos de código. A prioridade deve estar entre 1 e 3.
3
Preveja os resultados para título de espaços, 80 letras é, 81 letras x e prioridade 0. Execute cargo test --locked title_and_priority_boundaries. O teste de é diferencia pontos de código de bytes UTF-8; use também um exemplo com emoji para explicar o limite da medida.
4
No handler, validate vem antes de store.create. Uma falha retorna 422 com código de erro e não insere registro. O teste HTTP chama a API diretamente, sem depender de required no navegador, e verifica que a contagem não mudou.

Sua bancada de aplicações

O kit inclui o aplicativo completo para investigar e modificar. O trecho abaixo explica esta etapa; o editor contém o arquivo indicado. A Rullst Academy não compila nem executa esse servidor no navegador.

Arquivo para estudar e modificar

src/validation.rs

let title = input.title.trim().to_owned();
if !(1..=80).contains(&title.chars().count()) {
    return Err("invalid_title");
}

Extraia o kit numa pasta nova e abra o terminal junto a Cargo.toml. Use Rust 1.96+; o primeiro build pode baixar dependências e demorar. Depois abra http://127.0.0.1:3010. Pare com Ctrl+C e execute novamente após editar.

cargo test --locked
cargo run --locked

Meus arquivos e GitHub

Baixe seu rascunho e substitua o arquivo indicado na sua cópia extraída. O editor guarda um arquivo neste navegador; a conta guarda avaliações e XP. O ZIP não contém suas alterações. GitHub envia só o arquivo confirmado; para o aplicativo completo use Git manual, sem bancos, backups ou segredos.

Links oficiais e próximo passo

✦

SUA MISSÃO

Testar limites e rejeitar entrada inválida antes de modificar o banco.

Leve com você

Em uma cópia, mude o limite para 60. Atualize regra, CHECK do esquema novo, explicação da interface e testes 60/61. Use um banco de teste novo: CREATE TABLE IF NOT EXISTS não modifica uma tabela existente. Explique por que só mudar o texto seria insuficiente.

No seu ritmo

Meus arquivos e GitHub

Toda lição pode virar um registro seu: código, anotações ou um plano de prática. Guardar um arquivo no GitHub é opcional e não altera seu XP.

Manual do aluno

O editor e os downloads abrem quando esta lição estiver liberada para sua conta. Confira o acesso abaixo ou volte ao mapa da trilha.

Conferindo seu acesso à lição…

Seu caminho, passo a passo

Baixar material da atividade

Baixe o exemplo da lição e um caderno para suas anotações. O ZIP inclui um guia para organizar atividades em um ou mais repositórios. Publicar é opcional; contas elegíveis também podem usar o botão de envio ao GitHub.

Seu arquivo desta lição

Edite o exemplo ou registre o que aprendeu. Este espaço não executa código nem corrige respostas. O rascunho é salvo apenas neste navegador, separado por conta; baixar e enviar ao GitHub são ações suas.

O exemplo pode ser apenas um trecho ou roteiro. Mudar a extensão não o transforma em programa completo. O ZIP da atividade contém material inicial; o botão de arquivo editado baixa o seu texto.

Meu código ou minhas anotações

use serde::Deserialize;

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct NewMission {
    pub title: String,
    pub priority: i64,
}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct Completion {
    pub done: bool,
}

pub fn validate(input: NewMission) -> Result<NewMission, &'static str> {
    let title = input.title.trim().to_owned();
    if !(1..=80).contains(&title.chars().count()) || title.chars().any(char::is_control) {
        return Err("invalid_title");
    }
    if !(1..=3).contains(&input.priority) {
        return Err("invalid_priority");
    }
    Ok(NewMission {
        title,
        priority: input.priority,
    })
}

#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn title_and_priority_boundaries() {
        for title in ["", "   ", "line\nbreak", &"x".repeat(81)] {
            assert!(
                validate(NewMission {
                    title: title.into(),
                    priority: 1
                })
                .is_err()
            );
        }
        for priority in [0, 4, -1] {
            assert!(
                validate(NewMission {
                    title: "Orbit".into(),
                    priority
                })
                .is_err()
            );
        }
        let input = validate(NewMission {
            title: format!(" {} ", "é".repeat(80)),
            priority: 3,
        })
        .unwrap();
        assert_eq!(input.title.chars().count(), 80);
        assert_eq!(input.priority, 3);
    }
}

Formato do arquivo

Seu texto será guardado neste navegador ao editar. Em computador compartilhado, limpe os rascunhos ao terminar.

O envio direto aceita até 8 KiB de texto em um arquivo. Use o download e o guia manual para projetos com vários arquivos.

Validar na fronteira certa

Vamos descobrir juntos

Sua bancada de aplicações

Arquivo para estudar e modificar

Links oficiais e próximo passo

Agora é a sua vez

Decida antes de executar

Leve com você

Meus arquivos e GitHub

Seu arquivo desta lição

Guardar no meu GitHub

Rullstpetbot