Android Room 实现简单的增删改查（一）

大丈夫生于天地间，不识其主而事之，是无智也！今日受死，夫何足惜！——田丰

以前我们在开始学习Android开发的时候，首选接触的就是SQLITE数据库，有后来的greenDao数据库、realm数据等。可以查看greenDao官网日志信息，从greenDao第一个版本到最后更新的时间2017-04-05。realm数据库从第一个版本到最后一个版本是2019年12月17日。为什么我要在做开发要了解三方库的更新时间呢？？开发者也要跟上技术时代的节奏，尽量用最新的东西，便于我们在工作中更好的去解决问题。今天我要提及的是在SQLite的基础上建立抽象层的Room框架，Room不是数据库，只是对Sqlie做了一个改造，所以呢我们要把概念性的东西弄明白！！！！！！

一、Room 官网介绍：官网强烈建议使用Room

Room 在 SQLite 上提供了一个抽象层，以便在充分利用 SQLite 的强大功能的同时，能够流畅地访问数据库。

处理大量结构化数据的应用可极大地受益于在本地保留这些数据。最常见的用例是缓存相关数据。这样，当设备无法访问网络时，用户仍可在离线状态下浏览相应内容。设备之后重新连接到网络后，用户发起的所有内容更改都会同步到服务器。

Sqlite保持数据。

二、依赖声明：

    dependencies {
      def room_version = "2.2.2"

      implementation "androidx.room:room-runtime:$room_version"
      annotationProcessor "androidx.room:room-compiler:$room_version" // For Kotlin use     
      kapt instead of annotationProcessor
    
    }
    

三、Room 架构

Data Access Objects：数据访问集

Persist changes back to db：数据持久化后返回到数据库

Get Entities from db：从数据库获取实体类

get/set field values：获取字段的值

Dao：包含用于访问数据库的方法

四、使用Room：

1、创建实体类User，实体类名可作为查询时用的表名。

import androidx.room.Entity;
import androidx.room.PrimaryKey;

@Entity
public class User {
    @PrimaryKey
    public int userId;//用户Id
    public String userName;//用户姓名
    public String userAge;//用户年龄
}

2、创建数据访问接口（接口里面包含增删改查方法）

接口定义标明注解@Dao；插入数据标明@Insert注解；修改数据标明@update；删除数据标明@Delete注解；查询标明@Query注解；

import androidx.room.Dao;
import androidx.room.Delete;
import androidx.room.Insert;
import androidx.room.Query;
import androidx.room.Update;
import com.example.entity.User;
import java.util.List;
@Dao
public interface UserDao {
    //插入
    @Insert
    void addUser(User... users);

    @Insert
    void addUser(User user);

    //修改
    @Update
    void updateUser(User user);

    //删除
    @Delete
    void deleteUser(User user);

    //获取User
    @Query("SELECT * FROM user WHERE userName=:userName")
    User getUser(String userName);

    //查询
    @Query("SELECT * FROM User")
    List getUsers();
}

3、创建继承RoomDatabase抽象类的抽象类，我这里命名为MyAppDatabase；entities包含与数据库关联的实体类列表，version是是数据库版本号。

import androidx.room.Database;
import androidx.room.RoomDatabase;

import com.example.entity.User;

@Database(entities = {User.class}, version = 1)
public abstract class MyAppDatabase extends RoomDatabase {
    public abstract UserDao userDao();
}

4、创建User管理类，进行增加、删除、修改、查询用户信息：

官方原话提示：如果您的应用在单个进程中运行，则在实例化 AppDatabase 对象时应遵循单例设计模式。每个 RoomDatabase 实例的成本相当高，而您几乎不需要在单个进程中访问多个实例。

import android.content.Context;
import androidx.room.Room;
import com.example.entity.User;
import java.util.List;
public class UserManager {
    private static MyAppDatabase mDb;
    public static MyAppDatabase getIntance(Context context) {
        if (mDb == null) {
            mDb = Room.databaseBuilder(context,
                    MyAppDatabase.class,
                    "user.db").build();
        }
        return mDb;
    }
    //新增
    public static synchronized void addUser(Context context, User user) {
        getIntance(context).userDao().addUser(user);
    }
    //查询
    public static synchronized User getUser(Context context, String userName) {
        return getIntance(context).userDao().getUser(userName);
    }
    //删除
    public static synchronized void deleteUser(Context context, User user) {
        getIntance(context).userDao().deleteUser(user);
    }
    //修改
    public static synchronized void updateUser(Context context, User user) {
        getIntance(context).userDao().updateUser(user);
    }
    //获取用户信息
    public static synchronized List getUsers(Context context) {
        return getIntance(context).userDao().getUsers();
    }
}

5、测试：

首选我们调用插入数据，报错了。。。大概意思就是不允许在主线程上访问数据库，会导致UI卡死：

官方文档原话：

User管理类的代码变更如下：

 private static MyAppDatabase mDb;

    public static MyAppDatabase getIntance(Context context) {
        if (mDb == null) {
            mDb = Room.databaseBuilder(context,
                    MyAppDatabase.class,
                    "user.db")
                    .allowMainThreadQueries()
                    .build();
        }
        return mDb;
    }

再一次通过我的案例的界面进行操作，先后操作增加用户信息、查询用户信息、删除用户信息、查询用户信息：

日志输出信息：I/System.out: 姓名_0

6、SQLScout插件查看数据内容：

先下载SQLScout插件（格式ZIP），将插件安装到Android Studio上。

通过Android Studio菜单栏View 导航到 Tool Windows，找到Device File Explorer。

在data/data/应用包名/database目录下找到数据库：

导航到Sqlite Explorer 可以查看db数据库数据：

案例下载地址

SQLScout 插件