GreenDao 3.2.0 的基本使用
前言
android开发中我们或多或少都会接触到数据库。android中提供了一个占用内存极小的关系型数据库-sqlite。虽然android系统中提供了许多操作sqlite的api,但是我们还是需要手动去编写sql语句,这经常会出现一些莫名其妙的问题(????,不要问我为什么)。所以便出现了许多orm(对象关系映射)框架。其中比较著名的有greendao、ormlite、litepal等。下面主要介绍一下greendao,我平时用的最多的也是greendao。
greendao简介
官网上的介绍,greendao 是一个将对象映射到 sqlite 数据库中的轻量且快速的 orm 解决方案。(greendao is a light & fast orm solution that maps objects to sqlite databases.)
greendao特点
- 性能最大化,可能是android平台上最快的orm框架
- 易于使用的api
- 最小的内存开销
- 依赖体积小
- 支持数据库加密
- 强大的社区支持
greendao有如此多的有点,我们还有什么理由不去使用它呢。
greendao配置
在build.gradle(module:app)中添加下面代码:
buildscript { repositories { mavencentral() } dependencies { classpath 'org.greenrobot:greendao-gradle-plugin:3.2.1' } } apply plugin: 'org.greenrobot.greendao' dependencies { compile 'org.greenrobot:greendao:3.2.0' }
其他配置
在build.gradle(module:app)中添加:
greendao { schemaversion 1//数据库版本号 daopackage 'com.com.sky.downloader.greendao'//设置daomaster、daosession、dao包名 targetgendir 'src/main/java'//设置daomaster、daosession、dao目录 //targetgendirtest:设置生成单元测试目录 //generatetests:设置自动生成单元测试用例 }
上述配置是可选项,如果不配置,则默认生成在build下:
greendao的基本配置就已经完成了,下面我们编写一个实体类。
实体类user
@entity public class user { @id(autoincrement = true) private long id; private string name; private int age; }
相关注解说明:
实体@entity注解
schema:告知greendao当前实体属于哪个schema
active:标记一个实体处于活跃状态,活动实体有更新、删除和刷新方法
nameindb:在数据库中使用的别名,默认使用的是实体的类名
indexes:定义索引,可以跨越多个列
createindb:标记创建数据库表
基础属性注解
@id:主键 long 型,可以通过@id(autoincrement = true)设置自增长
@property:设置一个非默认关系映射所对应的列名,默认是使用字段名,例如:@property(nameindb = "name")
@notnull:设置数据库表当前列不能为空
@transient:添加此标记后不会生成数据库表的列
索引注解
@index:使用@index作为一个属性来创建一个索引,通过name设置索引别名,也可以通过unique给索引添加约束
@unique:向数据库添加了一个唯一的约束
关系注解
@toone:定义与另一个实体(一个实体对象)的关系
@tomany:定义与多个实体对象的关系
当我们编写好实体类并添加自己需要的注解之后,点击make project或者make module 'app',就会项目的build目录下或者自己设定的目录下看到生成的三个类文件:
- daomaster
- daosession
- userdao
后面的数据库操作需要借助这三个类来进行,同时在我们的实体类中自动生成了各个属性的get、set方法。
初始化greendao
一般建议在application中初始化数据库
devopenhelper有两个重载方法:
- devopenhelper(context context,string name)
- devopenhelper(context context,string name,cursorfactory factory)
context上下文这个不用多说,name数据库的名字,cursorfactory游标工厂,一般不用,传入null或者使用两个参数的方法即可。我们对外提供一个getdaosession()的方法供外部使用。
增
注意:long型id,如果传入null,则greendao会默认设置自增长的值。
- insert(user entity):插入一条记录
删
- deletebykey(long key) :根据主键删除一条记录。
- delete(user entity) :根据实体类删除一条记录,一般结合查询方法,查询出一条记录之后删除。
- deleteall(): 删除所有记录。
改
update(user entity):更新一条记录
查
- loadall():查询所有记录
- load(long key):根据主键查询一条记录
- querybuilder().list():返回:list
- querybuilder().where(userdao.properties.name.eq("")).list():返回:list
- queryraw(string where,string selectionarg):返回:list
总结
至此,greendao的基本使用方法就这些了,后面还有一些关于数据的升级等问题,后面再具体介绍。
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持!
上一篇: angularjs路由(ngRoute)
下一篇: angular中路由的使用