六、用 Actix-web 构建异步 web工程

六、用 Actix-web 构建异步 web工程
　　
　　目前 Rust 的 web 框架已经有挺多了，考虑到可靠性，异步化，结构化，流行速度，使用简单，等多方面因素后，这里笔者最终选择了 actix-web。本节一起来看下 actix-web 的使用情况。
　　
　　用 CLion 打开之前的工程。首先，来看一下项目结构：

.
├── Cargo.toml
├── README.md
└── src
    ├── main.rs
    └── module
        ├── mod.rs
        └── user
            ├── api.rs
            ├── mod.rs
            └── model.rs

 
　　接下来，我们将其改造为一个异步 web 工程。

1、Cargo.toml

[dependencies]
actix-web = "3.0.1"
serde = "1.0.114"
validator = "0.10.1"
validator_derive = "0.10.1"

2、module/user/model.rs

use serde::{Deserialize, Serialize};
use validator::Validate;

#[derive(Debug, Validate, Serialize, Deserialize)]
pub struct User {
    pub id: Option<i64>,
    #[validate(length(max = 50, message = "username must be less than 50 chars."))]
    pub username: String,
    #[validate(length(min = 6, message = "password must be more than 6 chars."))]
    pub password: String,
    #[validate(length(max = 255, message = "username must be less than 255 chars."))]
    pub avatar: Option<String>,
    #[validate(length(max = 80, message = "username must be less than 80 chars."))]
    pub email: Option<String>,
}

3、module/user/api.rs

use actix_web::{delete, get, HttpResponse, post, put, Responder, web};
use actix_web::web::Json;

use crate::module::user::model::User;

/**
 * 测试接口: 增
 */
#[post("/user")]
pub async fn create(user: Json<User>) -> impl Responder {
    HttpResponse::Ok().json(user.0)
}

/**
 * 测试接口: 查
 */
#[get("/user/{id}}")]
pub async fn show(web::Path(id): web::Path<i64>) -> impl Responder {
    HttpResponse::Ok().json(id)
}

/**
 * 测试接口: 改
 */
#[put("/user/{id}")]
pub async fn update(web::Path(id): web::Path<i64>, user: Json<User>) -> impl Responder {
    let mut user = user.into_inner();
    user.id = Some(id);
    HttpResponse::Ok().json(user)
}

/**
 * 测试接口: 删
 */
#[delete("/user/{id}")]
pub async fn delete(web::Path(id): web::Path<i64>) -> impl Responder {
    HttpResponse::Ok().json(id)
}

4、module/user/mod.rs

pub mod api;
//pub mod bs;
//pub mod dao;
pub mod model;

5、module/mod.rs

pub mod user;

pub mod handler {
    use actix_web::dev::HttpServiceFactory;
    use actix_web::web;

    use crate::module::user;

    pub fn api_routes() -> impl HttpServiceFactory {
        web::scope("")
            .service(user::api::create)
            .service(user::api::show)
            .service(user::api::update)
            .service(user::api::delete)
    }
}

6、src/main.rs

#[macro_use]
extern crate validator_derive;

use actix_web::{App, HttpServer};

mod module;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(move || App::new()
        .service(module::handler::api_routes())
    ).bind("0.0.0.0:8080")?.run().await
}

 　　在项目的根目录执行：cargo run。

    Finished dev [unoptimized + debuginfo] target(s) in 0.18s
     Running `target/debug/rust-demo`

 　　看到上面信息后，就可以使用 post + json，尝试请求了。

curl -H "Content-Type: application/json" -X POST -d \
'{"email": "xugy3@126.com", "username": "xugy4", "password": "123456",
"avatar": "https://avatars3.githubusercontent.com/u/13329376?s=460&v=4"}' http://127.0.0.1:8080/user

 
　　本节进行了一个异步 web 工程的简单探索，读者可以多尝试一下本节 demo，比如打印一下参数对象等。同时，本 demo 也将是后续更多工作的基础。OK，这次就到这里 ！！