GreenDao的使用步骤

最近一段时间,由于项目需要进行优化,项目中的数据缓存可以说是很混乱,有SqlLite,ActiviteAndroid,sp等,所以就打算把这些涉及到数据库知识的信息给其统一到一个数据库中,以便后期升级维护,从而增加程序的可扩展性,之所以选择greendao,是因为其具备很多优点:
GreenDao
官网中明确指明了其首要设计目标:
Maximum performance (probably the fastest ORM for Android):系能最大化
Easy to use APIs:便于使用
Highly optimized for Android:对于Android高度优化
Minimal memory consumption:最小化内存开销
Small library size, focus on the essentials:较小的文件体积,只集中在必要的部分上。
优点:
效率很高,插入和更新的速度是sqlite的2倍,加载实体的速度是ormlite的4.5倍。官网测试结果:http://greendao-orm.com/features/
文件较小(<100K),占用更少的内存 ,但是需要create Dao,
操作实体灵活:支持get,update,delete等操作
缺点:
学习成本较高。其中使用了一个java工程根据一些属性和规则去generate一些基础代码,类似于javaBean但会有一些规则,另外还有QueryBuilder、Dao等API,所以首先要明白整个过程,才能方便使用。没有ORMLite那样封装的完整,不过greenDao的官网上也提到了这一点,正是基于generator而不是反射,才使得其效率高的多。
另外GreenDao支持Protocol buffers协议数据的直接存储 ,如果通过protobuf协议和服务器交互,不需要任何的映射。
下面就来讲解一下整合greendao中需要注意的知识点。
1 按照greendao的说明文档,添加一些依赖的库到app下的gradle中
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'org.greenrobot:greendao-gradle-plugin:3.2.0'
}
}
apply plugin: 'org.greenrobot.greendao'

greendao {
//数据库的schema版本,也可以理解为数据库版本号
schemaVersion 1
//设置DaoMaster、DaoSession、Dao包名,也就是要放置这些类的包的全路径。
daoPackage 'cn.hnshangyu.testgreendao.greendao'
//设置DaoMaster、DaoSession、Dao目录
targetGenDir 'src/main/java'
}
dependencies {
compile 'org.greenrobot:greendao:3.2.0'
}
此时,让人郁闷的是,编译报错,不对啊,完全是按照官方文档的要求来的啊,怎么还报错呢,具体报错信息如下:
Error:Execution failed for task ':app:greendao'.

org.eclipse.jdt.internal.compiler.impl.CompilerOptions.versionToJdkLevel(Ljava/lang/Object;)J
最后,通过查看资料,后来把这些配置信息重新整合了一下:
在app下的build.grdle中,如下:

apply plugin: 'org.greenrobot.greendao'

greendao {
//数据库的schema版本,也可以理解为数据库版本号
schemaVersion 1
//设置DaoMaster、DaoSession、Dao包名,也就是要放置这些类的包的全路径。
daoPackage 'cn.hnshangyu.testgreendao.greendao'
//设置DaoMaster、DaoSession、Dao目录
targetGenDir 'src/main/java'
}
dependencies {
compile 'org.greenrobot:greendao:3.2.0'
}
在工程的build.grdle中,如下:

buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.3.1'
classpath 'org.greenrobot:greendao-gradle-plugin:3.2.0'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
然后重新编译,编译通过,问题解决。编译通过后,系统会在你要求输出的目录中自动生成DaoMaster、DaoSession等相关的数据库工具类,如果这些文件生成,那么你的配置成功了。
2 定义实体bean,以下是实体中常用到的注解含义
@Entity  表明这个实体类会在数据库中生成一个与之相对应的表。
@Id  对应数据表中的 Id 字段,有了解数据库的话,是一条数据的唯一标识。
@Property(nameInDb = “STUDENTNUM”)  表名这个属性对应数据表中的 STUDENTNUM 字段。
@Property  可以自定义字段名,注意外键不能使用该属性
@NotNull  该属性值不能为空
@Transient  该属性不会被存入数据库中
@Unique  表名该属性在数据库中只能有唯一值
很像Java web端对hibernater数据库中的实体的定义。具体定义这里就不做过多的说明。
4 数据库的增、删、查、改,具体不细说,但其中的关键字含义在这里介绍一下
eq equal ==
notEq notequal !=
ge greater or equal >=
gt greater than >
le less or equal <=
lt less than <
当然不止这么多,不过这几个对于基本的增、删、查、改是使用最频繁的
5 数据库的升级


GreenDao的使用步骤_第1张图片
image.png

每次有旧表的数据库字段的增加或者新建新表,都有修改版本号,这是升级的依据。部分代码如下:
public static void migrate(Database db, Class>... daoClasses) {
//1 新建临时表
generateTempTables(db, daoClasses);
//2 创建新表
createAllTables(db, false, daoClasses);
//3 临时表数据写入新表,删除临时表
restoreData(db, daoClasses);
}
进过测试,无论数据库字段的增加或者新建新表,都能升级成功,但同时不要忘记改版本号哟。后期会把源码附上。

你可能感兴趣的:(GreenDao的使用步骤)