关闭

Android官方ORM数据库Room技术解决方案简介(一)

标签: android
2319人阅读 评论(0) 收藏 举报
分类:
是时候该忘记Android SQLite了!Android官方ORM数据库Room技术解决方案简介(一)

Android的Romm是Android官方整合出来的一揽子ORM数据库解决方案。Android Room和历史上的ORM数据库如Android ORMLite(见附录文章1,2),Android greenDao等等,有诸多相同的设计思想和理念,但Android Room同时吸收众家ORM数据库之长,有自己新的创新和改进。我将分开写若干篇文章,逐点介绍Android官方的ORM数据库技术解决方案:Room。
(一)使用Android Room,首先要在gradle添加引用,我是基于room的version 1.0.0:
    implementation 'android.arch.persistence.room:runtime:1.0.0'
    annotationProcessor 'android.arch.persistence.room:compiler:1.0.0'


(二)和其他ORM数据库相似,Android Room需要先建立数据库表和Java对象的模型,User.java:
package zhangphil.demo;

import android.arch.persistence.room.ColumnInfo;
import android.arch.persistence.room.Entity;
import android.arch.persistence.room.PrimaryKey;

/**
 * Created by Phil on 2017/11/22.
 */

@Entity(tableName = "user_table")
public class User {
    @PrimaryKey(autoGenerate = true)
    public int id;

    @ColumnInfo(name = "userName")
    public String name;

    @ColumnInfo(name = "userAge")
    public int age;

    @ColumnInfo(name = "updateTime")
    public long updateTime;
}

注解@Entity告诉Android Room,该User类将是一个数据库中的表。tableName如果开发者不自定义,那么Android系统默认将使用类名作为数据库中的表名。本例中的User,指定了表名为“user_table”,开发者可以根据自己情况自命名。

@PrimaryKey标注该字段是表中的主键,可根据该主键进行数据库的基本增删改查等等这些操作。当设置autoGenerate = true后,该主键将自增长。@ColumnInfo注解后面跟着的name,标明定义的Java变量将作为表中的一列。比如User中的

    @ColumnInfo(name = "userName")
    public String name;
那么数据库中表的一列userName中存储的数据就是name。


(三)构建针对User的Dao。UserDao.java:
package zhangphil.demo;

import android.arch.persistence.room.Dao;
import android.arch.persistence.room.Delete;
import android.arch.persistence.room.Insert;
import android.arch.persistence.room.OnConflictStrategy;
import android.arch.persistence.room.Query;
import android.arch.persistence.room.Update;

import java.util.List;

/**
 * Created by Phil on 2017/11/22.
 */

@Dao
public interface UserDao {
    /**
     * 查询
     *
     * @return
     */
    @Query("SELECT * FROM user_table")
    public List<User> getAllUsers();

    /**
     * 添加
     *
     * @param users
     */
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    public void insertUser(User... users);

    /**
     * 更新
     *
     * @param users
     */
    @Update
    public void updateUser(User... users);

    /**
     * 删除
     *
     * @param users
     */
    @Delete
    public void deleteUser(User... users);
}

@Dao注解标明该Java类是一个Android Room中的Dao对象。Android Room中的Dao,可以以接口interface形式定义。Android Room中的查询以SQL标准语句定义。比如在UserDao中的定义的:

    /**
     * 查询
     *
     * @return
     */
    @Query("SELECT * FROM user_table")
    public List<User> getAllUsers();

该SQL语句将从我之前建立的数据块表“user_table”中,查询出所有的内容,然后返回一个集合。其他关于数据库的操作如增加(@Insert),删除(@Delete),修改(更新,@Update),均以注解标明。这些基本操作可以按照User中定义的@PrimaryKey主键操作。

(四)构造数据库。
这一步在Android Room技术中基本上是规范化的代码,写法比较规矩,建立UserDatabase.java:
package zhangphil.demo;

import android.arch.persistence.room.Database;
import android.arch.persistence.room.RoomDatabase;

/**
 * Created by Phil on 2017/11/22.
 */

@Database(entities = {User.class}, version = 1)
public abstract  class UserDatabase  extends RoomDatabase {
    public abstract UserDao getUserDao();
}
UserDatabase最重要的功能是提供给开发者各种Dao。开发者获得Dao后,就可以像操作基本Java对象实例一样操作Android Room数据中数据。
最终的代码结构如图:



(五)在MainActivity.java中测试我写的Android Room。注意涉及到数据库操作,要放到后台线程中运行。MainActivity.java:

package zhangphil.demo;

import android.arch.persistence.room.Room;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;

import java.util.List;

public class MainActivity extends AppCompatActivity {

    private String TAG = "输出";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        new Thread(new Runnable() {
            @Override
            public void run() {
                databaseOperation();
            }
        }).start();
    }

    private void databaseOperation() {
        UserDatabase mUserDatabase = Room.databaseBuilder(getApplicationContext(), UserDatabase.class, "users").build();
        UserDao mUserDao = mUserDatabase.getUserDao();

        //写数据库
        Log.d(TAG, "开始写入数据...");
        writeDatabase(mUserDao, "张三", 18);
        writeDatabase(mUserDao, "李四", 19);
        Log.d(TAG, "写入数据库完毕.");

        //读数据库
        Log.d(TAG, "第1次读数据库");
        readDatabase(mUserDao);

        //更新数据库
        updateUser(mUserDao);

        //读数据库
        Log.d(TAG, "第2次读数据库");
        readDatabase(mUserDao);

        //删除数据,根据主键id
        deleteUser(mUserDao, 1);

        //读数据库
        Log.d(TAG, "第3次读数据库");
        readDatabase(mUserDao);

        Log.d(TAG, "========================");
        Log.d(TAG, "本轮数据库操作事务全部结束");
        Log.d(TAG, "========================");
    }

    private void readDatabase(UserDao dao) {
        Log.d(TAG, "读数据库...");
        List<User> users = dao.getAllUsers();
        for (User u : users) {
            Log.d(TAG, u.id + "," + u.name + "," + u.age + "," + u.updateTime);
        }
        Log.d(TAG, "读数据库完毕.");
    }

    private void writeDatabase(UserDao dao, String name, int age) {
        User user = new User();
        user.name = name;
        user.age = age;
        user.updateTime = System.currentTimeMillis();
        dao.insertUser(user);
    }

    private void updateUser(UserDao dao) {
        Log.d(TAG, "更新数据库...");
        User u = new User();
        u.id = 2;
        u.name = "赵五";
        u.age = 20;
        u.updateTime = System.currentTimeMillis();
        dao.updateUser(u);
        Log.d(TAG, "更新数据库完毕.");
    }

    private void deleteUser(UserDao dao, int id) {
        Log.d(TAG, "删除数据库...");
        User u = new User();
        u.id = id;
        dao.deleteUser(u);
        Log.d(TAG, "删除数据库完毕.");
    }
}

MainActivity.java实现基本的功能,在数据库中添加写入两条数据条目。然后在第一次读数据库操作中,从数据中读出来观察是否已经写进去。
接着更新数据库,根据User的PrimaryKey主键id更新,我把数据库中主键id为2的数据行更新。再次第2次读数据库,验证我的更新操作是否成功。
然后再根据主键删除id=1的数据库数据行,第3次读数据库,验证数据库删除的操作。代码运行后的logcat输出:
11-23 10:49:22.631 19616-19641/zhangphil.demo D/输出: 开始写入数据...
11-23 10:49:22.688 19616-19641/zhangphil.demo D/输出: 写入数据库完毕.
11-23 10:49:22.688 19616-19641/zhangphil.demo D/输出: 第1次读数据库
11-23 10:49:22.688 19616-19641/zhangphil.demo D/输出: 读数据库...
11-23 10:49:22.689 19616-19641/zhangphil.demo D/输出: 1,张三,18,1511405362631
11-23 10:49:22.689 19616-19641/zhangphil.demo D/输出: 2,李四,19,1511405362674
11-23 10:49:22.689 19616-19641/zhangphil.demo D/输出: 读数据库完毕.
11-23 10:49:22.689 19616-19641/zhangphil.demo D/输出: 更新数据库...
11-23 10:49:22.692 19616-19641/zhangphil.demo D/输出: 更新数据库完毕.
11-23 10:49:22.692 19616-19641/zhangphil.demo D/输出: 第2次读数据库
11-23 10:49:22.692 19616-19641/zhangphil.demo D/输出: 读数据库...
11-23 10:49:22.693 19616-19641/zhangphil.demo D/输出: 1,张三,18,1511405362631
11-23 10:49:22.693 19616-19641/zhangphil.demo D/输出: 2,赵五,20,1511405362689
11-23 10:49:22.693 19616-19641/zhangphil.demo D/输出: 读数据库完毕.
11-23 10:49:22.693 19616-19641/zhangphil.demo D/输出: 删除数据库...
11-23 10:49:22.696 19616-19641/zhangphil.demo D/输出: 删除数据库完毕.
11-23 10:49:22.696 19616-19641/zhangphil.demo D/输出: 第3次读数据库
11-23 10:49:22.696 19616-19641/zhangphil.demo D/输出: 读数据库...
11-23 10:49:22.698 19616-19641/zhangphil.demo D/输出: 2,赵五,20,1511405362689
11-23 10:49:22.698 19616-19641/zhangphil.demo D/输出: 读数据库完毕.
11-23 10:49:22.698 19616-19641/zhangphil.demo D/输出: ========================
11-23 10:49:22.698 19616-19641/zhangphil.demo D/输出: 本轮数据库操作事务全部结束
11-23 10:49:22.699 19616-19641/zhangphil.demo D/输出: ========================


附录:
1,《Android ORMLite数据库简介》链接:http://blog.csdn.net/zhangphil/article/details/46878075 
2,《Android ORMLite ForeignCollection关联外部集合》链接:http://blog.csdn.net/zhangphil/article/details/46891021 
2
1
查看评论

谷歌官方Android应用架构库——Room 持久化库

架构库版本:1.0.0 Alpha 2 - June 2, 2017Room提供了一个SQLite之上的抽象层,使得在充分利用SQLite功能的前提下顺畅的访问数据库。对于需要处理大量结构化数据的App来说,把这些数据做本地持久化会带来很大的好处。常见的用例是缓存重要数据块。这样当设备无法连网的时候...
  • fjnu_se
  • fjnu_se
  • 2017-06-17 23:25
  • 642

Android Room从入门到放弃

Android 2017 IO大会推出了官方数据库框架:Room。Room其实就只是对原生的SQLite API进行了一层封装。
  • u012735483
  • u012735483
  • 2017-12-07 17:15
  • 940

谷歌官方Android应用架构库——Room 持久化库

谷歌官方Android应用架构库——Room 持久化库
  • hubinqiang
  • hubinqiang
  • 2017-06-11 05:09
  • 8347

Android Component Room Database 实践过程 - A

Android Room Database
  • zkwsr
  • zkwsr
  • 2017-08-02 15:51
  • 1296

初探Architecture Components之Room

Room的初衷提起SQLite,作为Android开发者还是比较幸福的的,Android核心框架已为处理SQL提供了相当大的支持,API也非常强大,省起来很大的力气。但是其模板化处理方式,导致开发者花费大量的时间和精力去维护数据库: 在编译时,没有对原始SQL查询语句验证。随着表结构的更改,需要手动...
  • IO_Field
  • IO_Field
  • 2017-06-19 20:54
  • 3405

Android 架构组件之Room数据库 处理Schema export Error

Android 架构组件之Room数据库,报错:Schema export directory is not provided to the annotation processor so we cannot export the schema.
  • hexingen
  • hexingen
  • 2017-12-05 22:51
  • 1002

【原创译文】深入理解Android为什么不允许Room数据库对象间(外键)引用

【原创译文】深入理解Android为什么不允许Room数据库对象间(外键)引用译者zhangphil@csdn注:当我开始使用Android Room技术时候,Room明确禁止对象间外键引用,让我感觉不可思议,也觉得不正常,因为对象间引用几乎是所有ORM数据库技术非常普遍的设计和理念,并且这对开发者...
  • zhangphil
  • zhangphil
  • 2017-11-24 12:38
  • 849

Room---SQLite库

导入库见Architecture使用介绍Room的组成Room由三个部分组成:Database、Entity和Dao。 1. Database:这个注解用来创建数据库。注释的参数用来指定包括的entities,所注解类的内容用来定义数据库里的DAO(Data Access Object)。所注解的...
  • timshinlee
  • timshinlee
  • 2017-07-03 20:13
  • 280

Android - Android Architecture Components - Room 在 Kotlin 中使用 (1)

参考文章Android Room 官方文档Room Persistence Library(官网文档翻译)在kotlin中使用room(Room Persistence Library)和遇到的坑Android官方ORM框架ROOM(Google I/O 2017)啰嗦对 Room 不了解的可以看上...
  • LABLENET
  • LABLENET
  • 2017-08-03 12:56
  • 3376

Android Room联合AsyncListUtil实现RecyclerView分页加载ORM数据

Android Room联合AsyncListUtil实现RecyclerView分页加载ORM数据我之前写了一系列关于AsyncListUtil实现RecyclerView和ListView的分页加载机制和技术路线,见附录文章4,5。同时也写了一些列文章介绍Android官方推出的ORM数据库:R...
  • zhangphil
  • zhangphil
  • 2017-11-29 09:54
  • 1841
    个人资料
    • 访问:1613247次
    • 积分:21023
    • 等级:
    • 排名:第450名
    • 原创:565篇
    • 转载:13篇
    • 译文:2篇
    • 评论:326条
    关于我
    邮箱: zhangphil@live.com
    博客专栏