当前位置：首页 > news >正文

Rust Web 全栈开发（三）：使用 Actix 构建简单的 Web Service

news 2025/7/11 8:55:50

Rust Web 全栈开发（三）：使用 Actix 构建简单的 Web Service

Rust Web 全栈开发（三）：使用 Actix 构建简单的 Web Service
- 创建项目
- 配置依赖
- 编写路由并运行服务
- Actix 的基本组件
- Actix 的并发
- 尾声

Rust Web 全栈开发（三）：使用 Actix 构建简单的 Web Service

参考视频：https://www.bilibili.com/video/BV1RP4y1G7KF

需要使用的 crate：

actix-web
actix-rt

本文介绍了如何使用 Actix 进行 Web 开发，包括新建项目、配置依赖、编写路由并运行服务。Actix 的基本组件包括 HTTP Server、Route 和 Handler，其并发机制支持异步 I/O 和多线程并行，确保高效处理请求。

创建项目

新建一个 Rust 项目，修改其 Cargo.toml：

[workspace]

然后在终端执行 cargo new webservice，在目录下创建一个 webservice 成员包。

在工作区内运行 cargo new 会自动将新创建的包添加到工作区内 Cargo.toml 的 [workspace] 定义中的 members 键中，如下所示：

在这里插入图片描述

此时，我们可以通过运行 cargo build 来构建工作区。项目目录下的文件应该是这样的：

├── Cargo.lock
├── Cargo.toml
├── webservice
│   ├── Cargo.toml
│   └── src
│       └── main.rs
└── target

配置依赖

webservice 需要引用 actix 相关库，打开 webservice/Cargo.toml，在 [dependencies] 部分添加：

actix-web = "4.2.1"
actix-rt = "2.7.0"

编写路由并运行服务

bin 是二进制可执行 crate，编译出的文件为二进制可执行文件。必须要有 main 函数作为入口。这种 crate 不需要在 Cargo.toml 中或 --crate-type 命令行参数中指定，会自动识别。

打开 webservice/Cargo.toml，添加一个 bin 的声明：

[[bin]]
name = "server1"
# path = "src/bin/server1.rs"

接着在 webservice/src 目录下创建一个 bin 目录，再在 bin 目录下创建 server1.rs，编写代码：

use actix_web::{web, App, HttpResponse, HttpServer, Responder};
use std::io;// 配置 route
pub fn general_routes(cfg: &mut web::ServiceConfig) {cfg.route("/health", web::get().to(health_check_handler));
}// 配置 handler
pub async fn health_check_handler() -> impl Responder {HttpResponse::Ok().json("Actix Web Service is running!")
}// 实例化 HTTP server 并运行
#[actix_rt::main]
async fn main() -> io::Result<()> {// 构建 app，配置 routelet app = move || App::new().configure(general_routes);HttpServer::new(app).bind("localhost:3000")?.run().await
}