RustInPractice（22）：用 Axum 写 JSON API

发表于2026-07-23|更新于2026-07-20|RustInPractice

|浏览量:

Axum 将路由、提取器和返回值组合成类型安全的 HTTP API。demo 用 Router、Json 和共享状态完成一个最小用户接口。

对应 networking/http_json。下一篇：WebSocket 与异步流。

路由与提取器

1
2
3

Router::new()
    .route("/users", get(list_users).post(create_user))
    .route("/users/:id", get(get_user))

State(store) 取得应用状态，Path(id) 解析路径参数，Json(body) 反序列化请求体。handler 返回 Json<T>，Serde 负责序列化。

状态与错误

demo 用 Arc<Mutex<HashMap<...>>> 保存内存数据，锁只在同步读取或写入期间持有，绝不能跨 .await。真实 API 应增加输入验证、201 Created、结构化错误体、稳定排序和 handler 集成测试。

这个 store 会在重启后丢失，ID 生成也只适用于单进程 demo；它是路由学习材料，不是数据库设计。

小结

Router 描述端点，extractor 让输入类型化。
应用状态应小、可同步，锁范围必须短。
对外响应和内部错误日志需分层，不能泄露私有数据。

下一篇：WebSocket 与异步流。

文章作者: WALL-E-2000

文章链接: http://shiguol.github.io/2026/07/23/RustInPractice-22-Axum-JSON-API/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 WALL-E's Blog！

编程 2026 Rust Axum HTTP JSON

相关推荐

现代 C++ 实战（24）：HTTP 服务与 JSON

第 23 篇收官第三季算法篇；第四季进入工程实战。第一篇从最常见的后端能力入手：用 cpp-httplib 搭 HTTP 服务，用 nlohmann/json 处理 JSON——几十行代码就能跑起一个 REST 接口。 demo：ref/cpp_demo/networking/http_json/。这是「现代 C++ 实战」系列的第 24 篇，第四季开篇。建议先读第 01 篇：CMake 与现代构建（FetchContent）和第 23 篇。一、HTTP 基础速览1234567客户端服务端 │ GET /camera HTTP/1.1 │ │ Host: localhost:8080 ────────→ │ 路由匹配 → 处理 → 响应 │ │ │ ← HTTP/1.1 200 OK │ │ Content-Type: image/jpe...

RustInPractice（11）：Box、Drop 与递归数据结构

Box<T> 常被误解为“Rust 的手动堆内存”。实际上它仍然是普通拥有者：它拥有 T，离开作用域时自动释放 T。Box 的价值在于把值放到堆上，或让递归类型拥有一个编译期确定的大小。这是 RustInPractice 的第 11 篇。对应 demo：box_demo、tree、stack_queue_list。下一篇讲共享所有权 Rc、Arc 与 Weak。一、Box<T> 仍是唯一所有权12let number = Box::new(42);println!("{number}"); Box<T> 自身通常在栈上，内部指针指向堆上的 T。它不可隐式复制，移动 Box 就是移动唯一所有权。绝大多数场景不需要显式调用释放函数：作用域结束时自动执行 Drop。二、Drop 统一管理各种资源demo 的 Resource 实现 Drop： 12345impl Drop for Resource { fn drop(&mut self) { pr...

RustInPractice（25）：数据结构与所有权边界

手写数据结构的最大收获不是替代标准库，而是看清所有权如何塑造节点关系。链表和 BST 用 Option<Box<Node>> 表达唯一递归所有权；图用邻接表表达多个边关系。对应 stack_queue_list、tree、graph、hash_table。 BST 插入的关键是沿着唯一的可变路径递归： 1fn insert(root: &mut Option<Box<TreeNode>>, value: i32) { /* ... */ } 图的 BFS 使用 VecDeque 队列，DFS 用 visited set 防环。自定义 HashMap 使用链地址法展示碰撞，但没有 resize/remove，不能替代标准库。选择原则：业务优先标准集合；自定义结构只在需求、学习或性能测量证明需要时出现。下一篇：排序与字符串搜索。

现代 C++ 实战（26）：LRU 缓存与 JSON 解析器

第 25 篇给服务加了持久化；本篇是两个经典练手项目：LRU 缓存练数据结构设计，JSON 解析器练递归下降与 std::variant——都是面试高频、又能深入理解 C++ 现代特性。 demo：ref/cpp_demo/projects/learning_guide/（lru_cache/ + json_parser/）。这是「现代 C++ 实战」系列的第 26 篇。建议先读第 20 篇：栈、队列与链表（LRU 底层）和第 24 篇：HTTP 服务与 JSON（nlohmann/json）。一、LRU 缓存：设计思路LRU（Least Recently Used）——缓存满时淘汰最久未使用的项。要求 get 和 put 均 O(1)。 123456unordered_map<K, iterator> list<pair<K,V>>┌─────────────────┐ ┌──────────────────────┐│ key1 → iter1 ───┼─────────>│ (k...

RustInPractice（26）：排序与字符串搜索

排序 demo 用 &mut [i32] 直接操作切片，搜索 demo 用字节序列实现朴素匹配与 KMP。它们适合理解复杂度，生产代码仍应优先标准库。对应 sorting、string_search。下一篇：动态规划与系列收官。冒泡和插入排序是 O(n²)，快速排序平均 O(n log n)，但最后元素 pivot 对已排序输入会退化并导致深递归。默认应使用 sort_unstable()，除非需要稳定排序。 KMP 的 LPS 表让失配后不必回退 haystack，因此复杂度为 O(m+n)。当前实现按 UTF-8 字节搜索，返回字节偏移；非 ASCII 文本不能把该值当字符索引或随意切片。测试必须覆盖空 slice、单元素、重复值、空 pattern 和 Unicode 边界。下一篇：动态规划与 RustInPractice 主线回顾。

RustInPractice（23）：WebSocket 与异步流

WebSocket 在 HTTP upgrade 后保持双向消息通道。tokio-tungstenite 将连接同时实现 Stream 与 Sink，接收用 next().await，发送用 send().await。对应 networking/websocket。下一篇：SQLite。 1234while let Some(message) = ws.next().await { let message = message?; ws.send(Message::Text("Echo: hello".into())).await?;} 服务端通常为每条连接 spawn 一个 task，连接结束后 task 自动结束。需要显式处理 text、binary、ping、pong、close 和错误；demo 将 binary 转成文本提示，因此它是文本 echo，不是保留二进制 payload 的 echo 服务。 accept 循环也不应静默吞掉 listener 错误。生产服务还需要连接上限、超时、认证和关闭协议。 ...