Jetpack学习之Room的简单使用(四)

前言

学习记录下Jetpack Room的基本使用，虽然没用过，但是出去面试万一人家一问，都不知道，就挺尴尬了，虽然我不用，但是我得知道有这个东东。
这里也说个题外话，新技术层出不穷，每天都在有新事物的出现，不可能把所有的东西都搞明白原理(天才除外)，人的精力是有限的。有些东西可能学的再透彻，也不会用到，有些东西，可能只读过一段话，就终身受益。废话不说了，接着记录学习笔记。

一、Room是什么？

Room 是 Jetpack架构中的工具，是对sqlite的上层封装，可以让我们更灵活，简单的使用sqlite数据库。

看下怎么使用

1.导入依赖

def room_version = "2.2.6"
implementation "androidx.room:room-runtime:$room_version"
annotationProcessor "androidx.room:room-compiler:$room_version" // For Kotlin use kapt instead of annotationProcessor
// optional - Kotlin Extensions and Coroutines support for Room 可选对 kotlin的支持
//  implementation "androidx.room:room-ktx:$room_version"
// optional - RxJava support for Room 可选 RxJava的支持
//  implementation "androidx.room:room-rxjava2:$room_version"
// optional - Guava support for Room, including Optional and ListenableFuture 可选 guava支持
//  implementation "androidx.room:room-guava:$room_version" 
// Test helpers 测试
//  testImplementation "androidx.room:room-testing:$room_version"

这里只导入主要的 room-runtime和room 注释处理器，根据需要导入可选项，这里就不导入可选项了。

2.Room使用

Room 框架使用中包含了大量的注解，这里主要使用3种，其它的用到再百度。

Entity（实体类）

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

@Entity
public class Person {

    @PrimaryKey(autoGenerate = true)
    public int _id;
    
    public String name;

    public String gender;
}

注意导包都是room包下的，不要导错

DAO（Data Access Object, 数据访问对象）

import androidx.lifecycle.LiveData;
import androidx.room.Dao;
import androidx.room.Delete;
import androidx.room.Insert;
import androidx.room.Query;
import androidx.room.Update;

import java.util.List;

@Dao
public interface PersonDao {

    @Insert
    void insert(Person... person);

    @Delete
    void delete(Person... person);

    @Update
    void update(Person... person);

    @Query("SELECT * FROM PERSON")
    List<Person> queryAll();
}

注意这是一个接口，里面声明了操作数据的方法(增删改查)，使用不同的注解，完成不同的操作。

@Database(数据库类)

@Database(entities = {Person.class}, version = 1)
public abstract class PersonDatabase extends RoomDatabase {

    private static PersonDatabase INSTANCE;

    public static PersonDatabase getInstance(Context context) {
        if (INSTANCE == null) {
            synchronized (PersonDatabase.class) {
                if (INSTANCE == null) {
                    INSTANCE = Room.databaseBuilder(context, PersonDatabase.class, "person_database")
                            .allowMainThreadQueries() // 允许在主线程中操作数据
                            .build();
                }
            }
        }
        return INSTANCE;
    }

    public abstract PersonDao getPersonDao();
}

使用Database注解时，需要传入实体类，多个实体类用逗号分隔，和数据库版本号。
这里请注意是一个抽象的类，有一个获取Dao的抽象方法。Room的注解处理器会帮我们自动生成对应的实现类：

这里还要注意下使用Room.databaseBuilder生成的Database默认不能在主线程中进行数据库操作，我们需要调用 allowMainThreadQueries 方法来支持在主线程中处理数据。实际根据需求来，如果有大量数据需要处理，可以使用线程池来处理数据库相关的操作。

这里简单示例，就直接在ViewModel中写了相关操作了。

public class MainViewModel extends AndroidViewModel {

    private PersonDatabase personDatabase;

    public MainViewModel(@NonNull Application application) {
        super(application);
        personDatabase = PersonDatabase.getInstance(application);
    }

    public void insert(Person... person) {
        personDatabase.getPersonDao().insert(person);
    }

    public void delete(Person... person) {
        personDatabase.getPersonDao().delete(person);
    }

    public void update(Person... person) {
        personDatabase.getPersonDao().update(person);
    }

    public List<Person> queryAll() {
        return personDatabase.getPersonDao().queryAll();
    }
}

然后就可以在MainActivity中操作数据库了，这里简单打印了下：

public class MainActivity extends AppCompatActivity {

    private ActivityMainBinding mBinding;

    private MainViewModel mainViewModel;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);

        mainViewModel = new ViewModelProvider(this, new ViewModelProvider.AndroidViewModelFactory(getApplication())).get(MainViewModel.class);
        mBinding.setLifecycleOwner(this);   // 关联生命周期

        mainViewModel.insert(new Person("小明", "男"));
        mainViewModel.insert(new Person("小强", "男"));
        mainViewModel.insert(new Person("小红", "女"));
        mainViewModel.insert(new Person("小亮", "男"));
        mainViewModel.insert(new Person("张三", "男"));

        List<Person> listLiveData = mainViewModel.queryAll();
        Log.i("person", "size->" + listLiveData.size());
    }
}