Learn Rust Coding · Lezione

Extractor

Parsing delle richieste

Extractor è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Learn Rust Coding, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Learn Rust Coding include 4 lezioni in totale.

Che cos'è un estrattore?

Un estrattore è un parametro dell'handler che estrae automaticamente una parte della richiesta. Axum analizza i tipi dei parametri e li valorizza.

Nessuna analisi manuale della richiesta
Basato sui tipi e componibile

Estrattore Path

Path cattura i segmenti dinamici dell'URL. Il tipo contenuto determina come viene analizzato il segmento.

use axum::extract::Path;

async fn user(Path(id): Path<u32>) -> String {
    format!("user {}", id)
}

Più parametri del percorso

Catturi diversi segmenti estraendo una tupla. L'ordine corrisponde allo schema del percorso.

use axum::extract::Path;

async fn item(Path((cat, id)): Path<(String, u32)>) -> String {
    format!("{} / {}", cat, id)
}

Estrattore Query

Query deserializza la stringa di query dell'URL in una struct usando serde. È ideale per filtri e paginazione.

use axum::extract::Query;
use serde::Deserialize;

#[derive(Deserialize)]
struct Page { page: u32 }

async fn list(Query(p): Query<Page>) -> String {
    format!("page {}", p.page)
}

Estrattore del corpo JSON

Json deserializza il corpo di una richiesta in una struct. La struct deve derivare Deserialize.

use axum::Json;
use serde::Deserialize;

#[derive(Deserialize)]
struct NewUser { name: String }

async fn create(Json(u): Json<NewUser>) -> String {
    format!("created {}", u.name)
}

Estrattore degli header

Acceda agli header con l'estrattore HeaderMap o con estrattori di header tipizzati. È utile per i token di autenticazione.

use axum::http::HeaderMap;

async fn show(headers: HeaderMap) -> String {
    match headers.get("x-api-key") {
        Some(v) => format!("key: {:?}", v),
        None => "no key".to_string(),
    }
}

L'ordine degli estrattori è importante

Gli estrattori che consumano il corpo, come Json, devono trovarsi per ultimi nell'elenco dei parametri, perché il corpo può essere letto una sola volta.

use axum::{Json, extract::Path};
use serde::Deserialize;

#[derive(Deserialize)]
struct Body { value: i32 }

async fn h(Path(id): Path<u32>, Json(b): Json<Body>) -> String {
    format!("{} {}", id, b.value)
}

Modellare l'estrazione in Rust semplice

L'estrazione consiste semplicemente nell'analizzare dati tipizzati da una richiesta. Qui deserializziamo una stringa simile a una query in numeri.

fn parse_query(q: &str) -> Option<u32> {
    q.strip_prefix("page=")?.parse().ok()
}

fn main() {
    println!("{:?}", parse_query("page=3"));
    println!("{:?}", parse_query("bad"));
}

Estrazione facoltativa

Racchiuda un estrattore in Option per renderlo non bloccante. Un valore assente o non valido produce None invece di una risposta di errore.

use axum::extract::Query;
use serde::Deserialize;

#[derive(Deserialize)]
struct Filter { q: String }

async fn search(filter: Option<Query<Filter>>) -> String {
    match filter {
        Some(Query(f)) => f.q,
        None => "no filter".to_string(),
    }
}

Rifiuti

Quando un estrattore non riesce, restituisce un rifiuto che diventa una risposta HTTP di errore. Ad esempio, un JSON non valido produce automaticamente un 422.

use axum::extract::rejection::JsonRejection;
use axum::Json;

async fn create(body: Result<Json<i32>, JsonRejection>) -> String {
    match body {
        Ok(Json(n)) => format!("ok {}", n),
        Err(_) => "bad body".to_string(),
    }
}

Combinare gli estrattori

Un handler può usare contemporaneamente molti estrattori. Axum valorizza ciascuno con la parte corrispondente della richiesta.

use axum::{Json, extract::{Path, Query}};
use serde::Deserialize;

#[derive(Deserialize)]
struct Q { sort: String }
#[derive(Deserialize)]
struct B { name: String }

async fn h(Path(id): Path<u32>, Query(q): Query<Q>, Json(b): Json<B>) -> String {
    format!("{} {} {}", id, q.sort, b.name)
}

Verifica rapida

Verifichi la Sua comprensione degli estrattori.

Riepilogo

Ha imparato ad analizzare le richieste con gli estrattori:

Path per i segmenti dell'URL, Query per la stringa di query
Json per il corpo (deve essere l'ultimo)
HeaderMap per gli header
Option e Result gestiscono gli errori in modo controllato

Prossimo argomento: stato condiviso e risposte JSON.

Domande Frequenti

La lezione «Extractor» è gratuita?

Sì — il testo completo di «Extractor» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Learn Rust Coding, passa a CoddyKit PRO. Il corso Learn Rust Coding include 4 lezioni in totale.

Cosa imparerò in «Extractor»?

Parsing delle richieste Eserciti Learn Rust Coding con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Learn Rust Coding?

Non è richiesta alcuna esperienza precedente. Learn Rust Coding su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Extractor»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Learn Rust Coding?

Sì. Ogni lezione Learn Rust Coding include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Learn Rust Coding