⬅ 上一课🏠 目录下一课 ➡
实战项目

第30课：Web框架

🎯 本课目标

掌握用Axum构建完整Web应用：路由、中间件、模板、认证和部署。

1. 完整Web应用结构

use axum::{Router, routing::{get, post}, extract::{State, Path}, Json, http::StatusCode};
use std::sync::Arc;
use tokio::sync::RwLock;
use serde::{Serialize, Deserialize};

type AppState = Arc<RwLock<AppData>>;

struct AppData {
    users: Vec<User>,
}

#[derive(Clone, Serialize, Deserialize)]
struct User { id: u32, name: String, email: String }

fn app(state: AppState) -> Router {
    Router::new()
        .route("/", get(index))
        .route("/users", get(list_users))
        .route("/users", post(create_user))
        .route("/users/:id", get(get_user))
        .with_state(state)
}

async fn index() -> &str { "Welcome!" }
async fn list_users(
    State(state): State<AppState>,
) -> Json<Vec<User>> {
    let data = state.read().await;
    Json(data.users.clone())
}

async fn create_user(
    State(state): State<AppState>,
    Json(input): Json<User>,
) -> Json<User> {
    let mut data = state.write().await;
    let id = data.users.len() as u32 + 1;
    let user = User { id, ..input };
    data.users.push(user.clone());
    Json(user)
}

async fn get_user(
    State(state): State<AppState>,
    Path(id): Path<u32>,
) -> Result<Json<User>, StatusCode> {
    let data = state.read().await;
    data.users.iter()
        .find(|u| u.id == id)
        .cloned()
        .map(Json)
        .ok_or(StatusCode::NOT_FOUND)
}

✅ 编译验证通过

2. 中间件层

use tower::ServiceBuilder;
use tower_http::{trace::TraceLayer, cors::CorsLayer};

let app = Router::new()
    .route("/api", get(api_handler))
    .layer(
        ServiceBuilder::new()
            .layer(TraceLayer::new_for_http())
            .layer(CorsLayer::permissive())
    );

3. 项目结构

webapp/
├── src/
│   ├── main.rs
│   ├── routes/
│   │   ├── mod.rs
│   │   ├── users.rs
│   │   └── auth.rs
│   ├── models/
│   ├── handlers/
│   ├── middleware/
│   └── db/
├── migrations/
├── static/
├── templates/
└── Cargo.toml

4. 部署

// Dockerfile
FROM rust:1.95 AS builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM debian:bookworm-slim
COPY --from=builder /app/target/release/webapp /usr/local/bin/
EXPOSE 3000
CMD ["webapp"]

📝 练习题

练习1：博客系统

实现博客的CRUD + 用户认证。

练习2：API文档

集成utoipa生成OpenAPI文档。

练习3：Docker部署

用多阶段构建打包部署。

🏆

成就解锁：全栈Rustacean

掌握Web框架——从数据库到前端

⬅ 上一课🏠 目录下一课 ➡

🔬 深度理解：Rust工程实践

从学习到生产的桥梁——工程实践的关键要素：

1. 项目组织

Rust项目遵循workspace模式：核心逻辑在lib crate，二进制在bin crate，测试在独立目录。这确保了可测试性和可复用性。

2. 错误处理策略

库代码用Result传播错误，应用层用anyhow简化处理，CLI用自定义错误类型提供友好信息。

3. 配置管理

用serde解析配置文件，环境变量覆盖，合理默认值。十二因素应用方法论。

📊 Rust生产案例

公司/项目用途效果
Cloudflare边缘计算无GC停顿
Discord消息服务延迟降低40倍
Dropbox文件同步替代Go/Python
Linux内核驱动开发内存安全驱动
AmazonFirecracker VM125μs启动
MicrosoftWindows内核安全改进

🚀 进阶方向

完成本课程后，你可以选择以下进阶方向：

🧪 实战练习补充

以下练习帮助你将本课知识应用到实际场景：

练习A：代码审查

阅读以下代码片段，找出潜在问题并改进：

// 仔细阅读，思考有什么问题
fn process(data: Vec) -> Vec {
    let mut result = Vec::new();
    for i in 0..data.len() {
        result.push(data[i] * 2);
    }
    result
}

改进建议：使用迭代器、预分配容量、考虑溢出。

练习B：性能对比

用criterion基准测试对比以下实现的性能差异：

练习C：API设计

为以下场景设计Rust API：一个支持过期时间的缓存系统。考虑所有权、错误处理和泛型。

📌 本课要点总结

通过本课的学习，你应该掌握以下核心要点：

  1. 理解Rust核心概念背后的设计哲学
  2. 能够将所学知识应用到实际编码中
  3. 知道何时选择哪种工具和模式
  4. 具备阅读和审查Rust代码的能力
  5. 能够独立解决编译器报告的问题

如果某个要点还不够清晰，回顾本课的代码示例和内存图，动手编写代码验证你的理解。

🔗 相关资源

🎯 实战挑战

挑战自己：在不查看参考答案的情况下完成以下任务：

初级

用本课学到的知识，实现一个简单的功能模块。确保代码编译通过、有测试、有文档注释。

中级

将你的模块重构为更通用的版本，使用泛型和trait。添加错误处理。

高级

为你的模块实现并发安全版本，使用Arc+Mutex或channel。编写基准测试对比性能。

📚 扩展阅读

以下资源帮助你深入学习本课主题：

🔑 关键术语回顾

本课涉及的核心概念，确保你理解每一个：

术语说明
所有权Rust内存管理的核心机制，每个值有唯一所有者
借用通过引用访问数据，不获取所有权
生命周期引用有效的范围，编译期分析工具
traitRust的接口/抽象机制，类似其他语言的接口
泛型参数化类型，零成本抽象
模式匹配强大的数据解构和分支机制
零成本抽象高层抽象不引入运行时开销
fearless concurrency编译器保证线程安全

💬 学习建议

  1. 动手编码 — 每个代码示例都在本地运行一遍
  2. 修改实验 — 故意改错代码，看编译器报什么错
  3. 完成练习 — 每课的练习题是巩固知识的关键
  4. 阅读源码 — 看标准库和优秀开源项目的实现
  5. 写项目 — 真正掌握需要构建真实项目

🤔 常见问题

Q: Rust学习曲线真的很陡吗？

A: 前期确实需要适应所有权和借用检查器，但一旦理解了，这些概念会让你的代码更可靠。大多数人2-4周就能上手。

Q: Rust适合什么项目？

A: 系统编程、Web服务、CLI工具、嵌入式、WASM、网络服务、数据库等。基本上需要性能和安全的地方都适合。

Q: 遇到编译错误怎么办？

A: Rust编译器的错误信息非常友好！仔细阅读，通常会指出问题所在和修复建议。也可以用cargo clippy获取更多提示。