Android 数据库框架greenDao的使用

作者: 崔鹏宇 | 来源:发表于2018-05-21 18:05 被阅读116次

    greenDao Github 连接

    恭喜RNG!!!

    一、配置greenDao

    这是GitHub给出的配置

    buildscript {
        repositories {
            jcenter()
            mavenCentral() // add repository
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:3.1.1'
            classpath 'org.greenrobot:greendao-gradle-plugin:3.2.2' // add plugin
        }
    }
     
    // 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
    }
    

    我们需要在build.gradel(project)中配置如下图


    project build.gradle配置.png

    还需要在build.gradel(app)中配置如下图

    数据库配置
    1. schemaVersion:当前版本的数据库模式。这被OpenHelpers类用于在模式版本之间迁移。如果更改了实体/数据库模式,则必须增加该值。默认为1。
    
    2. daoPackage:生成的Dao,DaoMaster和DaoSession的包名称。 默认为源实体的包名称。
    
    3. targetGenDir:生成源应存储在的位置。 默认为构建目录( build / generated / source / greendao)中生成的源文件夹。
    
    4. generateTests: 设置为true以自动生成单元测试。
    
    5. targetGenDirTests: 应存储生成的单元测试的基本目录。默认为 src / androidTest / java。
    
    build.gradel app配置.png

    现在我们可以开心的使用greenDao了!!!

    二、greenDao的使用

    1、我们先创建一个实体类User类
    @Entity
    public class User {
        @Id
        private Long id;
        @Property(nameInDb = "Name")
        @NonNull
        @Unique
        private String name;
        @NonNull
        private String passWord;
        @Transient
        private String Transient;
    }
    

    这时候我们Rebuild project后会发现在我们之门build.gradle(app) 配置的目录下生成了DaoMaster、DaoSession、UserDao文件。并且
    User实体类变成了这样

    @Entity
    public class User {
        @Id
        private Long id;
        @Property(nameInDb = "Name")
        @NonNull
        @Unique
        private String name;
        @NonNull
        private String passWord;
        @Transient
        private String Transient;
        @Generated(hash = 446776444)
        public User(Long id, @NonNull String name, @NonNull String passWord) {
            this.id = id;
            this.name = name;
            this.passWord = passWord;
        }
        @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;
        }
        public String getPassWord() {
            return this.passWord;
        }
        public void setPassWord(String passWord) {
            this.passWord = passWord;
        }
    }
    
    下面我们来说一下greendao的注解还有自动生成的类都是什么意思
    ①、注解

    @Entity 表明这个实体类会在数据库中生成一个与之相对应的表
    @Id 对应数据表中的 Id 字段
    @Property 设置一个非默认关系映射所对应的列名,默认是使用字段名。
    @NotNull 设置数据库表当前列不能为空
    @Transient 添加此注解后不会生成数据库表的列
    @Unique 表名该属性在数据库中只能有唯一值
    @Generated greenDAO运行所产生的构造函数或者方法,被此标注的 代码可以变更或者下次运行时清除
    @OrderBy 指定排序

    ②、自动生成类

    DaoMaster类:使用greenDao的入口,其中有创建和销毁表的方法

        /** Creates underlying database table using DAOs. */
        public static void createAllTables(Database db, boolean ifNotExists) {
            UserDao.createTable(db, ifNotExists);
        }
    
        /** Drops underlying database table using DAOs. */
        public static void dropAllTables(Database db, boolean ifExists) {
            UserDao.dropTable(db, ifExists);
        }
    

    它的内部类OpenHelper 和DevOpenHelper是SQLiteOpenHelper 的实现,用来在SQLite数据库中创建模式。

        /**
         * Calls {@link #createAllTables(Database, boolean)} in {@link #onCreate(Database)} -
         */
        public static abstract class OpenHelper extends DatabaseOpenHelper {
            public OpenHelper(Context context, String name) {
                super(context, name, SCHEMA_VERSION);
            }
    
            public OpenHelper(Context context, String name, CursorFactory factory) {
                super(context, name, factory, SCHEMA_VERSION);
            }
    
            @Override
            public void onCreate(Database db) {
                Log.i("greenDAO", "Creating tables for schema version " + SCHEMA_VERSION);
                createAllTables(db, false);
            }
        }
    
    

    DaoSession类:可获取所有管理的Dao对象,可以使用DaoSession一些基础的方法,比如对实体的插入,加载,更新,刷新和删除等。
    UserDao类:数据访问对象(DAOs)用来操作实体。对于每一个实体,greenDao生成一个Dao。它比DaoSession有更多操作数据库的方法。

    获取UserDao对象以便于对user表进行操作
       private UserDao mUserDao;
       private DaoMaster mDaoSession ;
       public void initDao() {
            DaoMaster.OpenHelper openHelper = new DaoMaster.OpenHelper(MyAppLication.getMlication(), "test.db") {
                @Override
                public void onCreate(Database db) {
                    super.onCreate(db);
                }
            };
            SQLiteDatabase database = openHelper.getWritableDatabase();
            DaoMaster daoMaster = new DaoMaster(database);
            mDaoSession = daoMaster.newSession();
            mUserDao=mDaoSession.getUserDao();
        }
    
    插入

    插入一条数据insert

            User user = new User();
            user.setName("cuipengyu");
            user.setPassWord("123456");
            mUserDao.insert(user);
    

    插入多条数据insertInTx

            List<User> users=new ArrayList<>();
            //id设置null默认自增长
            users.add(new User(null,"cuipengyu01","dddd"));
            users.add(new User(null,"cuipengyu02","dddd"));
            users.add(new User(null,"cuipengyu03","dddd"));
            users.add(new User(null,"cuipengyu04","dddd"));
            users.add(new User(null,"cuipengyu05","dddd"));
            mUserDao.insertInTx(users);
    
        /**
         * Inserts the given entities in the database using a transaction.
         *
         * @param entities The entities to insert.
         */
        public void insertInTx(Iterable<T> entities) {
            insertInTx(entities, isEntityUpdateable());
        }
    

    (存在替换反之插入)替换insertOrReplace

            User user = new User();
            user.setName("cuipengyu05");
            user.setPassWord("1234");
            mUserDao.insertOrReplace(user);
    

    替换多条insertOrReplaceInTx

          List<User> users=new ArrayList<>();
            users.add(new User(null,"cuipengyu01","111"));
            users.add(new User(null,"cuipengyu02","111"));
            users.add(new User(null,"cuipengyu03","111"));
            users.add(new User(null,"cuipengyu04","111"));
            users.add(new User(null,"cuipengyu05","111"));
            mUserDao.insertOrReplaceInTx(users);
    
    查询

    根据id查询loadByRowId

            mUserDao.loadByRowId(1);
            Log.e("whereQueryId", mUserDao.loadByRowId(1).getName().toString() + "");
    

    05-21 10:30:39.481 931-931/com.cuipengyu.greendaodemo E/whereQueryId: cuipengyu
    查询表中所有数据loadAll

       List<User> users = mUserDao.loadAll();
            for (int i = 0; i < mUserDao.loadAll().size(); i++) {
                Log.e("users", users.get(i).getName());
            }
    

    05-21 11:12:54.847 1597-1597/com.cuipengyu.greendaodemo E/users: cuipengyu cuipengyu01 cuipengyu02
    05-21 11:12:54.848 1597-1597/com.cuipengyu.greendaodemo E/users: cuipengyu03 cuipengyu04
    05-21 11:12:54.849 1597-1597/com.cuipengyu.greendaodemo E/users: cuipengyu05
    查询表中所有数据queryBuilder.list

        List<User> users = mUserDao.queryBuilder().list();
            for (int i = 0; i < users.size(); i++) {
                Log.e("users", users.get(i).getName());
            }
    

    05-21 11:17:20.031 2065-2065/com.cuipengyu.greendaodemo E/users: cuipengyu cuipengyu01 cuipengyu02 cuipengyu03 cuipengyu04 cuipengyu05
    条件查询queryRaw

       mUserDao.queryRaw("where Name=?", "cuipengyu").size;
      Log.e("whereQueryRaw", mUserDao.queryRaw("where Name=?", "cuipengyu").size() + "");
    

    05-21 11:27:58.718 2614-2614/com.cuipengyu.greendaodemo E/whereQueryRaw: 1
    条件查询queryBuilder().where

      mUserDao.queryBuilder().where(UserDao.Properties.Name.eq("cuipengyu")).build().list().size();
    Log.e("queryBuilder",mUserDao.queryBuilder().where(UserDao.Properties.Name.eq("cuipengyu")).build().list().size()+"");
    

    05-21 11:30:20.116 2754-2754/com.cuipengyu.greendaodemo E/queryBuilder: 1
    QueryBuilder查询一些API
    QueryBuilder<T> distinct()去重查询,相当于是在SQL语句中加了distinct
    QueryBuilder<T> where(WhereCondition cond, WhereCondition... condMore)条件子句,相当于SQL中的Where
    QueryBuilder<T> whereOr(WhereCondition cond1, WhereCondition cond2, WhereCondition... condMore)或条件查询
    WhereCondition and(WhereCondition cond1, WhereCondition cond2, WhereCondition... condMore)且条件
    QueryBuilder<T> orderAsc(Property... properties)从小到大排序
    QueryBuilder<T> orderDesc(Property... properties)从大到小排序
    QueryBuilder<T> limit(int limit)限制当页个数 offset(int offset)跳过
    List<T> list()执行Query并把返回集合,并且entity都会加载到内存中,返回的结果通常就是ArrayList
    LazyList listLazy()Entity按需加载到内存中,在第一次访问list中的element时,它就会呗加载并且缓存。
    LazyList listLazyUncached()每次访问结果集的时候都是从数据库中加载,而不使用缓存。
    LazyList listIterator()通过迭代器访问结果集,并且采用的时lazy-loading,结果不会缓存。
    T unique() 返回唯一的数据
    Properties操作相关API
    WhereCondition eq(Object value)相当于在Where字句后加上 “=” value
    WhereCondition notEq(Object value) 在Where字句后加上 “!=” value
    WhereCondition like(String value) 在Where字句后加上 “like” value模糊查询
    WhereCondition between(Object a, Object b) 在Where字句后加上 “between a and b” value
    WhereCondition le(Object value)less or equal ('<=')
    WhereCondition ge(Object value)greater or equal ('>=')
    WhereCondition lt(Object value)less than ('<')
    WhereCondition gt(Object value)greater than ('>')"
    WhereCondition notIn(Collection<?> notInValues)NOT IN (..., ..., ...)
    WhereCondition in(Collection<?> inValues)IN (..., ..., ...)
    有些sql语句忘了可以上网站一看就可以明白地址

    删除

    根据 id删除数据

    mUserDao.deleteByKey(Long id);
    

    根据实体类删除表中数据

         User user = new User(1l, "cuipengyu", "123");
         mUserDao.delete(user);
    

    根据查询条件删除表中数据

            QueryBuilder<User> queryBuilder=mUserDao.queryBuilder();
            DeleteQuery<User> userDeleteQuery=queryBuilder.where(UserDao.Properties.Name.eq("cuipengyu01")).buildDelete();
            //将查询到的符合条件的删除
            userDeleteQuery.executeDeleteWithoutDetachingEntities();
    

    清空表中所有数据

      mUserDao.deleteAll();
    
    更改

    根据实体类表中数据

            User user = new User();
            user.setId(9l);
            user.setName("cuipengyuupdata");
            user.setPassWord("updata");
            mUserDao.update(user);
    

    根据条件查询去更改数据

            QueryBuilder<User> queryBuilder = mUserDao.queryBuilder();
            User user = 
            queryBuilder.where(UserDao.Properties.Name.eq("cuipengyu03")).build().unique();
            user.setName("cuipengyuUpdata");
            mUserDao.insertOrReplace(user);
    

    批量更改跟批量添加是差不多只不过是调用mUserDao.updateInTx();

    推荐一个方便查看数据库的方法

    Facebook出的stetho
    在项目中添加依赖
    compile 'com.facebook.stetho:stetho:1.5.0'
    在Application中注册
    Stetho.initializeWithDefaults(this);
    当运行项目时 在游览器中输入chrome://inspect如下图

    01.png
    点击inspect
    2.png

    相关文章

      网友评论

        本文标题:Android 数据库框架greenDao的使用

        本文链接:https://www.haomeiwen.com/subject/tczzdftx.html