Axum 框架教程

Axum 框架教程

axumErgonomic and modular web framework built with Tokio, Tower, and Hyper项目地址:https://gitcode.com/gh_mirrors/ax/axum

项目介绍

Axum 是一个基于 Rust 的 Web 应用框架，专注于易用性和模块化。它利用了 Tokio 运行时和 Hyper 库，提供了宏自由的 API 来路由请求和解析请求。Axum 不自己实现中间件系统，而是使用 tower::Service，这使得 Axum 能够免费获得超时、追踪、压缩、授权等功能，并且可以与使用 Hyper 或 Tonic 编写的应用程序共享中间件。

项目快速启动

安装依赖

首先，确保你已经安装了 Rust 和 Cargo。然后，在你的项目目录中添加以下依赖到 Cargo.toml 文件：

[dependencies]
axum = "<latest-version>"
tokio = { version = "<latest-version>", features = ["full"] }

创建一个简单的 "Hello World" 应用

在你的项目目录中创建一个 main.rs 文件，并添加以下代码：

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

#[tokio::main]
async fn main() {
    // 构建我们的应用，包含一个路由
    let app = Router::new().route("/", get(|| async { "Hello, World!" }));

    // 使用 Hyper 运行我们的应用，监听全局端口
    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

运行应用

在终端中运行以下命令来启动你的应用：

cargo run

打开浏览器并访问 http://localhost:3000，你应该会看到 "Hello, World!" 的响应。

应用案例和最佳实践

使用状态和提取器

Axum 提供了强大的提取器功能，可以方便地从请求中提取数据。以下是一个使用状态和 JSON 提取器的示例：

use axum::{extract::{Json, State}, Router};
use std::sync::Arc;

struct AppState {
    // 你的应用状态
}

#[derive(serde::Deserialize)]
struct CreateUserPayload {
    name: String,
    email: String,
}

async fn create_user(Json(payload): Json<CreateUserPayload>, State(state): State<Arc<AppState>>) {
    // 处理创建用户的逻辑
}

#[tokio::main]
async fn main() {
    let state = Arc::new(AppState { /* 初始化状态 */ });

    let app = Router::new()
        .route("/users", axum::routing::post(create_user))
        .with_state(state);

    axum::Server::bind(&"0.0.0.0:3000".parse().unwrap())
        .serve(app.into_make_service())
        .await
        .unwrap();
}

典型生态项目

Axum 生态系统包括许多社区维护的中间件和服务。以下是一些典型的生态项目：

• tower-http: 提供了一系列 HTTP 相关的中间件，如超时、压缩、授权等。
• multer: 一个用于处理 multipart/form-data 的库，常用于文件上传。
• serde: 一个强大的序列化和反序列化库，用于处理 JSON 数据。

这些项目可以与 Axum 无缝集成，帮助你构建功能丰富的 Web 应用。

axumErgonomic and modular web framework built with Tokio, Tower, and Hyper项目地址:https://gitcode.com/gh_mirrors/ax/axum