詳細介紹Android-Room數(shù)據(jù)庫的使用
前言
Google終于發(fā)布了一個和SQLite相關的庫了。之前一直都是在SQLite、XUtils、greenDao、Realm這些數(shù)據(jù)庫之間來回折騰?,F(xiàn)在終于有一個更“正統(tǒng)”數(shù)據(jù)庫了。
Room是什么?
Room是一個持久性數(shù)據(jù)庫。
Room持久性庫提供了SQLite的抽象層,以便在充分利用SQLite的同時允許流暢的數(shù)據(jù)庫訪問。
為什么會選擇Room?
前面我也說到了現(xiàn)在也有不少開源的數(shù)據(jù)庫給大家使用,那為什么我們還要去學習使用這個庫呢?當然不是我前面說的“正不正統(tǒng)”的原因了。
因為Room有下面幾個優(yōu)點:
① SQL查詢在編譯時就會驗證 - 在編譯時檢查每個@Query和@Entity等,這就意味著沒有任何運行時錯誤的風險可能會導致應用程序崩潰(并且它不僅檢查語法問題,還會檢查是否有該表)
② 較少的模板代碼
③ 與 LiveData 集成
該如何使用它?
1、在app/build.gradle中添加以下依賴
implementation 'android.arch.persistence.room:runtime:1.0.0' annotationProcessor 'android.arch.persistence.room:compiler:1.0.0'
你可以點擊這里查看最新依賴版本號
2、創(chuàng)建JavaBean
@Entity public class User { @PrimaryKey(autoGenerate = true)//主鍵是否自動增長,默認為false private int id; private String name; private int age; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } //這里的getter/setter方法是必須的 //這里的getter/setter方法是必須的 //這里的getter/setter方法是必須的 //重要的事說三遍 }
這里需要使用 @Entity 來注解該類
至少要有一個主鍵 @PrimaryKey
3、創(chuàng)建Dao
接下來,需要為我們的實體創(chuàng)建DAO。 DAO代表數(shù)據(jù)訪問對象,所以它是告訴我們的數(shù)據(jù)庫如何操作數(shù)據(jù)的一種方式:
@Dao public interface UserDao { @Query("SELECT * FROM user") List<User> getAllUsers(); @Insert void insert(User... users); @Update void update(User... users); @Delete void delete(User... users); }
使用 @Dao 注解該接口
@Insert , @Update , @Delete , @Query 代表我們常用的 插入 、 更新 、 刪除 、 查詢 數(shù)據(jù)庫操作
@Insert , @Update , @Delete 可以傳入多種不同的參數(shù)。例如:
@Insert void insert(User... users); @Insert void insert(User user); @Insert void insert(List<User> userLists);
同理, @Query 也可以返回多種不同的類型。
@Query("SELECT * FROM user") List<User> getAllUsers(); @Query("SELECT * FROM user WHERE id=:id") User getUser(int id); @Query("SELECT * FROM user") Cursor getUserCursor();
當然,除了這些我們還可以傳入一些限制符進去。例如,
@Query("SELECT * FROM user WHERE age=:age") List<User> getUsersByAge(int age); @Query("SELECT * FROM user WHERE age=:age LIMIT :max") List<User> getUsersByAge(int max, int... age);
4、創(chuàng)建數(shù)據(jù)庫
@Database(entities = { User.class }, version = 1,exportSchema = false) public abstract class UserDatabase extends RoomDatabase { private static final String DB_NAME = "UserDatabase.db"; private static volatile UserDatabase instance; static synchronized UserDatabase getInstance(Context context) { if (instance == null) { instance = create(context); } return instance; } private static UserDatabase create(final Context context) { return Room.databaseBuilder( context, UserDatabase.class, DB_NAME).build(); } public abstract UserDao getUserDao(); }
這里使用 @Database 注解該類并添加了 表名 、 數(shù)據(jù)庫版本 (每當我們改變數(shù)據(jù)庫中的內(nèi)容時它都會增加),所以這里使用 exportSchema = false
注意:除了添加表映射的類以及和數(shù)據(jù)庫版本外,還要添加 exportSchema = false 否則會報警告。
Error:(10, 17) 警告: Schema export directory is not provided to the annotation processor so we cannot export the schema. You can either provide room.schemaLocation annotation processor argument OR set exportSchema to false.
我們抽象了 getUserDao() 方法,這是必要的。
5、使用數(shù)據(jù)庫
我們終于能夠操作我們的數(shù)據(jù)庫了。但是所有的操作必須在后臺線程中完成。你可以通過使用 AsyncTask , Thread , Handler , RxJava 或其它方式來完成。
如果沒有在后臺線程執(zhí)行,并且也沒有說明可以在主線程操作的話,就會報以下錯誤。
Caused by: java.lang.IllegalStateException: Cannot access database on the main thread since it may potentially lock the UI for a long period of time.
例如,我們可以像下面這樣插入數(shù)據(jù)
User user=new User(); user.setName("name1"); user.setAge(18); UserDatabase .getInstance(context) .getUserDao() .insert(user);
或者這樣
List<User> allUsers = UserDatabase .getInstance(RoomActivity.this) .getUserDao() .getAllUsers();
好了,基本的使用的方式就這些了。
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
Android中RecyclerView實現(xiàn)橫向滑動代碼
這篇文章主要介紹了Android中RecyclerView實現(xiàn)橫向滑動代碼的相關資料,非常不錯,具有參考借鑒價值,需要的朋友可以參考下2016-07-07ViewPager和SlidingPaneLayout的滑動事件沖突解決方法
下面小編就為大家分享一篇ViewPager和SlidingPaneLayout的滑動事件沖突解決方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-01-01Android實現(xiàn)沉浸式通知欄通知欄背景顏色跟隨app導航欄背景顏色而改變
這篇文章主要介紹了Android實現(xiàn)沉浸式通知欄通知欄背景顏色跟隨app導航欄背景顏色而改變的相關資料,需要的朋友可以參考下2016-02-02Android編程中TextView字體屬性設置方法(大小、字體、下劃線、背景色)
這篇文章主要介紹了Android編程中TextView字體屬性設置方法,包括大小、字體、下劃線、背景色等設置技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-10-10Android UI自定義ListView實現(xiàn)下拉刷新和加載更多效果
這篇文章主要介紹了Android UI自定義ListView實現(xiàn)下拉刷新和加載更多效果,具有一定的參考價值,感興趣的小伙伴們可以參考一下2016-11-11