算起来，从真正开始用 Rust 进行我的项目开发曾经快一年了，对 Rust 也愈发青眼；在这过程中踩了很多坑，因为 Rust 的变态也不得不恶补了很多被废除的常识；当然对计算机的了解也更深了，头发天然也越发稠密了。

”圆“规正传

明天给大家分享一个本人的一个 crate，因为近几年转Rust 的小伙伴越来越多，很多都是从 Java 岗转的，他们转过来的第一件事就是疯狂的寻找一个好用的 ORM 框架，然而 Rust 中目前比拟好用的相干数据库框架有 diesel、sqlx 等，基本上都能满足日常的工作需要。为了不便更多小伙伴过渡 Rust，就手撸了一个小框架，参考MyBatisPlus 的相干 API，置信只有用过该框架的小伙伴应该根本能够无缝过渡。目前曾经过渡到 0.2.0 版本，基本上更新还是比拟频繁，因为后期想法比拟多，也没有一个固定的方向所以常常颠覆重来。

这个 crate 叫做 akita，翻译过去就是秋田犬的意思，也代表了呆萌可恶的意思。根本的实现思路就是通过Rust 的过程宏来实现对数据库表构造的映射，而后封装了一些便捷的 SQL 组装的工具办法。目前我的项目临时只反对 MySQL，所应用的线程池为r2d2，行将打算反对ClickHouse、SQLite、MSSQL、ORACLE 等数据库。

间接开码

话不多说咱间接码，好不好用咱用一个试试。首先增加依赖，当初目前版本在 0.2.4。

[dependencies]

# The core APIs, including the Table traits. Always
# required when using Akita. using #[derive(Table)] 
# to make Akita work with structs defined in your crate.
akita = {version = "0.2.0"] }

首先咱们定义一个构造体 SystemUser，Akita 提供了三个 trait，别离是 FromAkita、ToAkita 还有 Table，次要是用来解析构造体的字段构造以及生成根本的 CRUD 成员办法。另外提供了table 注解用来标注数据库表名，field和 table_id 标注列名和主键，别离都有 name 属性，同时保留了 MyBatisPlus 中的 exist 属性。

#[derive(Debug, FromAkita, ToAkita, Table, Clone)]
#[table(name="t_system_user")]
struct SystemUser {#[field = "name"]
    id: Option<i32>,
    #[table_id]
    username: String,
    #[field(name="ages", exist = "false")]
    age: i32,
}

来来来，Akita中提供了两个公共的管理器，AkitaManager和AkitaEntityManager，前者次要封装了一些原始的 SQL 操作，后者则退出了比拟残缺的 API，同时在构造体中也实现了这些 API。咱们以 CRUD 操作举例：

use akita::*;
use akita::prelude::*;

fn main() {let mut pool = Pool::new(AkitaConfig{ max_size: None, url: String::from("mysql://root:password@localhost:3306/akita"), log_level: None }).unwrap();
    let mut em = pool.entity_manager().expect("must be ok");
    let user = SystemUser {id: 1.into(), username: "fff".to_string(), age: 1};

    // 新增
    match em.save(&user) {Ok(res) => { }
        Err(err) => {}}
    /// 构造体示例
    match user.insert(&mut em) {Ok(res) => { }
        Err(err) => {}}

    // 删除
    match em.remove_by_id::<SystemUser, String>("id".to_string()) {Ok(res) => { }
        Err(err) => {}}

    // 批改
    match em.update_by_id(&user, "id") {Ok(res) => { }
        Err(err) => {}}

    // 查问分页
    let mut wrapper = UpdateWrapper::new();
    wrapper.eq("username", "ussd").eq("id", 1);
    match em.page::<SystemUser, UpdateWrapper>(1, 10,&mut wrapper) {Ok(res) => { }
        Err(err) => {}}
    // 查问单条
    match em.select_one::<SystemUser, UpdateWrapper>(&mut wrapper) {Ok(res) => { }
        Err(err) => {}}

    ...
}

看完是不是很打动，对于手写了大半年 SQL 的我，几乎是个福音 … 另外性能方面的话还有很多咱们正在优化，比方大数据量的分页以及相干慢 SQL 的拦挡以及一些其余的优化。

打算

我的项目目前只有几个人进行保护，所以将来更新速度并不会很快，咱们也会在生产上应用这个框架，逐渐的去优化。将来咱们打算做的事：

• 反对 ORACLE、ClickHouse、SQLite、MSSQL 多个 feature
• 强化注解，减少配置映射，反对更多自定义的注解
• 反对更多数据结构，优化外部参数解决
• 欠缺主动代码生成工具，缩小反复工作

码完跑路（偷懒）

所以接下来就是你们的工夫了，该抄的抄，该溜的溜了。（逃