引入依赖
implementation 'android.arch.persistence.room:runtime:1.1.1'
annotationProcessor 'android.arch.persistence.room:compiler:1.1.1'
使用
我们需要一个Entity、一个Dao和一个DataBase。
1、使用@Entity注解,表明这个是其中一张表,另外,如果在属性的签名不加任何注解的话,这个属性就是一个字段名,当然,如果你不想直接使用属性名作为字段名的话,可以加上 @ColumnInfo(name = “message”)进行自定义。如果这个实体类的某个字段不想存进数据库的话,可以加上@Ingore.是否是主键、外键等也有对应的注解。
@Entity(tableName = RoomConstant.FIRST_TABLE)
public class FirstTable {
@PrimaryKey(autoGenerate = true)
private int id;
@ColumnInfo(name = "message")
private String message;
public String getInfo() {
return info;
}
public void setInfo(String info) {
this.info = info;
}
@ColumnInfo(name = "info")
private String info;
public void setMessage(String message){
this.message = message;
}
public int getId() {
return id;
}
public String getMessage() {
return message;
}
public void setId(int id) {
this.id = id;
}
}
2、Dao类,这个类的作用是配置对应的数据库操作方法,比如查询、更新、删除等,注意,类名前面需要@Dao注解。如果是全部查询、删除等操作,可以直接传入对应的entry类,如果是根据某个字段去查询,需要自己写对应的sql语句。
@Dao
public interface BaseDao<T> {
@Insert
void insertItem(T item);//插入单条数据
@Insert
void insertItems(List<T> items);//插入list数据
@Delete
void deleteItem(T item);//删除item
@Update
void updateItem(T item);//更新item
}
@Dao
public interface FistTableDao extends BaseDao<FirstTable>{
//如果是查询
@Query("SELECT * FROM first_table")
List<FirstTable> getAll();
@Query("SELECT * FROM first_table WHERE id IN (:ids)")
List<FirstTable> loadAllByIds(int[] ids);
@Query("SELECT * FROM first_table WHERE :message LIKE :message")
FirstTable findByMessage(String message);
}
3、使用@DataBase注解。里面需要配置你要操作的entry类,可以配置一个或者多个,version表名这个是哪个版本,如果升级需要修改的就是这里。allowMainThreadQueries表明是否可以在主线程进行操作。配置abstract FistTableDao userDao(); 就可以获取到进行数据库操作的实例。
@Database(entities = {FirstTable.class, SecondTable.class, ThirdTable.class}, version = RoomConstant.VERSION, exportSchema = false)
public abstract class MyRoomDataBase extends RoomDatabase {
private static MyRoomDataBase mInstance;
public static MyRoomDataBase getInstance(Context context) {
if (mInstance == null) {
synchronized (MyRoomDataBase.class) {
if (mInstance == null) {
mInstance = Room.databaseBuilder(context, MyRoomDataBase.class, DB_NAME)
.fallbackToDestructiveMigration() //直接删除旧版数据
//.allowMainThreadQueries() //可以在主线程操作
.build();
}
}
}
return mInstance;
}
public static void onDestroy() {
mInstance = null;
}
public abstract FistTableDao userDao();
public abstract SecondTableDao secondTableDao();
public abstract ThirdTableDao thirdTableDao();
}
4、查询
MyRoomDataBase myRoomDataBase = MyRoomDataBase.getInstance(baseContext);
private static void operateFristTable(MyRoomDataBase myRoomDataBase) {
FistTableDao fistTableDao = myRoomDataBase.userDao();
FirstTable firstTable = new FirstTable();
firstTable.setMessage("firstTableMessage1");
firstTable.setInfo("第一个表");
fistTableDao.insertItem(firstTable);
//firstTable.delete(firstTable);
FirstTable item = fistTableDao.findByMessage("firstTableMessage1");
if (item != null) {
Log.d(TAG, item.getInfo());
}
List<FirstTable> firstTableList = fistTableDao.loadAllByIds(new int[]{0,1,2});
if (firstTableList != null) {
Log.d(TAG, "<-firstTableSize->" + firstTableList.size());
}
}