Room 数据库基础Room 简介使用Room保存本地数据到数据库中Entity 实体DaoDatabase简单案例Room 简介Room 持久库提供了一个 SQLite 抽象层让你访问数据库更加稳健提升数据库性能。该库帮助您在运行应用程序的设备上创建应用程序的数据缓存。这个缓存是你的应用程序唯一的真实来源允许用户查看应用程序中关键信息的一致副本而不管用户是否有Internet连接。使用 Room 需要添加依赖dependencies { def room_version 2.2.0-alpha01 implementation androidx.room:room-runtime:$room_version annotationProcessor androidx.room:room-compiler:$room_version // use kapt for Kotlin // optional - RxJava support for Room implementation androidx.room:room-rxjava2:$room_version // optional - Guava support for Room, including Optional and ListenableFuture implementation androidx.room:room-guava:$room_version // Test helpers testImplementation androidx.room:room-testing:$room_version }使用Room保存本地数据到数据库中Room在SQLite上提供了一个抽象层以便在发挥SQLite能力的同时允许流畅的数据库访问。处理复杂的结构化数据的应用程序可以极大地受益于本地数据的持久化。最常见的用例是缓存相关的数据片段。这样当设备无法访问网络时用户仍然可以在离线时浏览该内容。在设备返回联机之后任何用户发起的内容更改都会同步到服务器。Room有3个主要的组件Database包含数据库持有者并充当与应用程序持久化的、关系型的数据的底层连接的主要访问点。用Database注解的类应满足以下条件是一个继承 RoomDatabase 的抽象类。在注释中包含与数据库相关联的实体列表。包含一个具有0个参数的抽象方法并返回用Dao注释的类。在运行时可以通过调用Room.databaseBuilder()或Room.inMemoryDatabaseBuilder()获取数据库实例。Entity表示数据库内的表。DAO: 包含用于访问数据库的方法。Entity 实体Entity这个注解是引用了 Room 库后出现的相当于定义了数据库中的一张表(table)。我们利用PrimaryKey(autoGenerate true)设置某个字段为主键并且自动生长。ColumnInfo(name “english_word”)给字段设置别名如果不设置就默认为变量名。利用 idea 快速生成构造器id 不需要作为参数因为id是系统自动生成的。利用 idea 快速生成get 与 set 方法id 可以写单没必要。建立一个 Word.java 文件利用注解标记为 Entity代码如下EntitypublicclassWord{// 实体类PrimaryKey(autoGeneratetrue)// 设置主键并且自动生长privateintid;ColumnInfo(nameenglish_word)// 设置别名如果不设置就默认为变量名privateString word;ColumnInfo(namechinese_meaning)privateString chineseMeaning;publicWord(String word,String chineseMeaning){this.wordword;this.chineseMeaningchineseMeaning;}publicintgetId(){returnid;}publicvoidsetId(intid){this.idid;}publicStringgetWord(){returnword;}publicvoidsetWord(String word){this.wordword;}publicStringgetChineseMeaning(){returnchineseMeaning;}publicvoidsetChineseMeaning(String chineseMeaning){this.chineseMeaningchineseMeaning;}}DaoDao 指的是 Database aceess object即访问数据库操作的接口。我们所有的数据库的操作都将在这里声明如增删改查。利用注解功能可以很方便的执行操作。Insert 表示插入记录。Update 表示修改数据库中的记录。Delete 表示删除数据库中记录。Query( ) 中可以写入SQL语句来执行操作。声明一个接口文件WordDao.java利用注解标记为 Dao代码如下Dao// Database aceess object 访问数据库操作的接口publicinterfaceWordDao{// 在这里声明数据库的操作如增删改查InsertvoidinsertWords(Word...word);// 可以传递三个参数UpdatevoidupdatWords(Word...words);DeletevoiddeleteWords(Word...words);Query(DELETE FROM WORD)voiddeleteAllWords();Query(SELECT * FROM WORD ORDER BY ID DESC)// 降序排列ListWordgetAllWords();}DatabaseDatabase 文件必须要继承 androidx.room.RoomDatabase并且得是抽象类。Database() 中必须指明 entities 传入我们之前创建的 entity这里是个集合可以传入多个值。version 作为版本号当数据库结构发生改变时数据库版本会增加以后会配合 Migration 进行数据迁移。建立一个 WordDatabases.java 文件利用注解标记为 Database代码如下Database(entities{Word.class},version1,exportSchemafalse)publicabstractclassWordDatabaseextendsRoomDatabase{publicabstractWordDaogetWordDao();// 若有多个 Entity则应该写多个 Dao}简单案例搭建如图界面来到 MainActiviry.xml 中代码如下updateView() 是用来刷新界面的每次对数据库进行操作后要通过页面来显示效果。值得注意的是数据库不允许在主线程中执行因为加载的资源如果但是我们可以通过allowMainThreadQueries() 强制允许在主线程执行在真实开发中不要这么做这里只是为了演示效果。Dao 模式与以前学习 JavaEE 时基本类似所以很好理解。publicclassMainActivityextendsAppCompatActivity{WordDatabase wordDatabase;WordDao wordDao;TextView textView;Button buttonInsert,buttonUpdate,buttonDelete,buttonClear;OverrideprotectedvoidonCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);textViewfindViewById(R.id.textView2);// allowMainThreadQueries() 强制允许在主线程执行真实开发中不要这么做wordDatabaseRoom.databaseBuilder(this,WordDatabase.class,word_database).allowMainThreadQueries().build();wordDaowordDatabase.getWordDao();updateView();buttonInsertfindViewById(R.id.buttonInsert);buttonUpdatefindViewById(R.id.buttonUpdate);buttonDeletefindViewById(R.id.buttonDelete);buttonClearfindViewById(R.id.buttonClear);buttonInsert.setOnClickListener(newView.OnClickListener(){OverridepublicvoidonClick(View view){Word word1newWord(Hello,你好);Word word2newWord(World,世界);wordDao.insertWords(word1,word2);updateView();}});buttonClear.setOnClickListener(newView.OnClickListener(){OverridepublicvoidonClick(View view){wordDao.deleteAllWords();updateView();}});buttonUpdate.setOnClickListener(newView.OnClickListener(){OverridepublicvoidonClick(View view){Word wordnewWord(good,真棒);word.setId(20);wordDao.updatWords(word);updateView();}});buttonDelete.setOnClickListener(newView.OnClickListener(){OverridepublicvoidonClick(View view){Word wordnewWord(,);word.setId(20);wordDao.deleteWords(word);updateView();}});}voidupdateView(){ListWordlistwordDao.getAllWords();String text;for(inti0;ilist.size();i){Word wordlist.get(i);textword.getId():word.getWord():word.getChineseMeaning()\n;}textView.setText(text);}}实现效果至于保存的数据库文件可以在存储中找到我们可以将数据库文件导出然后利用一些工具例如db Browser来查看数据。
