概览

一个功能增大,实用的并且非常快的Rust web框架

类型安全
忘记字符串对象,从请求到响应,一切都有类型.
丰富特性
Actix 提供很多开箱即用的特性.HTTP/2,logging,等
可扩展
非常容易创建你自己类库,任何Actix 应用都可以使用.
非常快
Actix 非常快.不需要用语言来说 – 你自己来看.

use actix_web::{web, App, HttpRequest, HttpServer, Responder};async fn greet(req: HttpRequest) -> impl Responder {let name = req.match_info().get("name").unwrap_or("World");format!("Hello {}!", &name)
}#[actix_web::main]
async fn main() -> std::io::Result<()> {HttpServer::new(|| {App::new().route("/", web::get().to(greet)).route("/{name}", web::get().to(greet))}).bind(("127.0.0.1", 8080))?.run().await
}

特点

灵活响应 Responders
在actix中处理函数可以返回大量对象,这些对象实现Responder trait. 可能非常轻松返回响应从你的API.

#[derive(Serialize)]
struct Measurement {temperature: f32,
}async fn hello_world() -> impl Responder {"Hello World!"
}async fn current_temperature() -> impl Responder {web::Json(Measurement { temperature: 42.3 })
}

强有力提取器
Actix带一个强有力的提取系统,提取数据从传入HTTP请求并且传它到你的view function. 不仅做这件事导致便洁API,而且也意味症你的view function可以同步代码和仍然可以得益于异步IO处理.

#[derive(Deserialize, Serialize)]
struct Event {id: Option<i32>,timestamp: f64,kind: String,tags: Vec<String>,
}async fn capture_event(evt: web::Json<Event>) -> impl Responder {let new_event = store_in_db(evt.timestamp, &evt.kind, &evt.tags);format!("got event {}", new_event.id.unwrap())
}

表单处理很容易
处理multipart/urlencoded表单数据非常容易.只是定义一个结构就可以把序列化并且 actix会处理剩下的.

#[derive(Deserialize)]
struct Register {username: String,country: String,
}async fn register(form: web::Form<Register>) -> impl Responder {format!("Hello {} from {}!", form.username, form.country)
}

请求路由
actix app带有一个URL路由系统,让你匹配URL并且调用单独的处理者.由于及其灵活性,scope可以被使用.

#[get("/")]
async fn index(_req: HttpRequest) -> impl Responder {"Hello from the index page!"
}async fn hello(path: web::Path<String>) -> impl Responder {format!("Hello {}!", &path)
}let app = App::new().service(index).route("/{name}", web::get().to(hello));

快速入门

Actix是什么

Actix是一个crate生态系统.
很长时间,actix-web是构建在actix上,是一个非常强大并且快速的actor 系统.现在,actix-web是一个与actor 框架无关系并且构建使用不同系统.虽然actix仍然被维护,它的作用作为一般工具特性在减少,并且async/await生态方式在成熟.在这时actix仅需要为WebSocket终端.

我们称actix-web为一个强大并且实用的框架. 总而言之,它是一个微框架,使用最小的修改.如果你已经是一个Rust开发者你很可能非常快的适应了,但是如果你来到其它编程语言,你应该会发现actix-web非常容易入手.

应用程序开发使用actix-web会暴露HTTP服务器包含内置可执行.你或者放它在HTTP server之后像nginx或服务它就像他那样.甚至在完整缺少HTTP serveractix-web是非常强来提供 HTTP/1 和HTTP/2支持还有TLS(HTTPS).这使它使用构建一个小服务在生产上.

最重要的:actix-web运行在Rust1.42或更新版本,并且它工作在稳定版本

安装Rust

如果你没有安装rust,我们推荐你使用rustup来管理你的rust安装. 官方rust指导有精彩部分来入门.

Actix web 当前最低支持Rust1.4.2版本.运行rustup update来保证你有最近和最高Rust可用版本.因此这个指南假设你运行Rust1.42或更高版本.

Hello,world!

开始通过创建一个新的基础Cargo的二进制项目并进入新目录.

cargo new hello-world
cd hello-world

添加actix-web依赖到你的项目.通过在Cargo.toml文本中加入如下

[dependencies]
actix-web = "3"

请求处理使用异步函数,接收0个或多个参数.这些参数可以从请求中提取(看FromRequest trait)并且返回一个类型可以转换为Httpresponse(查看Responder trait):

use actix_web::{get, post, web, App, HttpResponse, HttpServer, Responder};#[get("/")]
async fn hello() -> impl Responder {HttpResponse::Ok().body("Hello world!")
}#[post("/echo")]
async fn echo(req_body: String) -> impl Responder {HttpResponse::Ok().body(req_body)
}async fn manual_hello() -> impl Responder {HttpResponse::Ok().body("Hey there!")
}

注意: 一些处理器有路由信息直接附加,通过使用内建macros. 这些允许你指定方法和路径,处理器应该会回应的.你将要看到下边怎样注册manual_hello(例如:路由配置,不使用macro路由).

下边创建App实例并且注册请求处理器.为处理器使用App::service路由macros并且用App::route手动路由处理器,声明路径和方法.最后app启动内部HttpServer,它将要服务进来请求使用App作为"应用工厂".

#[actix_web::main]
async fn main() -> std::io::Result<()> {HttpServer::new(|| {App::new().service(hello).service(echo).route("/hey", web::get().to(manual_hello))}).bind("127.0.0.1:8080")?.run().await
}

就这些了,编译并运行程序用cargo run.#[actix_web::main] macro异步执行main函数在actix运行时.现在打开http://127.0.0.1:8080/或其它路你定义的路由查看结果.

actix-web -介绍相关推荐

html 01前沿-web介绍
1. 认识网页网页主要由文字.图像和超链接等元素构成.当然,除了这些元素,网页中还可以包含音频.视频以及Flash等. 2. 浏览器(显示代码) 浏览器是网页显示.运行的平台,常用的浏览器有IE.火 ...
WEB介绍（beego）
"学习或者了解人工智能小伙伴福利来了,前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家." 想了解或者学习人工智能可以看一下,我觉得学习起来挺有趣的 ...
网易云课堂Web安全工程师课程分享——第一章 Web介绍
第一节 Web介绍课程回顾: Web是什么? Web发展分为哪几个阶段? Web安全问题发展形势? Web的工作流程? 浏览器是如何工作的? 总结回答: Web指的是World Wide Web,平 ...
rust的actix web框架试试手（json数据传输和接受，数据库操作，rust后端操作）
文章目录 ##Actix Web(RUST) ###代码 main.rs <!DOCTYPE html> <html lang="en"> <head ...
Actix Web SQLx 搭建 Web 后端服务
本文代码 https://github.com/tothis/rust-record/tree/main/test/actix-web 已集成功能 log4rs 集成 SQLx 集成 Actix We ...
初学者Web介绍一些前端开发中的基本概念用到的技术
Web开发是比较费神的,需要掌握很多很多的东西,特别是从事前端开发的朋友,需要通十行才行.今天,本文向初学者介绍一些Web开发中的基本概念和用到的技术,从A到Z总共26项,每项对应一个概念或者技术. ...
Rust actix aiohttp_介绍 - actix-web 中文文档 - Rust-Web 开发指南
actix-web 是 Rust 生态中的最为优秀的 web 框架之一,具有类型安全.功能丰富.扩展性强,以及速度极快的诸多优点. 让我们通过 actix-web 的典型代码,来对其做一个整体认知. ...
WEB安全基础-WEB介绍
World Wide Web:万维网 web发展史 Web1.0 个人网站.门户网站 Web2.0 微博.Blog等 Web1.0 主要针对WEB服务器 SQL注入上传漏洞文件包含 ...
5 个开源的 Rust Web 开发框架，你选择哪个？
文章目录 Rust 的 Web 开发框架 Rocket Actix Web Yew Zola Warp 关注 Rust 拥有非常活跃和快节奏的开源生态系统,有大量的贡献者在做着许多很棒的项目,Rust ...
用 Go 语言，做 Web 编程开发
人民邮电出版社和实验楼合作的第 15 本书来了! Web 介绍 Web 应用在我们的生活中无处不在.看看我们日常使用的各个应用程序,它们要么是 Web 应用,要么是移动 App 这类 Web 应用的变 ...

actix-web -介绍

快速入门

概览

特点

快速入门

Actix是什么

安装Rust

Hello,world!

actix-web -介绍相关推荐

最新文章

热门文章