Learn Rust Coding · Lezione

Middleware

Layer di Tower

Middleware è una lezione Learn Rust Coding gratuita su CoddyKit. Questa è la lezione 4 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'è il middleware?

Il middleware esegue codice prima e dopo un handler, avvolgendo il ciclo richiesta/risposta. Lo usi per logging, autenticazione, compressione e timeout.

Axum si basa sull'ecosistema tower
Il middleware viene aggiunto come layer

Il trait Service

Tower definisce un Service: qualcosa che riceve una richiesta e produce asincronamente una risposta. I layer avvolgono un service dentro un altro.

Aggiungere un layer

Colleghi il middleware con .layer(). Qui aggiungiamo il tracing delle richieste da tower_http.

use axum::{Router, routing::get};
use tower_http::trace::TraceLayer;

fn app() -> Router {
    Router::new()
        .route("/", get(|| async { "ok" }))
        .layer(TraceLayer::new_for_http())
}

Ordine dei layer

I layer avvolgono dal basso verso l'alto: l'ultimo layer aggiunto è quello più esterno. Le richieste vanno dall'esterno verso l'interno, mentre le risposte seguono il percorso inverso.

use axum::{Router, routing::get};
use tower_http::{trace::TraceLayer, compression::CompressionLayer};

fn app() -> Router {
    Router::new()
        .route("/", get(|| async { "ok" }))
        .layer(CompressionLayer::new())
        .layer(TraceLayer::new_for_http())
}

Middleware personalizzato con from_fn

middleware::from_fn trasforma una funzione asincrona in middleware. Riceve la richiesta e un Next da chiamare per proseguire il resto della catena.

use axum::{middleware::Next, response::Response, extract::Request};

async fn log_mw(req: Request, next: Next) -> Response {
    println!("{} {}", req.method(), req.uri());
    next.run(req).await
}

Collegare un middleware personalizzato

Racchiuda la funzione con from_fn e la aggiunga come layer.

use axum::{Router, routing::get, middleware};

fn app() -> Router {
    Router::new()
        .route("/", get(|| async { "ok" }))
        .layer(middleware::from_fn(log_mw))
}

Interrompere anticipatamente le richieste

Il middleware può restituire una risposta senza chiamare next, cosa utile per l'autenticazione. Restituire una risposta interrompe la catena.

use axum::{middleware::Next, response::Response, extract::Request, http::StatusCode};

async fn auth(req: Request, next: Next) -> Result<Response, StatusCode> {
    if req.headers().contains_key("authorization") {
        Ok(next.run(req).await)
    } else {
        Err(StatusCode::UNAUTHORIZED)
    }
}

Modellare una catena di middleware

Una catena è semplicemente costituita da funzioni che chiamano quella successiva. Questo esempio eseguibile modella l'avvolgimento prima/dopo.

fn handler() -> String {
    "response".to_string()
}

fn logging<F: Fn() -> String>(next: F) -> String {
    println!("-> request in");
    let res = next();
    println!("<- response out");
    res
}

fn main() {
    let out = logging(handler);
    println!("body: {}", out);
}

Middleware per singola route

Applichi un layer a una sola route chiamando .layer() sul router del metodo invece che sull'intera app.

use axum::{Router, routing::get, middleware};

fn app() -> Router {
    Router::new().route(
        "/admin",
        get(|| async { "admin" }).layer(middleware::from_fn(auth)),
    )
}

Layer comuni di tower_http

Il crate tower_http include middleware già pronti:

TraceLayer per il logging
CompressionLayer per gzip
CorsLayer per CORS
TimeoutLayer per limitare la durata delle richieste

use tower_http::cors::CorsLayer;

fn cors() -> CorsLayer {
    CorsLayer::permissive()
}

Comporre layer con ServiceBuilder

Raggruppi più layer in modo ordinato con ServiceBuilder, che li applica dall'alto verso il basso per mantenere un ordine prevedibile.

use tower::ServiceBuilder;
use tower_http::{trace::TraceLayer, compression::CompressionLayer};

fn stack() -> ServiceBuilder<impl Sized> {
    ServiceBuilder::new()
        .layer(TraceLayer::new_for_http())
        .layer(CompressionLayer::new())
}

Verifica rapida

Verifichi la Sua comprensione del middleware.

Riepilogo

Ha imparato a usare il middleware con i layer di tower:

Aggiunga il middleware con .layer(); l'ultimo aggiunto è quello più esterno
from_fn crea middleware personalizzati usando Next
Restituisca il risultato in anticipo per interrompere la catena, ad esempio per l'autenticazione
tower_http offre layer per il tracing, la compressione, CORS e i timeout

Ha completato il corso su Axum.

Domande Frequenti

La lezione «Middleware» è gratuita?

Sì — il testo completo di «Middleware» è 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 «Middleware»?

Layer di Tower 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 4 di 4.

Quanto tempo richiede la lezione «Middleware»?

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