A Rust RESTful API server with actix-web
- 安装Rust
- 安装Docker (可选)
- 安装Docker Compose (可选)
首先安装cargo-make，可以用cargo make命令启动一些脚本
$ cargo install --no-default-features --force cargo-make
$ git clone 本库地址
$ cargo make dev
默认启用8080端口，可通过 http://localhost:8080/hello 测试是否启动成功
注：如果没有数据库和redis环境，可将 main.rs 中 db_pool 和 redis_pool 的相关部分注释掉
$ cargo make clean
$ cargo make build
$ cargo make buildlinux
$ docker-compose up
通过docker-compose启动postgres和redis，postgres端口为5432, redis端口为6379。数据库可通过本地客户端工具连接进行操作和调试。
$ docker-compose down
简洁为主
将 sql/db.sql 导入数据库
actix-web是rust下快速的异步web框架。底层异步库使用的Tokio，开发时注意使用异步的方式开发。
数据库连接池，redis连接池和配置文件的相关实例，在actix web启动的时候通过app_data传入actix。
App::new()
.app_data(web::Data::new(AppState {
config: settings.clone(),
log: logger.clone(),
db: db_pool.clone(),
redis: redis_pool.clone(),
}))
...
配置库选择config，配置文件为 data/config/app.toml，配置数据可通过web::Data获取：
pub async fn hello(state: web::Data<AppState>) -> Result<web::HttpResponse, error::Error> {
let name = state.config.get::<String>("app.name").unwrap();
...
}
日志库选择slog，支持异步，配置了日志文件和屏幕双输出。日志文件为 data/logs/app.log，actix中可通过如下方式记录日志：
pub async fn hello(state: web::Data<AppState>) -> Result<web::HttpResponse, error::Error> {
...
info!(state.log, "hello {}", name);
...
}
数据库操作库选择的sqlx，本例做了postgres的配置，可支持其他各种常用数据库。可通过web::Data获取数据库连接池。注意要使用异步方式开发。
Redis操作库选择的redis，支持异步方式，使用mobc配置的连接池。可通过web::Data获取redis连接池。注意要使用异步方式开发。
use redis::AsyncCommands;
...
pub async fn hello(state: web::Data<AppState>) -> Result<web::HttpResponse, error::Error> {
let mut con = state.redis.get().await.unwrap();
let val = con.get("my_key").await.unwrap();
...
}
采用JSON数据结构。
{"errcode":100203,"errmsg":"Captcha not found"}
(其他语言的后端接口我们也是统一返回类似的错误码，这样对于前端不用关心后端使用什么语言，使用统一的错误格式即可)
actix中可使用src/lib/error中定义的错误类型输出错误：
use crate::lib::error;
...
return Err(error::new(400001, "姓名不能为空", 422));
...
注：暂时使用422的错误码输出错误，在当前的actix版本，400错误会被默认自定义错误输出覆盖，待后续解决。
暂时没采用第三方库做输入验证，采用简单方式处理（沿用我其他语言脚手架的惯用方式），一些输入格式可通过 src/lib/validator.rs 中的正则判断，可在这里增加其他需要的验证。在actix中，通过?来验证和传递错误。
validator::uuid(uuid_var, "uuid")?;
validator::not_none(absent_number, "数值")?;
...
如果需要对输入的字符串判断非None并将Option自动转换为String，可采用validator::required_str函数：
let name = validator::required_str(name_param, "名称")?;