最近有几个童鞋问我关于greendao的使用问题,以及碰见的一些坑,所以写这篇文章来说下。
GreenDao是什么?
greenDAO是一个对象关系映射(ORM)的框架,能够提供一个接口通过操作对象的方式去操作关系型数据库,它能够让你操作数据库时更简单、更方便。
官网地址:http://greenrobot.org/greendao/
Github地址:https://github.com/greenrobot/greenDAO
有哪些优势?
1、性能高,号称Android最快的关系型数据库,比sqlite性能高30%.
2、内存占用小
3、库文件比较小,小于100K,编译时间低,而且可以避免65K方法限制
4、支持数据库加密 greendao支持SQLCipher进行数据库加密 有关SQLCipher
5、简洁易用的API,也支持sql语句
使用流程:
第一步在项目的Project 的 buil.gradle 里设置如下
在buildscript- repositories添加配置mavenCentral(),
在dependencies 里添加
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
buildscript {
repositories {
jcenter()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.2'
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
第二步在自己Module里 buil.gradle 里设置如下
2.1 头部添加
apply plugin:'org.greenrobot.greendao'
2.2 在dependencies 里添加
compile'org.greenrobot:greendao:3.1.0'
compile'org.greenrobot:greendao-generator:3.1.0'
2.3在android里添加
greendao{
schemaVersion 1
daoPackage'com.example.mytest.greendao.gen'
targetGenDir'src/main/java'
}
参数说明:
schemaVersion: 数据库schema版本,也可以理解为数据库版本号
daoPackage:设置DaoMaster、DaoSession、Dao包名
targetGenDir:设置DaoMaster、DaoSession、Dao目录
targetGenDirTest:设置生成单元测试目录
generateTests:设置自动生成单元测试用例
第三步创建实体类TestBean。
在实体类上方写上 @Entity 即可!然后不需要写set get 方法,编译后会自动帮我们生成.
编译后生成的界面
Application里的设置
增删改查的操作
先初始化
TestBeanDao testBeanDao = AppApplication.getApplication().getDaoSession().getTestBeanDao();
新增:
TestBean testBean=newTestBean(null,"zhangsan");
testBeanDao.insert(testBean);
删除:
testBeanDao.delete(testBean);
修改:
testBeanDao.update(testBean);
查询:
List list = testBeanDao.queryBuilder().where(TestBeanDao.Properties.Name.eq("zhangsan")).build().list(); 查询名字叫张三的人。这种可以满足多条件查询。
List list = testBeanDao.loadAll();查询所有
关于查询还有很多方法,如notEq、between、like等一些,大家可以根据需求来用。
注解说明
1.)实体@Entity注解
schema:告知GreenDao当前实体属于哪个schema
active:标记一个实体处于活动状态,活动实体有更新、删除和刷新方法
nameInDb:在数据中使用的别名,默认使用的是实体的类名
indexes:定义索引,可以跨越多个列
createInDb:标记创建数据库表**
2.)基础属性注解
@Id :主键 Long型,可以通过@Id(autoincrement = true)设置自增长
@Property:设置一个非默认关系映射所对应的列名,默认是的使用字段名举例:@Property (nameInDb="name")
@NotNul:设置数据库表当前列不能为空
@Transient:添加次标记之后不会生成数据库表的列
3.)索引注解
@Index:使用@Index作为一个属性来创建一个索引,通过name设置索引别名,也可以通过unique给索引添加约束
@Unique:向数据库列添加了一个唯一的约束
4.)关系注解
@ToOne:定义与另一个实体(一个实体对象)的关系
@ToMany:定义与多个实体对象的关系
(一) @Entity 定义实体
@nameInDb 在数据库中的名字,如不写则为实体中类名
@indexes 索引
@createInDb 是否创建表,默认为true,false时不创建
@schema 指定架构名称为实体
@active 无论是更新生成都刷新
(二) @Id
(三) @NotNull 不为null
(四) @Unique 唯一约束
(五) @ToMany 一对多
(六) @OrderBy 排序
(七) @ToOne 一对一
(八) @Transient 不存储在数据库中
(九) @generated 由greendao产生的构造函数或方法
注意事项:
1、默认数据库升级时会删除所有的表导致数据丢失,所以在正式的项目中需要另外封装一层,来实现数据库的安全升级。
2、3.0之前需要通过新建GreenDaoGenerator工程生成Java数据对象(实体)和DAO对象,对象多的时候操作起来非常麻烦。GreenDao 3.0之后采用注解的方式通过编译方式生成Java数据对象和DAO对象,配置上相对于2.0要简单的多。
3、查询的时候会有缓存,比如第一次和第二次,所有数据改变时需要清除缓存在查询。testBeanDao.detachAll();
数据库的查看可以推荐用facebook的调试工具Stetho,在无root的时候也能看手机里的数据库、缓存、cookie等信息,在开发调试时非常方便,到时候我在下篇文章里会写Stetho的使用教程。