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

Rust Web 全栈开发(三):使用 Actix 构建简单的 Web Service

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
}

依旧是我们熟悉的 main -> route -> handler 的调用顺序。

在终端执行命令 cargo run -p webservice --bin server1,指定执行 webservice 库中的 server1。

或者 cd 到 webservice 目录,执行命令 cargo run --bin server1。

打开浏览器,访问 localhost:3000/health,可以看出程序运行成功:

在这里插入图片描述

Actix 的基本组件

Actix HTTP Server 实现了 HTTP 协议,默认情况下,它开启多个线程来处理来自互联网的请求。

在这里插入图片描述

接收到客户端的请求后,Actix HTTP Server 将其转发给 Actix App 内的对应路由,路由再将请求发给对应的 Handler 进行处理,处理完响应之后,将响应传回客户端。

Actix 的并发

Actix 支持两类并发:

  1. 异步 I/O:给定的 OS 原生线程在等待 I/O 时执行其他任务。
  2. 多线程并行:默认情况下启动 OS 原生线程的数量与系统逻辑 CPU 数量相同。

尾声

按 视频教程 的 Actix 相关库的版本

actix-web = "3"
actix-rt = "1.1.1"

会出现空指针解引用的错误,程序不能正常执行。

这里给出原版教程的官方源码地址:

https://github.com/peshwar9/rust-servers-services-apps/tree/master

后续如果还出现这种情况,建议对比源码看看。

http://www.dtcms.com/a/272704.html

相关文章:

  • 【解决方案】基于 Amazon CloudFormation 打造三层 Web 应用架构实战
  • GitHub信息收集
  • 如何利用个人电脑搭建FTP文件服务器实现远程协作
  • 第二章-AIGC入门-AI视频生成:几款实用AI视频生成工具全解析(7/36)
  • 精准估算如何选?功能点与故事点估算法全解析
  • Navicat实现MySQL数据传输与同步完整指南
  • 【Axure教程】中继器间图片的传递
  • Meta新注意力机制给 Transformer 升了级!底层架构的革命!
  • JAVA JVM对象的创建
  • 水陆联防智能升级:AI入侵检测系统守护零死角安全
  • 介绍 cnpm exec electron-packager
  • x86汇编语言入门基础(三)汇编指令篇3 位移运算
  • 【threejs】第一人称视角之八叉树碰撞检测
  • 蜻蜓I即时通讯系统重构宣言:破茧重生的技术革命-长痛不如短痛卓伊凡|麻子|果果
  • 大健康IP如何借“合规创新”抢占行业新风口|创客匠人
  • 解读 Go 中的 constraints包
  • 【TCP/IP】7. IP 路由
  • xml 知识总结: xsd,xsi:schemaLocation,xmlns,xmlns:xsi
  • SpringBoot系列—MyBatis(xml使用)
  • codeforeces Round1032 - Round 1036
  • 【node后端】搭建项目(Express+Ts+Typeorm+Mysql一步到位)
  • 深入浅出 Python Asynchronous I/O:从 asyncio 入门到实战
  • Arc Institute提出首个AIVC虚拟细胞模型STATE
  • 上海交大医学院张维拓老师赴同济医院做R语言训练营培训
  • 从Debug中学习MiniGPT4
  • 在Vue中如何对组件进行销毁在进行挂载
  • 模型训练之数据标注-Labelme的使用教程
  • 5款工具高效制作插图,PPT设计新选择!
  • 货车车架和悬架设计cad【7张】+设计说明书
  • leetcode 3440. 重新安排会议得到最多空余时间 II 中等