最近要做的项目要涉及到数据库,准备使用谷歌新出的架构组件Room,于是学习学习,记录一下。
[官方文档](https://developer.android.google.cn/topic/libraries/architecture/index.html)在这里,推荐一个系列的文章,很好的翻译了官方架构的文档——[理解Android Architecture Components系列](https://www.jianshu.com/nb/7889538)。
##1.引入
首先在project的gradle文件中添加 Google Maven 仓库
```
allprojects {
repositories {
jcenter()
google()
}
}
```
然后在APP的gradle文件中添加依赖
```
// Room (use 1.1.0-beta2 for latest beta)
implementation "android.arch.persistence.room:runtime:1.0.0"
annotationProcessor "android.arch.persistence.room:compiler:1.0.0"
```
##2.三大组成部分
Room由三大部分组成
1. Entity:数据库中表对应的Java实体
2. DAO:操作数据库的方法
3. Database:创建数据库
###2.1Entity
Entity就是一般的Java实体类
这里只涉及到@Entity、 @PrimaryKey,2个注解。其实有其他好多注解,比如 @ColumnInfo(列名)、 @ForeignKey(外键)、@Index(索引)等等,具体用法还是看官方文档吧。
```
@Entity
public class UserEntity {
@PrimaryKey(autoGenerate = true)
private int uid;
private String name;
private String address;
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public int getUid() {
return uid;
}
public void setUid(int uid) {
this.uid = uid;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
@Override
public String toString() {
return "UserEntity{" +
"uid=" + uid +
", name='" + name + '\'' +
", address='" + address + '\'' +
'}';
}
}
```
##2.2 DAO
DAO的话就是创建一些访问数据库的方法
通过注解的方式实现增(@Insert)删(@Delete)改(@Update)查(@Query)
可以通过“:xxx”的方式引入参数
```
@Dao
public interface UserDao {
@Insert
void insert(UserEntity userEntity);
@Insert
void insertAll(List<UserEntity> userEntities);
@Delete
void delete(UserEntity userEntity);
@Delete
void deleteAll(List<UserEntity> userEntities);
@Update
void update(UserEntity userEntity);
@Query("SELECT * FROM UserEntity")
List<UserEntity> getAll();
@Query("SELECT * FROM UserEntity WHERE uid = :uid")
UserEntity getByUid(int uid);
}
```
##2.3 Database
上面两个文件建好后,就可以创建数据库了
要在里面声明你创建的DAO:public abstract UserDao userDao();
参考的是[官方demo BasicSample](https://github.com/googlesamples/android-architecture-components)
```
@Database(entities = {UserEntity.class},version = 1)
public abstract class AppDatabase extends RoomDatabase{
private static volatile AppDatabase sInstance;
@VisibleForTesting
public static final String DATABASE_NAME = "XXXdb";
/**
* LiveData相关,具体看上面推荐的系列文章LiveData