actix-web -介绍

本文主要是介绍actix-web -介绍，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

快速入门

概览
- 特点
快速入门
- Actix是什么
- 安装Rust
- Hello,world!

概览

一个功能增大,实用的并且非常快的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
}