查看: 2790|回复: 0

[Android教程] Android Room框架学习笔记

发表于 2018-3-24 10:13:49
一、使用

1、build.gradle引入

  1. compile "android.arch.persistence.room:runtime:1.0.0"
  2. annotationProcessor 'android.arch.persistence.room:compiler:1.0.0'
复制代码

如果少了第二行引入,会报错:

Caused by: java.lang.RuntimeException: cannot find implementation for com.hy.room.HyDatabase. HyDatabase_Impl does not exist

2、新建一个实体类

  1. @Entity(indices = {@Index(value = "firstName", unique = true)})
  2. public class User {
  3. @PrimaryKey(autoGenerate = true)
  4. public int id;
  5. public String firstName;
  6. public String lastName;
  7. public int age;
  8. @Ignore
  9. private Bitmap bitmap;
  10. @Embedded
  11. public Address address;
  12. }
复制代码

3、建立Dao类接口

  1. @Dao
  2. public interface UserDao {
  3. @Insert
  4. public long[] insertUsers(User... users);
  5. @Insert
  6. public void insertUserList(List<User> users);
  7. @Update
  8. public void updateUsers(User... users);
  9. @Delete
  10. public void deleteUsers(User... users);
  11. @Query("select * from User")
  12. public List<User> searchAllUsers();
  13. @Query("select * from User where :age > 18")
  14. public List<User> searchUsersByAge(int age);
  15. @Query("select firstName,age from user")
  16. public List<SimpleUser> searchAllSimpleUsers();
  17. @Query("select * from User where firstName like :name limit 1")
  18. public User searchUserByName(String name);
  19. }
复制代码

4、建立继承RoomDatabase的数据库管理虚类

  1. @Database(entities = {User.class}, version = 1)
  2. public abstract class HyDatabase extends RoomDatabase {
  3. public abstract UserDao userDao();
  4. }
复制代码

5、初始化数据库

  1. HyDatabase database = Room.databaseBuilder(this, HyDatabase.class, "room.db").build();
复制代码

6、操作举例(与RxJava配合使用)

  1. Observable.create(new ObservableOnSubscribe<String>() {
  2. @Override
  3. public void subscribe(ObservableEmitter<String> e) throws Exception {
  4. List<User> users = database.userDao().searchAllUsers();
  5. e.onNext(new Gson().toJson(users));
  6. }
  7. }).subscribeOn(Schedulers.io())
  8. .observeOn(AndroidSchedulers.mainThread())
  9. .subscribe(new Consumer<String>() {
  10. @Override
  11. public void accept(String s) throws Exception {
  12. textView.setText(s);
  13. }
  14. });
复制代码

子线程中查询出所有的用户(主线程操作数据库会报错),用Gson转换成json格式的字符串,主线程中再显示出来。


二、数据库升级

1、新建要增加实体类。


2、在database中entities注解加入新增的实体类,同时版本号加一。


3、初始化数据库的地方增加addMigrations()方法,实现Migration类,例如:


  1. HyDatabase database = Room.databaseBuilder(this, HyDatabase.class, "room.db")
  2. .addMigrations(migration)
  3. .build();
复制代码


  1. private Migration migration = new Migration(1,2) {
  2. @Override
  3. public void migrate(@NonNull SupportSQLiteDatabase database) {
  4. database.execSQL("CREATE TABLE `Book` (`id` INTEGER, "
  5. + "`name` TEXT, `owner` INTEGER, PRIMARY KEY(`id`))");
  6. }
  7. };
复制代码

表示从版本1升级到版本2,手动增加新增的表的sql。

三、总结

优点:


1、从上面例子可以看出,操作很简单,不需要像以前一样,从SqlLite查询出数据,再一个个属性装配到实体类中。


2、增删改查操作十分简便,只需要一个注解就搞定。


缺点:


1、不能用Android Debug Database在线查看数据库?


2、不能配置模糊查询条件?


3、数据库升级无法自动且未提供友好API,同样需要手写SQL语句,同时必须保证手写的SQL语句与创建的实体类中的注解完全一致,不然会报错,例如:


  1. java.lang.IllegalStateException: Migration didn't properly handle Book(com.hy.room.Book).
  2. Expected:TableInfo{name='Book', columns={name=Column{name='name', type='TEXT', notNull=false, primaryKeyPosition=0}, owner=Column{name='owner', type='INTEGER', notNull=true, primaryKeyPosition=0}, id=Column{name='id', type='INTEGER', notNull=true, primaryKeyPosition=1}}, foreignKeys=[], indices=[]}
  3. Found:
  4. TableInfo{name='Book', columns={name=Column{name='name', type='TEXT', notNull=false, primaryKeyPosition=0}, owner=Column{name='owner', type='INTEGER', notNull=false, primaryKeyPosition=0}, id=Column{name='id', type='INTEGER', notNull=false, primaryKeyPosition=1}}, foreignKeys=[], indices=[]}
复制代码


四、神坑

1、报错

  1. java.lang.RuntimeException: cannot find implementation for com.hiten.base.db.DbHoc. DbHoc_Impl does not exist
  2. at android.arch.persistence.room.Room.getGeneratedImplementation(Room.java:92)
  3. at android.arch.persistence.room.RoomDatabase$Builder.build(RoomDatabase.java:454)
  4. at com.hiten.base.manager.ManagerDb.init(ManagerDb.java:21)
  5. at com.hiten.base.ApplicationHoc.onCreate(ApplicationHoc.java:52)
复制代码

log说找不到_impl实现类,看来是编译的问题。查看配置和代码,发现都没有问题,经过几个小时的尝试,终于发现还是配置的问题,问题出在这行:

  1. annotationProcessor "android.arch.persistence.room:compiler:1.0.0"
复制代码

我们所有的第三方引入都在third这个module里面,然后在其他module写业务代码,上面那行代码只配置在thrid上面,导致执行的module没有运行编译room的代码,所以自然没有生成实现类。在使用room的module也要加上上面那行代码。



参考:

官方文档(需FQ)


谷歌官方Android应用架构库——Room 持久化库






回复

使用道具 举报