路由

handler 是什么

通常理解，handler 是指接收用户的请求，并将处理结果作为响应返回给用用户的函数。

它的返回值是什么

正如《axum 中的各种响应》所说，在 axum 中，所有实现了 IntoResponse 的数据类型都可以作为 handler 的返回值。

常用的请求方式

上表节选自《HTTP 请求方法》，更多请求方法，请参照原文。

在 axum 中，axum::routing 重新导出了 HTTP 请求方式的对应函数。也就是说，使用axum::routing::get() 来定义一个 GET 请求的路由。

链式操作

axum 的路由支持链式操作。假设以下场景：在编辑某用户信息时，首先要使用表单显示用户当前的信息(GET)，修改完成之后，还要将这个表单数据发送到服务器(POST)。在这个过程中，路由的 URL 是一样的。

由于还未学习到模板的相关内容，本例我们用直接书写 HTML 来作演示。你也可以看一下《axum 中使用模板引擎》

定义相关的 struct：

/// 通过表单提交数据
#[derive(Deserialize)]
pub struct EditUser {
    pub id: i32,
    pub username: String,
    pub email: String,
}

/// 对应数据库的模型
pub struct UserModel {
    pub id: i32,
    pub username: String,
    pub email: String,
}

定义 handler：

定义路由：

route("/edit_user/:id", get(edit_user).post(edit_user_action))

嵌套路由

为了方便进路由进行分组，axum 提供了嵌套路由功能。比如有以下路由：

定义 handlers：

async fn news_index() -> &'static str {
    "new index"
}
async fn news_detail(Path(id): Path<i32>) -> String {
    format!("new detail {}", id)
}
async fn news_comments(Path(id): Path<i32>) -> String {
    format!("new comments {}", id)
}

定义子路由：

let news_router = Router::new()
        .route("/", get(news_index))
        .route("/detail/:id", get(news_detail))
        .route("/comments/:id", get(news_comments));

将子路由嵌到全局路由：

本章讲解了 axum 路由功能。代码可以在代码仓库中找到。

思考题：

提示：

1. 使用 (StatusCode, HeaderMap, ()) 响应
2. 对应的状态码可查阅这里
3. 对应的 Header 可查阅这里

参考答案：

async fn redirect() -> (StatusCode, HeaderMap, ()) {
    let mut headers = HeaderMap::new();
    headers.insert(
        axum::http::header::LOCATION,
        "https://axum.rs".parse().unwrap(),
    );
    (StatusCode::FOUND, headers, ())
}