算起来,从真正开始用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 - 强化注解,减少配置映射,反对更多自定义的注解
- 反对更多数据结构,优化外部参数解决
- 欠缺主动代码生成工具,缩小反复工作
码完跑路(偷懒)
所以接下来就是你们的工夫了,该抄的抄,该溜的溜了。(逃