环境搭建
-
Project
,root
级别的buidle.gradle
// In your root build.gradle file:
buildscript {
repositories {
jcenter()
mavenCentral() // add repository need to add
}
dependencies {
classpath 'com.android.tools.build:gradle:3.1.1'
classpath 'org.greenrobot:greendao-gradle-plugin:3.2.2' // add plugin
}
}
-
module
下的build.gradle
添加
// In your app projects build.gradle file:
apply plugin: 'com.android.application'
apply plugin: 'org.greenrobot.greendao' // apply plugin
dependencies {
implementation 'org.greenrobot:greendao:3.2.2' // add library
}
-
module
级别下的build.gradle
添加
greendao {
schemaVersion 1 //版本 指定数据库schema版本号,迁移等操作会用到
daoPackage 'com.cc.greendao.model.gen' // 一般为app包名+生成文件的文件夹名
targetGenDir 'src/main/java' //生成文件路径
}
如图:
好了,以上为环境搭建,那么按照官方文档的解释为我们需要添加注解最终生成库,首先建立个UserEntity
类、要想生成表,则需要在类添加@Entity
注解、主键则为@Id
,当创建类后会有继续Make Project
或者Ctrl+F9
生成相应的几个类,而此时如果实现了Serializable
则需要添加serialVersionUID
否则编译会出现异常:
Found 1 problem(s) parsing "D:\androidstudio\lx\cc\CCRxJavaDemo\greendaoapp\src\main\java\com\cc\greendao\model\entity\UserEntity.java". First problem:
Pb(96) The serializable class UserEntity does not declare a static final serialVersionUID field of type long (536871008 at line 10).
Run gradle with --info for more details.
先了解一下基本的几个注解:
-
@Entity
:将我们的java普通类变为一个能够被greenDAO识别的数据库类型的实体类; -
@nameInDb
:在数据库中的名字,如不写则为实体中类名; -
@Id
:选择一个long / Long属性作为实体ID。 在数据库方面,它是主键。参数autoincrement是设置ID值自增; -
@NotNull
:使该属性在数据库端成为“NOT NULL”列。 通常使用@NotNull标记原始类型(long,int,short,byte)是有意义的; -
@Transient
:表明这个字段不会被写入数据库,只是作为一个普通的java类字段,用来临时存储数据的,不会被持久化。
签名提到了serialVersionUID
那么问题来了,怎么样才能生成serialVersionUID
呢,难道每次都要手动填写吗?显然这很不伪极客
了。配置如下:
未设置前:
设置中
设置后
参考链接:https://www.cnblogs.com/godtrue/p/7674487.html
/**
* created by cheng.qx on 2018/9/20 20:28
*/
@Entity
public class UserEntity implements Serializable {
private static final long serialVersionUID = -1837160411940974152L;
//人员
@Id
private String personId;
private String personName;
//部门
private String departmentId;
private String departmentName;
//广场
private String storeId;
private String parentStatus;
public void setPersonId(String personId) {
this.personId = personId;
}
}
-
UserEntity
:实体会给我们相关属性自动生成get、setter的方法以及两个构造函数。 -
module
级别的build.gradle
下配置的greendao>daoPackage
文件'com.cc.greendao.model.gen'
最终生成目录结构为:
我们来看看这三个核心文件: -
DaoMaster
:使用greenDAO
的切入点。DaoMaster
保存数据库对象(SQLiteDatabase)
并管理特定模式的DAO
类(而不是对象)。 它具有静态方法来创建表或将它们删除。 其内部类OpenHelper
和DevOpenHelper
是在SQLite
数据库中创建模式的SQLiteOpenHelper
实现。一个DaoMaster
就代表着一个数据库的连接。 -
DaoSession
:管理特定模式的所有可用DAO
对象,您可以使用其中一个getter
方法获取。DaoSession
还为实体提供了一些通用的持久性方法,如插入,加载,更新,刷新和删除。DaoSession
可以让我们使用一些Entity
的基本操作和获取Dao
操作类,DaoSession
可以创建多个,每一个都是属于同一个数据库连接的。 -
XxxDAO
:数据访问对象(DAO
)持续存在并查询实体。 对于每个实体,GreenDAO
生成一个DAO
。 它比DaoSession
有更多的持久化方法,例如:count
,loadAll
和insertInTx
。
被volatile修饰的变量能够保证每个线程能够获取该变量的最新值,从而避免出现数据脏读的现象。