Actix-Web REST API with JWT 项目教程

1. 项目的目录结构及介绍

actix-web-rest-api-with-jwt/
├── Cargo.toml
├── src/
│   ├── main.rs
│   ├── models.rs
│   ├── schema.rs
│   ├── routes.rs
│   ├── handlers.rs
│   ├── db.rs
│   └── auth.rs
├── migrations/
├── .env
└── diesel.toml

• Cargo.toml: Rust 项目的依赖和元数据配置文件。
• src/: 包含项目的所有源代码文件。
  • main.rs: 项目的主入口文件。
  • models.rs: 定义数据库模型。
  • schema.rs: 自动生成的数据库表结构。
  • routes.rs: 定义 API 路由。
  • handlers.rs: 处理请求的逻辑。
  • db.rs: 数据库连接和操作。
  • auth.rs: JWT 认证相关逻辑。
• migrations/: 数据库迁移脚本。
• .env: 环境变量配置文件。
• diesel.toml: Diesel ORM 的配置文件。

2. 项目的启动文件介绍

src/main.rs 是项目的启动文件，负责初始化服务器和启动服务。以下是 main.rs 的主要内容：

#[macro_use]
extern crate diesel;
extern crate dotenv;

use actix_web::{web, App, HttpServer};
use diesel::prelude::*;
use diesel::r2d2::{self, ConnectionManager};

mod routes;
mod handlers;
mod models;
mod db;
mod auth;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    dotenv::dotenv().ok();

    let database_url = std::env::var("DATABASE_URL").expect("DATABASE_URL must be set");
    let manager = ConnectionManager::<PgConnection>::new(database_url);
    let pool = r2d2::Pool::builder()
        .build(manager)
        .expect("Failed to create pool.");

    HttpServer::new(move || {
        App::new()
            .data(pool.clone())
            .configure(routes::init_routes)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

• dotenv::dotenv().ok(): 加载环境变量。
• let database_url = std::env::var("DATABASE_URL").expect("DATABASE_URL must be set"): 获取数据库连接 URL。
• let manager = ConnectionManager::<PgConnection>::new(database_url): 创建数据库连接管理器。
• let pool = r2d2::Pool::builder().build(manager).expect("Failed to create pool."): 创建数据库连接池。
• HttpServer::new(move || { App::new().data(pool.clone()).configure(routes::init_routes) }): 初始化 HTTP 服务器并配置路由。
• bind("127.0.0.1:8080")?: 绑定服务器到指定地址和端口。
• run().await: 启动服务器。

3. 项目的配置文件介绍

.env

.env 文件用于存储环境变量，以下是一个示例：

DATABASE_URL=postgres://username:password@localhost/database_name
SECRET_KEY=your_secret_key

• DATABASE_URL: 数据库连接 URL。
• SECRET_KEY: JWT 签名密钥。

diesel.toml

diesel.toml 文件用于配置 Diesel ORM，以下是一个示例：

[print_schema]
file = "src/schema.rs"

• [print_schema]: 配置 Diesel 生成数据库表结构的输出文件。
• file = "src/schema.rs": 指定生成的文件路径。