# Overview

### 这是一个模仿mybatis的简单curd，目前仅支持mysql数据库。

### 如何使用？

#### 第一步：
在项目根目录下添加db.yml配置文件，其中编写数据库相关配置。
```
host: 127.0.0.1
port: 3306
user: root
password: 123456
db-name: test
```

#### 第二步：
假设你有一张`sys_user`表，其中主键名为`user_id`，那么在实体struct中， 
需要添加一个`entity_option_mapping`的属性宏，该宏接收两个属性参数， 第一个是表名，第二个是主键名。
所有字段必须使用Option类型，且泛型的类型是基本类型或String。
```
use r2d2_mysql::mysql::params;
use r2d2_mysql_batis::macros::entity_option_mapping;
use serde::Serialize;

#[derive(Serialize, Debug)]
#[entity_option_mapping(sys_user, user_id)]
pub struct SysUser {
    pub user_id: Option<u64>,
    pub username: Option<String>,
    pub name: Option<String>,
    pub password: Option<String>,
    pub dept_id: Option<u64>,
    pub email: Option<String>,
    pub mobile: Option<String>,
    pub status: Option<i8>,
    pub user_id_create: Option<u64>,
    pub gmt_create: Option<String>,
    pub gmt_modified: Option<String>,
    pub sex: Option<i64>,
    pub birth: Option<String>,
    pub pic_id: Option<i64>,
    pub live_address: Option<String>,
    pub hobby: Option<String>,
    pub province: Option<String>,
    pub city: Option<String>,
    pub district: Option<String>,
}
```

#### 第三步：
```
use crate::entity::SysUser;
use r2d2_mysql_batis::entity::Entity;
use r2d2_mysql_batis::service::Service;

#[tokio::test]
async fn tokio_test() {
        // 查询所有列表数据
        let list = SysUser::list().await.unwrap();
        
        // 根据主键查询单条数据
        let mut user = SysUser::find_by_id(1).await.unwrap().unwrap();
        println!("{user:?}");

        // 插入数据库
        user.add().await;

        // 根据主键更新（None值字段忽略）
        user.edit().await;

        // 根据主键删除
        SysUser::remove(999999).await;

        // 获取表名 返回类型为&str
        let table_name = SysUser::table_name();
        println!("{table_name}");

        // 获取主键名 返回类型为&str
        let primary_key = SysUser::primary_key();
        println!("{primary_key}");

        // 获取插入JPA SQL语句 返回类型为&str
        let insert_sql = SysUser::insert_sql();
        println!("{insert_sql}");

        // 获取根据主键更新JPA SQL语句（更新字段不包含None值）返回类型为String
        let update_by_id_sql = user.update_by_id_sql();
        println!("{update_by_id_sql}");

        // 设置主键值（数据库不更新）
        user.set_primary_key(1);
        
        // 自定义SQL查询
        let query_list = SysUser::query(String.from("SELECT * FROM `sys_user`")).await.unwrap();
        
        // 自定义JPA SQL查询
        let query_list = SysUser::jpa_query(String.from("SELECT * FROM `sys_user` WHERE `id` > :id"), params! {"id" => 0}).await.unwrap();
}
```