Learn Rust Coding · Lekcja

Middleware

Warstwy Tower

Middleware to bezpłatna lekcja Learn Rust Coding na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Learn Rust Coding, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Learn Rust Coding zawiera 4 lekcji w sumie.

Czym jest middleware?

Middleware wykonuje kod przed i po obsłużeniu żądania, opakowując cykl żądanie/odpowiedź. Należy go używać do logowania, uwierzytelniania, kompresji i limitów czasu.

Axum bazuje na ekosystemie tower
Middleware dodaje się jako warstwy

Trait Service

Tower definiuje Service: element, który przyjmuje żądanie i asynchronicznie tworzy odpowiedź. Warstwy opakowują jeden serwis w kolejny.

Dodawanie warstwy

Middleware dołącza się za pomocą .layer(). W tym przykładzie dodajemy śledzenie żądań z 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())
}

Kolejność warstw

Warstwy są nakładane od dołu: ostatnia dodana warstwa jest najbardziej zewnętrzna. Żądania przepływają z zewnątrz do wewnątrz, a odpowiedzi z wewnątrz na zewnątrz.

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())
}

Niestandardowy middleware za pomocą from_fn

middleware::from_fn przekształca funkcję asynchroniczną w middleware. Otrzymuje ona żądanie oraz Next, które należy wywołać, aby kontynuować łańcuch.

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
}

Podłączanie niestandardowego middleware

Należy opakować funkcję za pomocą from_fn i dodać ją jako warstwę.

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

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

Przerywanie obsługi żądań

Middleware może wcześniej zwrócić wynik bez wywoływania next, co jest przydatne na przykład podczas uwierzytelniania. Zwrócenie odpowiedzi zatrzymuje łańcuch.

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)
    }
}

Modelowanie łańcucha middleware

Łańcuch to po prostu funkcje wywołujące kolejną funkcję. Ten uruchamialny przykład modeluje opakowanie wykonywane przed obsługą i po niej.

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 dla pojedynczej trasy

Warstwę można zastosować do pojedynczej trasy, wywołując .layer() na routerze metody zamiast na całej aplikacji.

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

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

Typowe warstwy tower_http

Crate tower_http zawiera gotowe elementy middleware:

TraceLayer do logowania
CompressionLayer do kompresji gzip
CorsLayer do obsługi CORS
TimeoutLayer do ograniczania czasu obsługi żądania

use tower_http::cors::CorsLayer;

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

Łączenie warstw za pomocą ServiceBuilder

Wiele warstw można przejrzyście połączyć za pomocą ServiceBuilder, który stosuje je od góry do dołu, zapewniając przewidywalną kolejność.

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())
}

Szybki test

Sprawdź swoją wiedzę na temat middleware.

Podsumowanie

Nauczyłeś się korzystać z middleware i warstw tower:

Middleware dodaje się za pomocą .layer(); ostatnia dodana warstwa jest najbardziej zewnętrzna
from_fn tworzy niestandardowy middleware z użyciem Next
Wcześniejszy zwrot pozwala przerwać łańcuch, na przykład podczas uwierzytelniania
tower_http oferuje warstwy do śledzenia, kompresji, CORS i limitów czasu

To kończy kurs Axum.

Często zadawane pytania

Czy lekcja „Middleware” jest bezpłatna?

Tak — pełny tekst „Middleware” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Learn Rust Coding, przejdź na CoddyKit PRO. Kurs Learn Rust Coding zawiera 4 lekcji w sumie.

Co nauczysz się w „Middleware”?

Warstwy Tower Ćwiczysz Learn Rust Coding z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Learn Rust Coding?

Nie wymagamy żadnego doświadczenia. Learn Rust Coding w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Middleware”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Learn Rust Coding?

Tak. Każda lekcja Learn Rust Coding zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Learn Rust Coding