axum

axum是一个专注于人体工程学和模块化的Web应用框架。

关于此crate的更多信息可以在crate文档中找到。

主要特性

使用无宏API将请求路由到处理程序。
使用提取器声明式解析请求。
简单且可预测的错误处理模型。
以最少的样板代码生成响应。
充分利用tower和tower-http生态系统的中间件、服务和实用工具。

特别是最后一点是axum区别于其他框架的地方。axum没有自己的中间件系统，而是使用tower::Service。这意味着axum可以免费获得超时、跟踪、压缩、授权等功能。它还使您能够与使用hyper或tonic编写的应用程序共享中间件。

使用示例

use axum::{
    routing::{get, post},
    http::StatusCode,
    Json, Router,
};
use serde::{Deserialize, Serialize};

#[tokio::main]
async fn main() {
    // 初始化跟踪
    tracing_subscriber::fmt::init();

    // 构建带有路由的应用程序
    let app = Router::new()
        // `GET /` 指向 `root`
        .route("/", get(root))
        // `POST /users` 指向 `create_user`
        .route("/users", post(create_user));

    // 使用hyper运行我们的应用，在全局3000端口上监听
    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
    axum::serve(listener, app).await.unwrap();
}

// 响应静态字符串的基本处理程序
async fn root() -> &'static str {
    "Hello, World!"
}

async fn create_user(
    // 这个参数告诉axum将请求体解析为
    // JSON格式的`CreateUser`类型
    Json(payload): Json<CreateUser>,
) -> (StatusCode, Json<User>) {
    // 在这里插入您的应用程序逻辑
    let user = User {
        id: 1337,
        username: payload.username,
    };

    // 这将被转换为JSON响应
    // 状态码为`201 Created`
    (StatusCode::CREATED, Json(user))
}

// 我们的`create_user`处理程序的输入
#[derive(Deserialize)]
struct CreateUser {
    username: String,
}

// 我们的`create_user`处理程序的输出
#[derive(Serialize)]
struct User {
    id: u64,
    username: String,
}