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

Criar: texto continua sendo dado

Um apóstrofo no título não deve quebrar a consulta.

Vamos descobrir juntos

1
No fluxo POST, o handler recebe JSON, valida e chama Store::create. A SQL usa VALUES (?, ?); bind envia título e prioridade como valores. Não monte SQL concatenando entrada: O'Brien é um nome comum, e outros textos podem parecer comandos.
2
Depois do INSERT, last_insert_rowid identifica o registro criado. A resposta 201 devolve esse id e os valores normalizados, incluindo done=false. Um título repetido cria outro registro; o projeto não definiu unicidade do título nem deduplicação de envios.
3
Inspecione o teste com apóstrofo, marcação HTML e texto parecido com SQL. Depois da chamada, a tabela continua existindo e o título é preservado como texto. Isso verifica esse caminho parametrizado; não prova que toda aplicação é imune a injeção nem resolve autorização.
4
Um INSERT isolado é atômico no SQLite: ou o registro é inserido, ou a instrução falha. Se uma futura ação modificar várias tabelas como uma unidade, será preciso uma transação envolvendo todas as etapas. Não chame duas gravações independentes de transação única.

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/store.rs

sqlx::query("INSERT INTO missions (title, priority) VALUES (?, ?)")
    .bind(&input.title)
    .bind(input.priority)
    .execute(&self.pool).await?

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

SQLite: parâmetros e expressões

✦

SUA MISSÃO

Seguir uma criação validada até o INSERT parametrizado e a resposta 201.

Agora é a sua vez

Oficina de descobertas

Decida antes de executar

Seguir uma criação validada até o INSERT parametrizado e a resposta 201.

01Como enviar um título para a consulta?02Qual status confirma criação neste contrato?

Monte suas respostas e confira quando estiver pronto.

Uma pausa para entender

Duas criações com o mesmo título produzem o quê neste projeto?

Dois registros com ids diferentesUma única missão automaticamenteUma autorização de administrador

Preciso de uma pista

Não há unicidade de título nem chave de idempotência para POST. Esse limite precisa ser conhecido antes de repetir um envio incerto.

Carregando sua jornada…

Leve com você

Crie um título com apóstrofo e confira resposta, listagem e reinício. Acrescente um teste com outra entrada incomum válida. Explique por que bind separa instrução e valor, sem prometer resolver permissões.

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 crate::validation::NewMission;
use rullst::orm::sqlx::{
    self, Row, SqlitePool,
    sqlite::{SqliteConnectOptions, SqlitePoolOptions},
};
use serde::Serialize;
use std::{path::Path, time::Duration};

#[derive(Clone)]
pub struct Store {
    pub pool: SqlitePool,
}

#[derive(Debug, Serialize)]
pub struct Mission {
    pub id: i64,
    pub title: String,
    pub priority: i64,
    pub done: bool,
}

impl Store {
    pub async fn open(path: &Path) -> Result<Self, sqlx::Error> {
        let options = SqliteConnectOptions::new()
            .filename(path)
            .create_if_missing(true)
            .foreign_keys(true)
            .busy_timeout(Duration::from_secs(5));
        let pool = SqlitePoolOptions::new()
            .max_connections(1)
            .connect_with(options)
            .await?;
        let version: i64 = sqlx::query_scalar("PRAGMA user_version")
            .fetch_one(&pool)
            .await?;
        if version > 1 {
            return Err(sqlx::Error::Protocol("Unsupported schema version".into()));
        }
        sqlx::raw_sql(include_str!("../schema.sql"))
            .execute(&pool)
            .await?;
        Ok(Self { pool })
    }

pub async fn list(&self) -> Result<Vec<Mission>, sqlx::Error> {
        let rows = sqlx::query("SELECT id, title, priority, done FROM missions ORDER BY priority DESC, id ASC LIMIT 100")
            .fetch_all(&self.pool).await?;
        rows.into_iter()
            .map(|row| {
                Ok(Mission {
                    id: row.try_get("id")?,
                    title: row.try_get("title")?,
                    priority: row.try_get("priority")?,
                    done: row.try_get("done")?,
                })
            })
            .collect()
    }

// Only validated input reaches this operation through the HTTP handler.
    pub async fn create(&self, input: NewMission) -> Result<Mission, sqlx::Error> {
        let result = sqlx::query("INSERT INTO missions (title, priority) VALUES (?, ?)")
            .bind(&input.title)
            .bind(input.priority)
            .execute(&self.pool)
            .await?;
        Ok(Mission {
            id: result.last_insert_rowid(),
            title: input.title,
            priority: input.priority,
            done: false,
        })
    }

pub async fn complete(&self, id: i64, done: bool) -> Result<bool, sqlx::Error> {
        let result = sqlx::query("UPDATE missions SET done = ? WHERE id = ?")
            .bind(done)
            .bind(id)
            .execute(&self.pool)
            .await?;
        Ok(result.rows_affected() == 1)
    }
}

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.

Criar: texto continua sendo dado

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