actix-web -介绍

概览

一个功能增大,实用的并且非常快的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/或其它路你定义的路由查看结果.