博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Android之greenDao使用
阅读量:7250 次
发布时间:2019-06-29

本文共 10455 字,大约阅读时间需要 34 分钟。

Android之greenDao使用

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

一、greenDao简介

  1. 什么是greenDao
      GreenDAO是一个开源的Android ORM(“对象/关系映射”),通过ORM(称为“对象/关系映射”),在我们数据库开发过程中节省了开发时间。
  1. GreenDao的官方文档
    (1)GreenDao:适用于您的SQLite数据库的Android ORM

(2)GreenDao的github地址

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

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

DaoMaster:Dao中的管理者。它保存了sqlitedatebase对象以及操作DAO classes(注意:不是对象)。其提供了一些创建和删除table的静态方法,其内部类OpenHelper和DevOpenHelper实现了

SQLiteOpenHelper,并创建数据库的框架。

DaoSession:会话层。操作具体的DAO对象(注意:是对象),比如各种getter方法。

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

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

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

(2)性能最大化

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

二、greenDao实战

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

在app的build.gradle添加

具体代码如下:

apply plugin: 'com.android.application'

//添加greendao相关的plugin

apply plugin: 'org.greenrobot.greendao'

android {

compileSdkVersion 27defaultConfig {    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'

}

  1. 创建实体类
  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 {

@Idprivate Long id;@Property(nameInDb = "NAME")private String name;@Transientprivate 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
students;

}

学生与课程之间“多对多”的关系(一个学生对应有多门课程,一门课程对应有多个学生)

@Entity

class Student{

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

}

@Entity

class Course{

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

}

@Entity

class StudentWithCourse{

@Idprivate Long id;private Long sId;private Long cId;

}

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

  DaoMaster:用于创建数据库以及获取DaoSession

  DaoSession:用于获取各个表对应的Dao类
  各个表对应的Dao:提供了对表进行增删改查的方法

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

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();

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

解决方法:查询前先清空缓存,清空方法如下

//清空所有数据表的缓存数据

DaoSession daoSession = MyApplication.getInstances().getDaoSession();
daoSession .clear();

//清空某个数据表的缓存数据

UserDao userDao = MyApplication.getInstances().getDaoSession().getUserDao();
userDao.detachAll();

  1. 数据库加密
    添加依赖

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。

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

  这在实际中是不可取的,因此我们需要作出调整。下面介绍数据库升级的步骤与要点。

第一步
  新建一个类,继承DaoMaster.DevOpenHelper,重写onUpgrade(Database db, int oldVersion, int newVersion)方法,在该方法中使用MigrationHelper进行数据库升级以及数据迁移。
网上有不少MigrationHelper的源码,这里采用的是中的MigrationHelper,它主要是通过创建一个临时表,将旧表的数据迁移到新表中,大家可以去看下源码。

public class MyOpenHelper extends DaoMaster.OpenHelper {

public MyOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory) {    super(context, name, factory);}@Overridepublic 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'}
  1. 代码混淆
      在proguard-rules.pro文件中添加以下内容进行混淆配置

greenDAO开始

-keepclassmembers class * extends org.greenrobot.greendao.AbstractDao {

public static java.lang.String TABLENAME;
}
-keep class **$Properties

If you do not use SQLCipher:

-dontwarn org.greenrobot.greendao.database.**

If you do not use RxJava:

-dontwarn rx.**

greenDAO结束

如果按照上面介绍的加入了数据库加密功能,则需添加一下配置

sqlcipher数据库加密开始

-keep class net.sqlcipher.* {

;}
-keep class net.sqlcipher.database.* {
;}

sqlcipher数据库加密结束

三、项目源码下载

链接:
密码:iel2

四、参考文章

3.
原文地址

转载地址:http://frhbm.baihongyu.com/

你可能感兴趣的文章
Docker命令详解
查看>>
servlet jsp 各种路径获取。。
查看>>
应用系统架构设计
查看>>
【POJ】第二章 简单计算题之课后题
查看>>
MFC建立应用程序启示录(创世纪新篇)
查看>>
自定义实现session持久化
查看>>
如何处理xencenter中无法显示vm的performance信息
查看>>
oracle远程导出导入
查看>>
Citrix XenApp/XenDesktop产品发布策略调整
查看>>
我的友情链接
查看>>
MySql安装
查看>>
最简单的基于FFMPEG+SDL的视频播放器 ver2 (采用SDL2.0)
查看>>
11g默认审计选项
查看>>
Know more about RAC statistics and wait event
查看>>
【12c新特性】多LGWR进程SCALABLE LGWR "_use_single_log_writer"
查看>>
网站设计新手要知道的四个“不要”
查看>>
使用barcode4j生成条形码
查看>>
linux之Awk用法
查看>>
Oracle long raw字段操作 oledb方式 asp.net
查看>>
什么时候开始不算晚?
查看>>