Android之greenDao使用
文章大纲
一、greenDao简介
二、greenDao实战
三、项目源码下载
四、参考文章

一、greenDao简介

什么是greenDao
GreenDAO是一个开源的Android ORM(“对象/关系映射”)，通过ORM（称为“对象/关系映射”），在我们数据库开发过程中节省了开发时间。

GreenDao的官方文档
（1）GreenDao：适用于您的SQLite数据库的Android ORM

（2）GreenDao的github地址
（3）GreenDao的Google讨论区
（4）GreenDao 加密SQLCipher for Android官方说明地址
（5） GreenDao使用文档

GreenDao原理
DAO的core library中有以下几个核心类，也是后面常用到的，先来大概了解下他们的结构。

DaoMaster：Dao中的管理者。它保存了sqlitedatebase对象以及操作DAO classes（注意：不是对象）。其提供了一些创建和删除table的静态方法，其内部类OpenHelper和DevOpenHelper实现了
SQLiteOpenHelper，并创建数据库的框架。

DaoSession：会话层。操作具体的DAO对象（注意：是对象），比如各种getter方法。

Daos：实际生成的某某DAO类，通常对应具体的java类，比如NoteDao等。其有更多的权限和方法来操作数据库元素。

Entities：持久的实体对象。通常代表了一个数据库row的标准java properties。

GreenDao的优点
(1)一个精简的库

(2)性能最大化
(3)内存开销最小化
(4)易于使用的 APIs
(5)对 Android 进行高度优化

二、greenDao实战

添加依赖
在项目的build.gradle添加

在app的build.gradle添加

具体代码如下：

apply plugin: 'com.android.application'

//添加greendao相关的plugin
apply plugin: 'org.greenrobot.greendao'

android {

compileSdkVersion 27
defaultConfig {
    applicationId "top.daxianwill.greendaodemo"
    minSdkVersion 15
    targetSdkVersion 27
    versionCode 1
    versionName "1.0"
}
buildTypes {
    release {
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}

greendao{

    //指定数据库schema版本号，迁移等操作会用到;
    schemaVersion 1
    //dao的包名，包名默认是entity所在的包；
    daoPackage 'com.greendao.gen'
    //生成数据库文件的目录;
    targetGenDir 'src/main/java'
}

}

dependencies {

implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:27.1.1'
implementation 'com.android.support.constraint:constraint-layout:1.1.0'

//添加greendao相关依赖
implementation 'org.greenrobot:greendao:3.2.2'

}

创建实体类
top.daxianwill.greendaodemo;

import org.greenrobot.greendao.annotation.Entity;
import org.greenrobot.greendao.annotation.Id;
import org.greenrobot.greendao.annotation.Property;
import org.greenrobot.greendao.annotation.Transient;
import org.greenrobot.greendao.annotation.Generated;

/**

创建数据库实体类
*

@Entity 表示这个实体类一会会在数据库中生成对应的表，

@Id 表示该字段是id，注意该字段的数据类型为包装类型Long

@Property 则表示该属性将作为表的一个字段，其中nameInDb看名字就知道这个属性在数据库中对应的数据名称。

@Transient 该注解表示这个属性将不会作为数据表中的一个字段。

@NotNull 表示该字段不可以为空

@Unique 表示该字段唯一

@Entity
public class User {

@Id
private Long id;

@Property(nameInDb = "NAME")
private String name;

@Transient
private int tempUsageCount; // not persisted

@Generated(hash = 873297011)
public User(Long id, String name) {
    this.id = id;
    this.name = name;
}
@Generated(hash = 586692638)
public User() {
}
public Long getId() {
    return this.id;
}
public void setId(Long id) {
    this.id = id;
}
public String getName() {
    return this.name;
}
public void setName(String name) {
    this.name = name;
}

}

注解介绍
（1）@Entity
用来声明类实体，表示它将映射为数据表
@Entity（）括号内可加入更详细的设置，如：
nameInDb =“TABLE_NAME” ——> 声明该表的表名，默认取类名
createInDb = true ——> 是否创建表，默认为true
generateConstructors = true ——> 是否生成含所有参数的构造函数，默认为true
generateGettersSetters = true ——> 是否生成getter/setter，默认为true

（2）@Id
用来声明某变量为表的主键，类型使用Long
@Id（）括号可加入autoincrement = true表明自增长

（3）@Unique
用来声明某变量的值需为唯一值

（4）@NotNull
用来声明某变量的值不能为null

（5）@Property
@Property(nameInDb = “URL”) 用来声明某变量在表中的实际字段名为URL

（6）@Transient
用来声明某变量不被映射到数据表中

（7）@ToOne、@ToMany
用来声明”对一”和“对多”关系，下面举例说明：
学生与学校之间一对多的关系（一个学生对应一个学校，一个学校对应有多个学生）

@Entity
class Student{

//...省略其他变量
private long fk_schoolId;//外键

@ToOne(joinProperty = "fk_schoolId")
private School school;

}

@Entity
class School{

//...省略其他变量 
@ToMany(referencedJoinProperty = "fk_schoolId")
private List<Student> students;

}
学生与课程之间“多对多”的关系（一个学生对应有多门课程，一门课程对应有多个学生）

@Entity
class Student{

//...省略其他变量
@ToMany
@JoinEntity(
        entity = StudentWithCourse.class,
        sourceProperty = "sId",
        targetProperty = "cId"
)
private List<Course> courses;

}

@Entity
class Course{

//...省略其他变量
@ToMany
@JoinEntity(
        entity = StudentWithCourse.class,
        sourceProperty = "cId",
        targetProperty = "sId"
)
private List<Course> courses;

}

@Entity
class StudentWithCourse{

@Id
private Long id;
private Long sId;
private Long cId;

}

Make Project
利用上面注解写好表实体后，通过Build—>Make Project重新编译项目，将会在表实体中自动生成构造方法和getter/setter方法，另外在指定（或默认）的包中生成DaoMaster、DaoSession以及表实体对应的Dao（如MovieCollectDao）。

DaoMaster：用于创建数据库以及获取DaoSession
DaoSession：用于获取各个表对应的Dao类
各个表对应的Dao：提供了对表进行增删改查的方法

进行数据增删改查
进行操作前，我们先获取操作的对象

UserDao mUserDao = MyApplication.getInstances().getDaoSession().getUserDao();
进行数据增加

public void insert(){

    mUser = new User(id++,"any"+id);

    mUserDao.insert(mUser);

    notifyListView();
}

补充：
(1)上述代码讲的是插入单条数据，插入多条数据方式为：

List listUserCollect;
mUserDao.insertInTx(listUserCollect);
(2)插入或替换数据
//插入的数据如果已经存在表中，则替换掉旧数据（根据主键来检测是否已经存在）

MovieCollect userCollect;
mUserDao.insertOrReplace(userCollect);//单个数据

List listUserCollect;
mUserDao.insertOrReplace(listUserCollect);//一组数据
进行数据删除

public void delete(){

    long l = mUserDao.count() - 1;

    mUserDao.deleteByKey(l);

    notifyListView();
}

补充：
（1）上面代码讲的是删除一条数据，删除所有数据方式为：

mUserDao.deleteAll();
（2）删除多条数据

List listUserCollect;
mUserDao.deleteInTx(listUserCollect）;
进行数据修改

public void update(){

    mUser = new User((long)3,"any0803");

    mUserDao.update(mUser);

    notifyListView();
}

补充：
（1）上面代码介绍的是修改单条数据，修改多条数据方式如下：

List listUserCollect;
mUserDao.updateInTx(listUserCollect）;
进行数据查询

public void loadAll(){

    mUserList = mUserDao.loadAll();//查询所有数据

    notifyListView();
}

补充：
（1）上面代码介绍的是查询所有数据，查询数据数量方式如下：

int count = mUserDao.count();
（2）精确（where）条件查询

//查询电影名为“肖申克的救赎”的电影
MovieCollect movieCollect =
mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Title.eq("肖申克的救赎")).unique();

//查询电影年份为2017的电影
List movieCollect =
mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.eq(2017)).list();
（3）模糊查询（like）

//查询电影名含有“传奇”的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Title.like("传奇")).list();

//查询电影名以“我的”开头的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Title.like("我的%")).list();
（4）区间查询

//大于
//查询电影年份大于2012年的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.gt(2012)).list();

//大于等于
//查询电影年份大于等于2012年的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.ge(2012)).list();

//小于
//查询电影年份小于2012年的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.lt(2012)).list();

//小于等于
//查询电影年份小于等于2012年的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.le(2012)).list();

//介于中间
//查询电影年份在2012-2017之间的电影
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.between(2012,2017)).list();
（5）升序降序

//查询电影年份大于2012年的电影，并按年份升序排序
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.gt(2012)).orderAsc(MovieCollectDao.Properties.Year).list();

//查询电影年份大于2012年的电影，并按年份降序排序
List movieCollect = mMovieCollectDao.queryBuilder().where(MovieCollectDao.Properties.Year.gt(2012)).orderDesc(MovieCollectDao.Properties.Year).list();
（6）and/or

//and
//查询电影年份大于2012年且电影名以“我的”开头的电影
List movieCollect = mMovieCollectDao.queryBuilder().and(MovieCollectDao.Properties.Year.gt(2012), MovieCollectDao.Properties.Title.like("我的%")).list();

//or
//查询电影年份小于2012年或者大于2015年的电影
List movieCollect = mMovieCollectDao.queryBuilder().or(MovieCollectDao.Properties.Year.lt(2012), MovieCollectDao.Properties.Year.gt(2015)).list();

缓存处理
由于GreenDao默认开启了缓存，所以当你调用A查询语句取得X实体，然后对X实体进行修改并更新到数据库，接着再调用A查询语句取得X实体，会发现X实体的内容依旧是修改前的。其实你的修改已经更新到数据库中，只是查询采用了缓存，所以直接返回了第一次查询的实体。

解决方法：查询前先清空缓存，清空方法如下

//清空所有数据表的缓存数据
DaoSession daoSession = MyApplication.getInstances().getDaoSession();
daoSession .clear();

//清空某个数据表的缓存数据
UserDao userDao = MyApplication.getInstances().getDaoSession().getUserDao();
userDao.detachAll();

数据库加密
添加依赖

compile 'net.zetetic:android-database-sqlcipher:3.5.7'//使用加密数据库时需要添加
获取操作的数据库对象

mSQLiteOpenHelper = new MySQLiteOpenHelper(MyApplication.getInstance(), DB_NAME, null);//建库
mDaoMaster = new DaoMaster(mSQLiteOpenHelper.getEncryptedWritableDb("你的密码"));//加密
//mDaoMaster = new DaoMaster(mSQLiteOpenHelper.getWritableDatabase());
mDaoSession = mDaoMaster.newSession();
温馨提示：
（1）使用上面步骤得到的DaoSession进行具体的数据表操作。
（2）如果运行后报无法加载有关so库的异常，请对项目进行clean和rebuild。

数据库版本升级
在版本迭代时，我们经常需要对数据库进行升级，而GreenDAO默认的DaoMaster.DevOpenHelper在进行数据升级时，会把旧表删除，然后创建新表，并没有迁移旧数据到新表中，从而造成数据丢失。

这在实际中是不可取的，因此我们需要作出调整。下面介绍数据库升级的步骤与要点。
第一步
新建一个类，继承DaoMaster.DevOpenHelper，重写onUpgrade(Database db, int oldVersion, int newVersion)方法，在该方法中使用MigrationHelper进行数据库升级以及数据迁移。
网上有不少MigrationHelper的源码，这里采用的是https://github.com/yuweiguocn/GreenDaoUpgradeHelper中的MigrationHelper，它主要是通过创建一个临时表，将旧表的数据迁移到新表中，大家可以去看下源码。

public class MyOpenHelper extends DaoMaster.OpenHelper {

public MyOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory) {
    super(context, name, factory);
}

@Override
public void onUpgrade(Database db, int oldVersion, int newVersion) {

    //把需要管理的数据库表DAO作为最后一个参数传入到方法中
    MigrationHelper.migrate(db, new MigrationHelper.ReCreateAllTableListener() {

        @Override
        public void onCreateAllTables(Database db, boolean ifNotExists) {
            DaoMaster.createAllTables(db, ifNotExists);
        }

        @Override
        public void onDropAllTables(Database db, boolean ifExists) {
            DaoMaster.dropAllTables(db, ifExists);
        }
    },  MovieCollectDao.class);
}

}
然后使用MyOpenHelper替代DaoMaster.DevOpenHelper来进行创建数据库等操作

mSQLiteOpenHelper = new MyOpenHelper(MyApplication.getInstance(), DB_NAME, null);//建库
mDaoMaster = new DaoMaster(mSQLiteOpenHelper.getWritableDatabase());
mDaoSession = mDaoMaster.newSession();
第二步
在表实体中，调整其中的变量（表字段），一般就是新增/删除/修改字段。注意：
（1）新增的字段或修改的字段，其变量类型应使用基础数据类型的包装类，如使用Integer而不是int，避免升级过程中报错。
（2）根据MigrationHelper中的代码，升级后，新增的字段和修改的字段，都会默认被赋予null值。

第三步
将原本自动生成的构造方法以及getter/setter方法删除，重新Build—>Make Project进行生成。

第四步
修改Module下build.gradle中数据库的版本号schemaVersion ，递增加1即可，最后运行app

greendao{
//数据库版本号，升级时进行修改
    schemaVersion 2
    //dao的包名，包名默认是entity所在的包；
    daoPackage 'com.greendao.gen'
    //生成数据库文件的目录;
    targetGenDir 'src/main/java'
}