Room数据库使用

前言
正文
- 一、添加依赖
- 二、注解使用
- 三、表操作
- - 1. 修改布局
  - 2. 列表适配器
  - 3. 页面初始化
  - 4. 增删改查
- 四、源码

前言

Room数据库是Google的JitPack组件中的一个，推出已经有一段时间了，现在的使用者也越来越多，Room是一个轻量级的ORM（Object Relational Mapping：对象关系映射）数据库。本质上就是对Android原生的SQLite的封装，只不过使用起来比原生简单，就好像一些开源库GreenDao、LitePal、OrmLite等，都是对Android SQLite的再次封装。

运行效果图

正文

Google既然在JitPack中推出了Room，那就说明这个库确实有一定的优势。

Room其实和Retrofit差不多，Room在开发阶段通过注解的方式标记相关功能，编译时自动生成响应的impl实现类。

一、添加依赖

首先创建一个Android项目，命名为RoomDemo，我的AS是4.2.1。

然后打开app下的build.gradle。在dependencies{}闭包中添加如下依赖：

 //roomdef room_version = "2.3.0"implementation "androidx.room:room-runtime:$room_version"annotationProcessor "androidx.room:room-compiler:$room_version"

这里有两个库一个是依赖库，一个是注解处理器库。2.3.0表示room最新的依赖库版本。

点击Sync进行同步一下。

二、注解使用

注解使用，Room使用很简单的，这里有三个基本的使用注解，@Database、@Entity、@Dao。分别对于数据库、表、表的具体操作（增删改查）。

例如创建一个数据表User。先创建包名，在com.llw.roomdemo下创建一个db包，db下创建bean包，bean包下创建User类。

@Entity
public class User {@PrimaryKey(autoGenerate = true)@NonNullpublic int id;@ColumnInfo(name = "user_name", defaultValue = "")public String userName;@ColumnInfo(name = "user_age")public int userAge;@ColumnInfo(name = "nick_name")public String nickName;@ColumnInfo(name = "address")public String address;public User(String userName, int userAge, String nickName, String address) {this.id = id;this.userName = userName;this.userAge = userAge;this.nickName = nickName;this.address = address;}
}

这个类很平常，主要是注解的说明，这个@Entity就是表示数据库中的表，User类对应就是User表，@PrimaryKey表示主键，这里是id，autoGenerate = true 是自增，@NonNull表示不为空。 @ColumnInfo表示表中的列名，name = "user_name"表示列名的值。

Room是对象关系映射型数据库，所以你可以不用写这个@ColumnInfo注解，写它主要是为了设置列名，不写则使用变量名做为列名。

假设我一个表中有30个字段，实际上用到的只有5个，那么另外25个就不需要进行创建了，则使用@Ignore注解进行忽略。
例如这样：

 @Ignore@ColumnInfo(name = "address")public String address;

下面在db包下新建一个dao包，创建UserDao，里面的代码如下：

@Dao
public interface UserDao {/*** 增加** @param users 用户*/@Insert(onConflict = OnConflictStrategy.REPLACE)void insertUser(User... users);/*** 查询所有用户* @return 用户列表*/@Query("SELECT * FROM user")List<User> queryAll();/*** 按用户名查询* @param userName 用户名* @return 用户*/@Query("SELECT * FROM user WHERE user_name LIKE :userName LIMIT 1")User findByName(String userName);/*** 修改* @param user 根据用户进行修改*/@Updatevoid update(User user);/*** 删除* @param user 根据用户进行删除*/@Deletevoid delete(User user);
}

UserDao是一个接口，主要是定义了一些方法，通过注解在编译的时候会生成实现类。

下面是数据库的创建，在db包下新建一个MyDatabase类，继承RoomDatabase，代码如下：

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

这里的@Database注解表示这个类是用来操作数据库的，entities = {User.class}表示当前数据库中的表，只有一个User表，多的表用应用逗号隔开。version = 1表示数据库的版本，可以做数据库的升级操作。

注意这是一个抽象类，在编译时Room会帮助构建实现类。

现在运行一下，手机或者模拟器都可以。然后什么都不用去做。

可以查看到，MyDatabase和UserDao的实现类都自动生成了。

三、表操作

表操作无非就是那么几个，增删改查，但是为了更直观的显示结果，需要对UI做一些改动。

在工程的build.gradle中增加repositories闭包中增加jitpack库。

maven { url "https://jitpack.io" }

然后在app的build.gradle中的dependencies{}比包中增加

implementation 'com.github.CymChad:BaseRecyclerViewAdapterHelper:3.0.4'

1. 修改布局

Sync一下，下面修改一下页面的布局文件activity_main.xml。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"android:orientation="vertical"tools:context=".MainActivity"><Buttonandroid:id="@+id/btn_add"android:layout_width="match_parent"android:layout_height="wrap_content"android:text="Add"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent" /><Buttonandroid:id="@+id/btn_delete"android:layout_width="match_parent"android:layout_height="wrap_content"android:text="Delete" /><Buttonandroid:id="@+id/btn_update"android:layout_width="match_parent"android:layout_height="wrap_content"android:text="Update" /><Buttonandroid:id="@+id/btn_query"android:layout_width="match_parent"android:layout_height="wrap_content"android:text="Query" /><androidx.recyclerview.widget.RecyclerViewandroid:id="@+id/rv"android:layout_width="match_parent"android:layout_height="match_parent" />
</LinearLayout>

这里就是四个按钮和一个列表，当操作按钮时列表数据更新。下面创建列表的item布局。

在layout下新建一个item_rv.xml布局，代码如下：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="wrap_content"><TextViewandroid:id="@+id/tv_id"android:layout_width="wrap_content"android:layout_height="wrap_content"android:padding="10dp"android:text="Id"android:textColor="@color/black"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toTopOf="parent" /><TextViewandroid:id="@+id/tv_name"android:layout_width="wrap_content"android:layout_height="wrap_content"android:padding="10dp"android:text="name"android:textColor="@color/black"app:layout_constraintStart_toEndOf="@+id/tv_id"app:layout_constraintTop_toTopOf="parent" /><TextViewandroid:id="@+id/tv_age"android:layout_width="wrap_content"android:layout_height="wrap_content"android:padding="10dp"android:text="age"android:textColor="@color/black"app:layout_constraintStart_toEndOf="@+id/tv_name"app:layout_constraintTop_toTopOf="parent" /><TextViewandroid:id="@+id/tv_nickname"android:layout_width="wrap_content"android:layout_height="wrap_content"android:padding="10dp"android:text="nickname"android:textColor="@color/black"app:layout_constraintStart_toEndOf="@+id/tv_age"app:layout_constraintTop_toTopOf="parent" /><TextViewandroid:id="@+id/tv_address"android:layout_width="0dp"android:layout_height="wrap_content"android:ellipsize="end"android:padding="10dp"android:text="address"android:textColor="@color/black"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintStart_toEndOf="@+id/tv_nickname"app:layout_constraintTop_toTopOf="parent" /><Viewandroid:id="@+id/view"android:layout_width="wrap_content"android:layout_height="1dp"android:background="#E1DFDF"app:layout_constraintEnd_toEndOf="parent"app:layout_constraintHorizontal_bias="0.0"app:layout_constraintStart_toStartOf="parent"app:layout_constraintTop_toBottomOf="@+id/tv_nickname" />
</androidx.constraintlayout.widget.ConstraintLayout>

在com.llw.roomdemo下新建一个adapter包，包下新建UserAdapter类，作为列表数据的适配器。代码如下：

2. 列表适配器

public class UserAdapter extends BaseQuickAdapter<User, BaseViewHolder> {public UserAdapter(int layoutResId, @Nullable List<User> data) {super(layoutResId, data);}@Overrideprotected void convert(@NotNull BaseViewHolder holder, User user) {holder.setText(R.id.tv_id, user.id).setText(R.id.tv_name, user.userName).setText(R.id.tv_age, user.userAge).setText(R.id.tv_nickname, user.nickName).setText(R.id.tv_address, user.address);}
}

3. 页面初始化

现在回到MainActivity，页面初始化，先声明两个变量

 public static final String TAG = MainActivity.class.getSimpleName();private MyDatabase db;private List<User> mList = new ArrayList<>();private UserAdapter mAdapter;

然后新建一个initView方法，完成对页面控件的初始化，代码如下：

 /*** 初始化*/private void initView() {findViewById(R.id.btn_add).setOnClickListener(this);findViewById(R.id.btn_delete).setOnClickListener(this);findViewById(R.id.btn_update).setOnClickListener(this);findViewById(R.id.btn_query).setOnClickListener(this);//列表RecyclerView rv = findViewById(R.id.rv);mAdapter = new UserAdapter(R.layout.item_rv,mList);rv.setLayoutManager(new LinearLayoutManager(this));rv.setAdapter(mAdapter);//数据库db = MyApplication.getDb();}

这个方法中首先是对按钮的点击设置监听回调，其次是对列表和适配器进行数据的绑定，页面的MainActivity需要实现View.OnClickListener接口。

重写里面的onClick方法。等会的数据库表操作就是通过这里的点击事件进行触发。

 @Overridepublic void onClick(View v) {switch (v.getId()){case R.id.btn_add:break;case R.id.btn_delete:break;case R.id.btn_update:break;case R.id.btn_query:break;default:break;}}

在onCreate方法中调用这个initView方法。

initDB方法：

 /*** 初始化数据库*/private void initDB() {//本地持久化数据库db = Room.databaseBuilder(getApplicationContext(), MyDatabase.class, "DemoDB")//是否允许在主线程上操作数据库，默认false。.allowMainThreadQueries()//数据库创建和打开的事件会回调到这里，可以再次操作数据库.addCallback(new CallBack()).build();}

CallBack

 static class CallBack extends RoomDatabase.Callback {@Overridepublic void onCreate(@NonNull SupportSQLiteDatabase db) {super.onCreate(db);Log.d(TAG, "db create");}@Overridepublic void onOpen(@NonNull SupportSQLiteDatabase db) {super.onOpen(db);Log.d(TAG, "db open");}}

下面就可以进行数据库表的操作了，增删改查。

4. 增删改查

当前数据表中还没有任何数据，因此需要先增加数据。然后查询，删除后查询，修改后查询，这样增删改查就都涉及到了。
方法如下：

 /*** 增加用户*/private void addUser() {runOnUiThread(() -> {db.userDao().insertUser(new User("张三", 20, "张大炮", "北京八宝山4号墓地"),new User("李四", 60, "尼古拉斯.凯奇", "美国佛罗里达州"),new User("王五", 70, "爱新觉罗.爱国", "北京故宫乾清宫西北方向角落"),new User("赵六", 30, "叶赫那拉.啦啦啦", "北京前门外前门大街皮条胡同"));Toast.makeText(MainActivity.this,"增加成功",Toast.LENGTH_SHORT).show();});}/*** 删除用户*/private void deleteUser() {runOnUiThread(() -> {User user = db.userDao().findByName("张三");if (user == null) return;db.userDao().delete(user);Toast.makeText(MainActivity.this, "删除成功", Toast.LENGTH_SHORT).show();});}/*** 修改用户*/private void updateUser() {runOnUiThread(() -> {User user = db.userDao().findByName("李四");if (user == null) return;user.setUserName("赵四");user.setUserAge(10);user.setNickName("尼古拉斯.赵四");user.setAddress("中国东北");db.userDao().update(user);Toast.makeText(MainActivity.this, "修改成功", Toast.LENGTH_SHORT).show();});}/*** 查询所有用户*/private void queryAll() {runOnUiThread(() -> {mList.clear();mList.addAll(db.userDao().queryAll());mAdapter.notifyDataSetChanged();});}

运行的效果图如下：

四、源码

GitHub：RoomDemo
CSDN：RoomDemo.rar

山高水长，后会有期~

Android Room数据库使用相关推荐

android专题-数据库Room
android专题-数据库Room Room介绍 room是Google官方推荐的ORM数据库框架,抽象出sqlite访问的数据库. 包含三大组件: Entity 定义表结构,每个entity类对一 ...
android与mysql数据库同步_android开发如何通过web服务器访问MYSQL数据库并且使其数据同步到android SQLite数据库？...
通过web服务器访问MYSQL数据库有以下几个过程: 1.在MySql下创建自己的数据库和自己的表单 2.连接数据库. 3.访问数据库 1.创建web工程 (服务器端) 在Myeclipse下新建一个 ...
android 建数据库 SQLite 存储sd 卡或者内存
android 创建数据库调用SQLiteOpenHelper,一般不直接操作SQLiteDatabase . 是通过SQLiteOpenHelper来获取 public class DBOpenHe ...
android 数据库表格数据库数据库中,Android SQLite数据库中的表详解
Android SQLite数据库前言以前写PHP的时候,内置了print_r()和var_dump()两个函数用于打印输出任意类型的数据内部结构,现在做Android的开发,发现并没有这种类似的 ...
android面向数据库的的编程工具-OrmLite
数据库操作框架OrmLite ORMlite是类似hibernate的对象映射框架,主要面向java语言,同时,是时下最流行的android面向数据库的的编程工具. 对象关系映射(Object Rel ...
使用浏览器查看Android SQLite数据库-Android Debug Database用法
本文转载自[http://blog.csdn.net/o279642707/article/details/68946230] 前言 Android客户端查看sqlite数据库是很繁琐的事情,需要DD ...
利用SQLChiper对Android SQLite数据库加密
利用SQLChiper对Android SQLite数据库加密前言: 上篇文章讲了Android studio+SQLCipher加密SQLite数据库的几个坑,跳过这几个坑,那么SQLCipher ...
android SQLite数据库的使用
今天,简单讲讲android如何使用SQLite数据库. 最近,自己在做一个功能时又用到了SQLite数据库,发现自己还是掌握的不很全面.其实之前的app里面也一直用到了数据库,但是自己没有花时 ...
Android SQLite 数据库详细介绍
Android SQLite 数据库详细介绍我们在编写数据库应用软件时,需要考虑这样的问题:因为我们开发的软件可能会安装在很多用户的手机上,如果应用使用到了SQLite数据库,我们必须在用户初次使用软 ...
android 获取位置数据库,尝试从webview获取位置时，Android“SQLite数据库无法从/CachedGeoposition.db加载”错误...
我正在创建一个使用webkit和chrome客户端的android应用程序.我希望能够在网页请求时获取当前位置.我设置的网页适用于普通浏览器就好了.然而,当我尝试访问该网页WebKit中,我不断收到此 ...

Android Room数据库使用