共计 5196 个字符，预计需要花费 13 分钟才能阅读完成。
A orm database Flutter plugin.
之前发了一篇文章《手把手教你在 Flutter 项目优雅的使用 ORM 数据库》，很多人咨询使用也提了一些宝贵的意见，说不希望要写 lua，这样不够优雅，也增加了学习成本。细想了一下，确实是，对 flutter 项目开发来讲，最好就是纯 flutter 版的 orm 框架，于是我就写了一个 flutter 版的 orm 插件 flutter_orm_plugin，使用的 demo 我放到 github 上了，大家可以下载来玩玩。下面我介绍一下 flutter_orm_plugin 提供的所有 api。
添加 orm 表
flutter_orm_plugin 中一个 orm 对应一个表，例如 demo 中 Student 表，它所在的 db 名字叫 School，表名叫 Student，它包含如下四个字段：
studentId 在数据库中是 Integer 类型，主键，自增的。
name 在数据库中是 Text 类型
class 在数据库中是 Text 类型，是外键，关联的表是另一个表 Class 表
score 在数据库中是 Real 类型
创建这样的表的代码在 demo 的 main.dart 中
Map<String , Field> fields = new Map<String , Field>();
fields[“studentId”] = Field(FieldType.Integer, primaryKey: true , autoIncrement: true);
fields[“name”] = Field(FieldType.Text);
fields[“class”] = Field(FieldType.Text, foreignKey: true, to: “School_Class”);
fields[“score”] = Field(FieldType.Real);
FlutterOrmPlugin.createTable(“School”,”Student”,fields);
数据库中某一列的数据通过 Field 类定义，我们先看看 Field 的定义就可以知道我们的 orm 对象支持哪些属性了
class Field {
final FieldType type;// 类型包括 Integer、Real、Blob、Char、Text、Boolean
bool unique;// 是否惟一
int maxLength;
bool primaryKey;// 是否主键
bool foreignKey;// 是否外键
bool autoIncrement;// 是否自增
String to;// 关联外键表，以 DBName_TableName 命名
bool index;// 是否有索引
}
插入数据
单条插入
Map m = {“name”:”william”, “class”:”class1″, “score”:96.5};
FlutterOrmPlugin.saveOrm(“Student”, m);
批量插入
List orms = new List();
for(int i = 0 ; i < 100 ; i++) {
Map m = {“name”:name, “class”:className, “score”:score};
orms.add(m);
}
FlutterOrmPlugin.batchSaveOrms(“Student”, orms);
查询数据
全部查询
Query(“Student”).all().then((List l) {
});
查询第一条
Query(“Student”).first().then((Map m) {
});
根据主键查询
Query(“Student”).primaryKey([1,3,5]).all().then((List l) {
});
where 条件查询
Query(“Student”).whereByColumFilters([WhereCondiction(“score”, WhereCondictionType.EQ_OR_MORE_THEN, 90)]).all().then((List l) {
});
where sql 语句查询
Query(“Student”).whereBySql(“class in (?,?) and score > ?”, [“class1″,”class2”,90]).all().then((List l) {
});
where 查询并排序
Query(“Student”).orderBy([“score desc”,]).all().then((List l) {
});
查询指定列
Query(“Student”).needColums([“studentId”,”name”]).all().then((List l) {
});
group by、having 查询
Query(“Student”).needColums([“class”]).groupBy([“class”]).havingByBindings(“avg(score) > ?”, [40]).orderBy([“avg(score)”]).all().then((List l) {
});
更新数据
全部更新
Query(“Student”).update({“name”:”test all update”});
根据主键更新
Query(“Student”).primaryKey([11]).update({“name”:”test update by primary key”});
根据特定条件更新
Query(“Student”).whereByColumFilters([WhereCondiction(“studentId”, WhereCondictionType.LESS_THEN, 5),WhereCondiction(“score”, WhereCondictionType.EQ_OR_MORE_THEN, 0)]).update({“score”:100});
根据自定义 where sql 更新
Query(“Student”).whereBySql(“studentId <= ? and score <= ?”, [5,100]).update({“score”:0});
删除数据
全部删除
Query(“Student”).delete();
根据主键删除
Query(“Student”).primaryKey([1,3,5]).delete();
根据条件删除
Query(“Student”).whereByColumFilters([WhereCondiction(“studentId”, WhereCondictionType.IN, [1,3,5])]).delete();
根据自定义 where sql 删除
Query(“Student”).whereBySql(“studentId in (?,?,?)”, [1,3,5]).delete();
联表查询
inner join
JoinCondiction c = new JoinCondiction(“Match”);
c.type = JoinType.INNER;
c.matchColumns = {“studentId”: “winnerId”};
Query(“Student”).join(c).all().then((List l) {
});
left join
JoinCondiction c = new JoinCondiction(“Match”);
c.type = JoinType.LEFT;
c.matchColumns = {“studentId”: “winnerId”};
Query(“Student”).join(c).all().then((List l) {
});
利用外键联表
JoinCondiction c = new JoinCondiction(“Class”);
c.type = JoinType.INNER;
Query(“Student”).join(c).all().then((List l) {
});
where sql 联表
JoinCondiction c = new JoinCondiction(“Match”);
c.type = JoinType.INNER;
c.matchColumns = {“studentId”: “winnerId”};
Query(“Student”).join(c).whereBySql(“Student.score > ?”,[60]).all().then((List l) {
});
部分 column 联表查询
JoinCondiction c = new JoinCondiction(“Match”);
c.type = JoinType.INNER;
c.matchColumns = {“studentId”: “winnerId”};
Query(“Student”).join(c).needColums([“name”,”score”]).all().then((List l) {
});
group by、having 联表查询
JoinCondiction c = new JoinCondiction(“Class”);
c.type = JoinType.INNER;
Query(“Student”).join(c).needColums([“class”]).groupBy([“Student.class”]).havingByBindings(“avg(Student.score) > ?”, [40]).all().then((List l) {
});
order by 联表查询
JoinCondiction c = new JoinCondiction(“Class”);
c.type = JoinType.INNER;
Query(“Student”).join(c).orderBy([“Student.score desc”]).all().then((List l) {
});
使用介绍
flutter_orm_plugin 已经发布到 flutter 插件仓库。只要简单配置即可使用，在 yaml 文件中加上 flutter_orm_plugin 依赖以及 orm 框架所需要的 lua 源文件，flutter_orm_plugin 会对所有 lua 代码进行封装，最终使用只需要关心 dart 接口，对 lua 是无感的。
flutter_orm_plugin: ^1.0.0
.
.
.
assets:
– packages/flutter_orm_plugin/lua/DB.lua
– packages/flutter_orm_plugin/lua/orm/model.lua
– packages/flutter_orm_plugin/lua/orm/cache.lua
– packages/flutter_orm_plugin/lua/orm/dbData.lua
– packages/flutter_orm_plugin/lua/orm/tools/fields.lua
– packages/flutter_orm_plugin/lua/orm/tools/func.lua
– packages/flutter_orm_plugin/lua/orm/class/fields.lua
– packages/flutter_orm_plugin/lua/orm/class/global.lua
– packages/flutter_orm_plugin/lua/orm/class/property.lua
– packages/flutter_orm_plugin/lua/orm/class/query.lua
– packages/flutter_orm_plugin/lua/orm/class/query_list.lua
– packages/flutter_orm_plugin/lua/orm/class/select.lua
– packages/flutter_orm_plugin/lua/orm/class/table.lua
– packages/flutter_orm_plugin/lua/orm/class/type.lua
在 ios 项目 podfile 加上 luakit 依赖
source ‘https://github.com/williamwen1986/LuakitPod.git’
source ‘https://github.com/williamwen1986/curl.git’
.
.
.
pod ‘curl’, ‘~> 1.0.0’
pod ‘LuakitPod’, ‘~> 1.0.17’
在 android 项目 app 的 build.gradle 加上 luakit 依赖
repositories {
maven {url “https://jitpack.io”}
}
.
.
.
implementation ‘com.github.williamwen1986:LuakitJitpack:1.0.9’
完成配置即可使用。
