内容介绍

本专题将通过实现一个自动生成数据库 CRUD 的 Derive宏 来对过程宏 proc-macro 进行一步步的探讨。我们希望通过本专题的学习，能让你掌握 rust 过程宏的知识要点，并将其应用到实际开发中。

• 掌握 rust 过程宏的编写
• 实现对数据模型结构体的 CRUD Derive宏
  • 实现 CRUD，基于 sqlx
  • 实现自定义表名、主键及是否为视图
  • 实现某些字段跳过插入
  • 实现某些字段跳过更新
  • 实现查找单条记录的过滤条件，并可指定过滤条件是使用 ILIKE 进行模糊查询，还是使用 = 进行精确匹配。
  • 实现记录列表的过滤条件，并可指定过滤条件是使用 ILIKE 进行模糊查询，还是使用 = 进行精确匹配。
  • 实现分页

#[derive(Db)]
#[db(table = "users", pk = "id")]
pub struct User {
    #[db(find)]
    pub id: String,
    
    #[db(find)]
    #[db(list_opt)]
    #[db(opt_like)]
    pub email: String,
    
    pub password: String,
    
    #[db(list_opt)]
    #[db(opt_like)]
    pub nickname: String,
    
    #[db(skip_update)]
    pub dateline: chrono::DateTime<chrono::Local>,
}

#[derive(Db)]
#[db(table = "messages", pk = "id")]
pub struct Message {
    #[db(find)]
    #[db(skip_insert)]
    pub id: i32,
    
    #[db(list_opt)]
    #[db(skip_update)]
    pub user_id: String,
    
    #[db(list_opt)]
    #[db(opt_like)]
    pub content: String,
    
    #[db(skip_update)]
    pub dateline: chrono::DateTime<chrono::Local>,
    
}

#[derive(Db)]
#[db(table = "v_user_messages", pk = "user_id, message_id", is_view)]
pub struct UserMessage {
    #[db(list_opt)]
    #[db(opt_like)]
    pub email: String,
    
    #[db(list_opt)]
    #[db(opt_like)]
    pub nickname: String,
    
    #[db(find_opt)]
    #[db(list_opt)]
    pub message_id: i32,
    
    #[db(find_opt)]
    #[db(list_opt)]
    pub user_id: String,
    
    #[db(list_opt)]
    #[db(opt_like)]
    pub content: String,
    
    pub dateline: chrono::DateTime<chrono::Local>,
}

以 User 为例，将自动为其生成以下方法：

以及配套的数据结构：

pub enum UserFindBy {
    Id(String),
    Email(String),
}

pub struct UserFindFilter {
    pub by: UserFindBy,
}

pub struct UserListFilter {
    pub page: u32,
    pub page_size: u32,
    pub email: Option<String>,
    pub nickname: Option<String>,
}

pub struct UserPaginate {
    pub page: u32,
    pub page_size: u32,
    pub total: u32,
    pub total_page: u32,
    pub data: Vec<User>,
}