为初学者打造的 Axum 路由快速入门指南

2023-11-30 20:41:04

踏上 Axum 路由的探索之旅

在 Web 开发的广阔领域中，路由扮演着至关重要的角色，它负责将传入的 HTTP 请求引导到适当的处理程序。Axum，作为 Rust 编程语言中备受推崇的 Web 框架，提供了强大的路由机制，使开发者能够轻松地处理各种请求。

本文将带你踏上探索 Axum 路由的激动人心的旅程。我们将深入研究其匹配规则和路由对象，并通过一系列实用示例，展示如何灵活地将请求路径映射到处理程序。无论你是经验丰富的 Rustaceans，还是刚开始涉足 Web 开发的新手，本指南都会为你提供一个坚实的基础，让你能够构建响应式、可扩展的 Web 应用程序。

揭开 Axum 路由的神秘面纱

Axum 的路由主要分为两个组成部分：匹配规则和路由对象。匹配规则定义了请求路径应如何与处理程序匹配，而路由对象则封装了处理程序及其相关元数据。

匹配规则：为请求指明方向

匹配规则是路由的核心，它决定了哪些请求将被路由到特定的处理程序。Axum 提供了多种匹配规则，包括：

简单路径匹配： 匹配确切的请求路径，例如 /users。
通配符匹配： 使用 * 匹配任何路径段，例如 /users/*。
参数匹配： 使用 <param> 匹配路径中的特定参数，例如 /users/<user_id>。

路由对象：处理程序的容器

路由对象将处理程序及其相关元数据（例如匹配规则和中间件）组合在一起。Axum 提供了以下路由对象：

Router： 根路由对象，可用于组合其他路由对象。
Route： 单个路由对象，将匹配规则与处理程序关联起来。
SubRouter： 用于将一组路由对象分组到一个命名空间下的路由对象。

实战：构建你的第一个 Axum 路由

现在，让我们通过一个实际示例来深入了解 Axum 路由。以下代码片段展示了一个简单的路由，它将 / 请求路径映射到一个返回 "Hello, Axum!" 响应的处理程序：

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

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

fn main() {
    // 创建一个路由器
    let router = Router::new()
        // 添加一个 GET 路由
        .route("/", get(hello))
        // 添加一个 POST 路由
        .route("/post", post(hello));

    // 启动 HTTP 服务器
    axum::Server::bind(&"0.0.0.0:3000").serve(router).await.unwrap();
}