Learn Rust Coding · Урок

Маршрутизация Axum

Обработчики и маршруты

«Маршрутизация Axum» — бесплатный урок Learn Rust Coding на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Learn Rust Coding, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Learn Rust Coding содержит 4 уроков всего.

Что такое Axum?

Axum — удобный асинхронный веб-фреймворк от команды Tokio. Он построен на основе tower и hyper.

Обработчики являются обычными асинхронными функциями
Маршрутизация определяется типами и допускает композицию
Работает в среде выполнения Tokio

Обработчик — это функция

Обработчик Axum — это асинхронная функция, возвращающая значение, которое можно преобразовать в ответ, например &str или String.

async fn hello() -> &'static str {
    "Hello, world!"
}

Создание Router

Router сопоставляет пути с обработчиками. Используйте route вместе с фильтром HTTP-метода, например get.

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

async fn hello() -> &'static str { "Hello" }

fn app() -> Router {
    Router::new().route("/", get(hello))
}

Запуск сервера

Привяжите TCP-слушатель и запустите маршрутизатор. Макрос #[tokio::main] настраивает асинхронную среду выполнения.

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

#[tokio::main]
async fn main() {
    let app = Router::new().route("/", get(|| async { "Hi" }));
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
    axum::serve(listener, app).await.unwrap();
}

Несколько маршрутов

Объединяйте вызовы route в цепочку, чтобы зарегистрировать несколько конечных точек в одном маршрутизаторе.

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

fn app() -> Router {
    Router::new()
        .route("/", get(|| async { "home" }))
        .route("/about", get(|| async { "about" }))
}

Разные HTTP-методы

Объединяйте обработчики методов для одного пути с помощью get(...).post(...). Каждый метод направляется к собственному обработчику.

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

fn app() -> Router {
    Router::new().route(
        "/items",
        get(|| async { "list" }).post(|| async { "create" }),
    )
}

Параметры пути

Извлекайте части URL с помощью сегмента {name} и считывайте их через извлекатель Path.

use axum::extract::Path;

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

Моделирование маршрутизации на обычном Rust

В основе маршрутизация сопоставляет путь с ответом. Эта исполняемая модель передаёт эту идею без фреймворка.

fn route(path: &str) -> &str {
    match path {
        "/" => "home",
        "/about" => "about page",
        _ => "404 not found",
    }
}

fn main() {
    println!("{}", route("/"));
    println!("{}", route("/about"));
    println!("{}", route("/missing"));
}

Вложение маршрутизаторов

Составляйте более крупные приложения, подключая дочерний маршрутизатор по префиксу с помощью nest.

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

fn api() -> Router {
    Router::new().route("/users", get(|| async { "users" }))
}

fn app() -> Router {
    Router::new().nest("/api", api())
}

Резервный обработчик

Определите поведение для несопоставленных маршрутов с помощью fallback. Это идеально подходит для пользовательских страниц 404.

use axum::{Router, http::StatusCode};

async fn not_found() -> (StatusCode, &'static str) {
    (StatusCode::NOT_FOUND, "nothing here")
}

fn app() -> Router {
    Router::new().fallback(not_found)
}

Возврат кодов состояния

Обработчик может возвращать кортеж (StatusCode, body), чтобы точно управлять статусом ответа.

use axum::http::StatusCode;

async fn create() -> (StatusCode, &'static str) {
    (StatusCode::CREATED, "created")
}

Быстрая проверка

Проверьте, насколько хорошо Вы усвоили маршрутизацию Axum.

Повторение

Вы изучили основы маршрутизации Axum:

Обработчики являются асинхронными функциями, возвращающими ответ
Router::new().route(path, get(handler)) регистрирует конечные точки
Path извлекает сегменты URL
nest, fallback и кортежи со статусом формируют приложение

Далее: извлекатели разбирают входящие запросы.

Часто задаваемые вопросы

Урок «Маршрутизация Axum» бесплатный?

Да — полный текст урока «Маршрутизация Axum» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Learn Rust Coding, подпишись на CoddyKit PRO. Курс Learn Rust Coding содержит 4 уроков всего.

Чему я научусь в уроке «Маршрутизация Axum»?

Обработчики и маршруты Ты практикуешь Learn Rust Coding с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Learn Rust Coding?

Предыдущий опыт не требуется. Learn Rust Coding на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Маршрутизация Axum»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Learn Rust Coding?

Да. Каждый урок Learn Rust Coding включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Learn Rust Coding