Rust

2025年07月11日更新 6 人订阅
原价: ¥ 2 限时优惠
专栏简介 Rust编程语言之错误处理 Rust 语言之 flod Rust编程语言之Cargo、Crates.io详解 Rust编程语言之枚举与模式匹配 Rust语言 - 接口设计的建议之受约束(Constrained) Rust编程语言之无畏并发 Rust语言 - 接口设计的建议之灵活(flexible) Rust语言 - 接口设计的建议之显而易见(Obvious) Rust语言 - 接口设计的建议之不意外(unsurprising) Rust 实战:构建实用的 CLI 工具 HTTPie Rust编程语言学习之高级特性 Rust内存管理揭秘:深度剖析指针与智能指针 解决Rust中数组和切片的编译时大小问题 《Rust编程之道》学习笔记一 Rust Async 异步编程 简易教程 使用 Async Rust 构建简单的 P2P 节点 Rust编程语言入门之模式匹配 Rust async 编程 Rust编程语言之编写自动化测试 Rust编程语言之函数式语言特性:迭代器和闭包 《Rust编程之道》学习笔记二 Rust Tips 比较数值 使用 Rust 开发一个微型游戏 Rust编程初探:深入理解Struct结构体 深入理解Rust中的内存管理:栈、堆与静态内存详解 深入理解 Rust 结构体:经典结构体、元组结构体和单元结构体的实现 深入掌握 Rust 结构体:从模板到实例化的完整指南 深入理解Rust中的结构体:逻辑与数据结合的实战示例 深入理解 Rust 枚举:从基础到实践 掌握Rust字符串的精髓:String与&str的最佳实践 全面解析 Rust 模块系统:实战案例与应用技巧 Rust 中的 HashMap 实战指南:理解与优化技巧 掌握Rust模式匹配:从基础语法到实际应用 Rust 中的面向对象编程:特性与实现指南 深入理解 Rust 的 Pin 和 Unpin:理论与实践解析 Rust Trait 与 Go Interface:从设计到实战的深度对比 从零开始:用 Rust 和 Axum 打造高效 Web 应用 Rust 错误处理详解:掌握 anyhow、thiserror 和 snafu Rust 如何优雅实现冒泡排序 链表倒数 K 节点怎么删?Python/Go/Rust 实战 用 Rust 玩转数据存储:JSON 文件持久化实战 Rust实战:打造高效字符串分割函数 如何高效学习一门技术:从知到行的飞轮效应 Rust 编程入门:Struct 让代码更优雅 Rust 编程:零基础入门高性能开发 用 Rust 写个猜数游戏,编程小白也能上手! Rust 入门教程:变量到数据类型,轻松掌握! 深入浅出 Rust:函数、控制流与所有权核心特性解析 从零开始:用 Rust 和 Axum 打造高效 Web 服务 Rust 集合类型解析:Vector、String、HashMap 深入浅出Rust:泛型、Trait与生命周期的硬核指南 Rust实战:博物馆门票限流系统设计与实现 用 Rust 打造高性能图片处理服务器:从零开始实现类似 Thumbor 的功能 Rust 编程入门实战:从零开始抓取网页并转换为 Markdown 深入浅出 Rust:高效处理二进制数据的 Bytes 与 BytesMut 实战 Rust智能指针:解锁内存管理的进阶之道 用 Rust 打造命令行利器:从零到一实现 mini-grep 解锁Rust代码组织:轻松掌握Package、Crate与Module Rust 所有权:从内存管理到生产力释放 深入解析 Rust 的面向对象编程:特性、实现与设计模式 Rust + Protobuf:从零打造高效键值存储项目 bacon 点燃 Rust:比 cargo-watch 更爽的开发体验 用 Rust 打造微型游戏:从零开始的 Flappy Dragon 开发之旅 函数式编程的Rust之旅:闭包与迭代器的深入解析与实践 探索Rust编程之道:从设计哲学到内存安全的学习笔记 精读《Rust编程之道》:吃透语言精要,彻底搞懂所有权与借用 Rust 避坑指南:搞定数值比较,别再让 0.1 + 0.2 != 0.3 困扰你! 告别 Vec!掌握 Rust bytes 库,解锁零拷贝的真正威力 告别竞态条件:基于 Axum 和 Serde 的 Rust 并发状态管理最佳实践 Rust 异步编程实践:从 Tokio 基础到阻塞任务处理模式 Rust 网络编程实战:用 Tokio 手写一个迷你 TCP 反向代理 (minginx) 保姆级教程:Zsh + Oh My Zsh 终极配置,让你的 Ubuntu 终端效率倍增 不止于后端:Rust 在 Web 开发中的崛起之路 (2024数据解读) Rust核心利器:枚举(Enum)与模式匹配(Match),告别空指针,写出优雅健壮的代码

从零开始:用 Rust 和 Axum 打造高效 Web 服务

从零开始:用Rust和Axum打造高效Web服务Rust以其卓越的性能和内存安全性席卷编程世界,成为现代Web开发的热门选择。Axum作为Rust生态中的轻量级Web框架,结合Tokio异步运行时的强大能力,让开发者能轻松构建高效、可靠的Web服务。无论你是R

从零开始:用 Rust 和 Axum 打造高效 Web 服务

Rust 以其卓越的性能和内存安全性席卷编程世界,成为现代 Web 开发的热门选择。Axum 作为 Rust 生态中的轻量级 Web 框架,结合 Tokio 异步运行时的强大能力,让开发者能轻松构建高效、可靠的 Web 服务。无论你是 Rust 新手,还是希望快速上手 Web 开发,这篇手把手教程将带你通过 rust-axum-intro 项目,从零开始搭建一个简单的 Web 服务器,并通过测试验证其功能。只需几行代码,你就能解锁 Rust 在 Web 开发中的无限可能!快来跟随我们,开启这场高效开发之旅吧!

本文通过 rust-axum-intro 项目,详细演示如何使用 Rust 和 Axum 框架快速构建一个监听 http://localhost:8080 的 Web 服务器,处理 /hello?name=xxx 端点的 GET 请求,动态生成个性化 HTML 问候页面。从项目初始化、依赖配置、核心代码实现到异步测试,文章完整呈现了开发全流程。核心代码利用 Axum 的路由和查询参数处理功能,结合 Tokio 异步运行时实现高效请求处理;测试代码通过 httpc-test 验证服务功能;cargo-watch 工具则优化了开发体验。适合 Rust 初学者和 Web 开发爱好者,本文提供清晰的实践指南,助你快速上手高性能 Web 服务开发!

实操

rust-axum-intro 项目实操

实操步骤

 2311  cd Code/rust
 2312  cargo new rust-axum-intro
 2313  cd rust-axum-intro
 2314  c
 2315* cargo add tokio --features full
 2316* cargo add axum
 2317* cargo run
 2318* touch tests/quick_dev.rs
 2319* mkdir tests
 2320* touch tests/quick_dev.rs
 2321  cargo watch -q -c -w src -x run
 2322  cargo install cargo-watch
 2323  cargo watch --version\n
 2324  cargo watch -q -c -w src -x run
 2325  cargo watch -q -c -w tests -x "test -q quick_dev -- --nocapture"
 2326* git add .
 2327* git commit -m "first commit"
 2328  cargo watch -q -c -w tests -x "test -q quick_dev -- --nocapture"
 2329* cd blog/qiaoblog

Cargo.toml 文件

[package]
name = "rust-axum-intro"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
axum = "0.6.20"
tokio = { version = "1.31.0", features = ["full"] }
serde ={ version =  "1.0.183", features = ["derive"]}
serde_json = "1.0.104"

[dev-dependencies]
anyhow = "1.0.73"
httpc-test = "0.1.5" # Uses reqwest & cookie store.

main.rs 代码实现

#![allow(unused)] // For beginning only.

use std::net::SocketAddr;

use axum::{
    extract::Query,
    response::{Html, IntoResponse},
    routing::get,
    Router,
};
use serde::Deserialize;

#[tokio::main]
async fn main() {
    let routes_hello = Router::new().route(
        "/hello",
        // get(|| async { Html("Hello <strong>World!!!</strong>") }),
        get(handler_hello),
    );

    // region:  --- Start Server
    let addr = SocketAddr::from(([127, 0, 0, 1], 8080));
    println!("->> LISTENING on {addr}\n");
    axum::Server::bind(&addr)
        .serve(routes_hello.into_make_service())
        .await
        .unwrap();
    // endregion:  --- Start Server
}

// region: --- Handler Hello
#[derive(Debug, Deserialize)]
struct HelloParams {
    name: Option<String>,
}

// e.g., `/hello?name=Qiao`
async fn handler_hello(Query(params): Query<HelloParams>) -> impl IntoResponse {
    println!("->> {:<12} - handler_hello - {params:?}", "HANDLER");

    let name = params.name.as_deref().unwrap_or("World");

    // Html("Hello <strong>World!!!</strong>")
    Html(format!("Hello <strong>{name}!!!</strong>"))
}
// endregion: --- Handler Hello

这段 Rust 代码使用 axum 框架构建了一个简单的 Web 服务器,监听 http://localhost:8080 并处理 /hello 端点的 GET 请求。#![allow(unused)] 忽略未使用代码的警告,便于开发初期。代码通过 use 语句引入必要模块,包括 std::net::SocketAddr 用于网络地址、axum 的路由和响应功能,以及 serde 的反序列化功能。在 main 函数中,使用 tokio::main 宏创建异步运行时,定义一个路由 /hello,绑定到 handler_hello 处理函数,并启动服务器监听 127.0.0.1:8080。handler_hello 函数处理 /hello?name=xxx 格式的请求,通过 Query<HelloParams> 提取查询参数 name,若无参数则默认使用 "World",返回格式化的 HTML 响应,如 Hello <strong>Qiao!!!</strong>。此代码实现了一个简单的 Web 服务,用于动态生成带有用户指定或默认名称的问候页面。

测试代码实现

#![allow(unused)] // For beginning only.

use anyhow::Result;

#[tokio::test]
async fn quick_dev() -> Result&lt;()> {
    let hc = httpc_test::new_client("http://localhost:8080")?;

    hc.do_get("/hello?name=Qiao").await?.print().await?;

    Ok(())
}

这段 Rust 代码是一个使用 tokio 框架编写的异步测试用例,用于验证 HTTP 客户端与本地服务器的交互。#![allow(unused)] 忽略未使用代码的警告,便于开发初期。use anyhow::Result 引入错误处理类型。#[tokio::test] 标记异步测试函数 quick_dev,它创建一个连接到 http://localhost:8080 的 HTTP 客户端(通过 httpc_test::new_client),向 /hello?name=Qiao 发送 GET 请求,异步等待响应并打印结果,最后返回 Ok(()) 表示成功。此代码用于快速测试本地服务器的 /hello 端点功能。

安装依赖并运行

cargo install cargo-watch
cargo watch -x run
cargo watch -q -c -x 'run -q'
cargo watch -q -c -x 'run -q --example hello'

总结

通过 rust-axum-intro 项目,我们从零开始搭建了一个高效的 Web 服务器,展示了 Rust 和 Axum 框架在 Web 开发中的强大能力。项目通过简洁的代码实现了动态路由处理,利用 Tokio 的异步运行时确保高效性能,并通过 httpc-test 测试验证了 /hello 端点的功能。Cargo.toml 配置了必要依赖,main.rs 和 quick_dev.rs 分别实现了服务逻辑和测试用例,而 cargo-watch 工具极大提升了开发效率。本教程为 Rust Web 开发的入门提供了实用模板,开发者可在此基础上扩展更多功能,如添加复杂路由或集成数据库。借助文中提供的参考资源,欢迎继续探索 Rust 的高性能世界,打造属于你的下一款 Web 应用!

参考

点赞 1
收藏 0
分享
本文参与登链社区写作激励计划 ,好文好收益,欢迎正在阅读的你也加入。

0 条评论

请先 登录 后评论