前言
Android Architecture Components（AAC）首次发布与2017 GoogleI/O大会，经过近一年的维护，现在Google团队已经发布了稳定版（v1.1.1）。能够更好的帮助我们来构建自己的App应用，如果你还没有了解ACC现在时间刚刚好，来不及解释，赶紧上车吧。
ACC是一个架构组件，它能帮忙我们更好的来管理我们的App，方便我们的开发。它能帮助我们的App更好的存储数据、管理生命周期、进行模块化、避免常见的错误、减少样板文件的编写。
ACC主要由4个单一组件组成，分别为：Room、LiveData、Lifecycle与ViewModel。它们每一个都是独立存在的组件，我们可以单独使用其中几个，又或者可以将它们全部整合到一起。所以对于ACC它提供了更好的使用灵活性，方便我们集成到我们的App中。
今天主要是对ACC其中的Room组件进行分析。Room是一个稳健的SQL对象映射库，用来帮助我们快速的实现数据本地存储。至于为何要使用本地数据库，自然是当用户无网络或者网络差的时候，能够更好的提高用户对我们App的体验。
添加依赖
在使用Room之前，我们还是要在项目中对其进行依赖添加。
首先在你的项目的根目录下的build.gradle中添加google()库，代码如下：
allprojects {
repositories {
jcenter()
google()
}
}
之后打开你的App或者module中的build.gradle文件，在dependencies中添加如下代码：
dependencies {
def room_version = "1.1.0" // or, for latest rc, use "1.1.1-rc1"
implementation "android.arch.persistence.room:runtime:$room_version"
annotationProcessor "android.arch.persistence.room:compiler:$room_version"
// optional - RxJava support for Room
implementation "android.arch.persistence.room:rxjava2:$room_version"
// optional - Guava support for Room, including Optional and ListenableFuture
implementation "android.arch.persistence.room:guava:$room_version"
// Test helpers
testImplementation "android.arch.persistence.room:testing:$room_version"
}
Room
上面的依赖添加完成后，接下来我们可以正式使用Room。在Android App中进行本地数据的存储都是使用SQLite，当我们使用原生的SQLite进行本地数据库的编写时，我们不仅要定义数据库结构，还要创建SQLiteHelper，编写一连串的SQL语句。这样代码量与复杂度不断上升，这不是我们想要的。而Room正好可以帮助我们减少代码、简化复杂度。
对于Room的使用主要由三部分构成：
- Entity：标识数据库中的表结构
- DAO： 标识提供获取数据库表中的数据方法
- Database：标识所需要创建的数据库
以上三部分在代码中都是通过注释来实现，从而达到代码的精简。
Entity
Entity作用在model上，即我们与数据表中的字段所匹配的model类。现在我们来建立一个联系人相关的model，对于正常的model建立如下：
data class ContactsModel(val id: Int, val name: String, val phone: String)
现在我们要把ContactsModel映射到数据库中的一种表，只需进行如下操作：
@Entity(tableName = "contacts")
data class ContactsModel(
@PrimaryKey
@ColumnInfo(name = "contacts_id")
val id: Int,
@ColumnInfo(name = "name")
val name: String,
@ColumnInfo(name = "phone")
val phone: String
)
首先我们在ContactsModel中添加@Entity注释，表明它将映射成一种表。在Entity中可以通过使用tableName来为该表命名，这里将其命名未contacts。
除此之外，使用@ColumnInfo来标明表中的字段，@PrimaryKey来标明表的主键。其中@ColumnInfo也可以通过(name = "name")来命名字段名。当然还有别的注释例如外键的标明：@ForeignKey
DAO
数据库表建好了，现在是提供操作数据表中的数据的方法。
@Dao
interface ContactsDao {
@Query("SELECT * FROM contacts")
fun getAllContacts(): List<ContactsModel>
@Query("SELECT * FROM contacts WHERE contacts_id = :id")
fun getContactsById(id: Int): LiveData<ContactsModel>
@Insert(onConflict = OnConflictStrategy.REPLACE)
fun insertContacts(contactsModel: ContactsModel)
@Query("UPDATE contacts SET name = :name AND phone = :phone WHERE contacts_id = :id")
fun updateContacts(id: Int, name: String, phone: String)
@Query("DELETE FROM contacts WHERE contacts_id = :id")
fun deleteContacts(id: Int)
这里我们只需创建一个接口，通过@Dao来标明它是提供操作数据表的方法集。要注意它必须为interface，在接口中我们只需定义接口方法即可。与平常的接口方法定义不同的是，我们必须在每一个接口方法上通过注释来标明该方法的作用。
例如getAllContacts()方法，我们为了让它实现获取contacts表中的所有数据，我们需要在其方法中添加@Query注释，由于是查询方法，自然是使用Query，如果是插入方法就是Insert(第三个方法)。其次()中的内容就是正常的查询语句。这里是获取所有的Contacts，所以我们使用
@Query("SELECT * FROM contacts")
对于有参数的sql语句编写，可以查看第二个方法，参数值只需在对应的方法参数名前加入:前缀，这就是传参的格式。
@Query("SELECT * FROM contacts WHERE contacts_id = :id")
fun getContactsById(id: Int): LiveData<ContactsModel>
Room就是这么简单，通过定义接口与接口方法的形式，再结合注释来简化代码量与复杂度。当然最终Room会根据注释，编译器会帮我们实现这些接口方法。我们可以build项目，然后我们就可以搜索到ContactsDao_Impl类，这个读者可以自行尝试。本质是ContactsDao_Impl实现了ContactsDao接口。
Room的强大之一是：它可以在编译时检测你的SQL语句是否编写正确，如果编写错误将导致编译失败。这样就可以避免App在运行时导致崩溃。这个读者可以自行测试一下。
Database
现在数据表有了，对表的操作方法也有了，最后就差数据库来保存各个数据表了。Talk is cheap. Show me the code。
@Database(entities = arrayOf(ContactsModel::class), version = 1)
abstract class ContactsDataBase : RoomDatabase() {
abstract fun contactsDao(): ContactsDao
companion object {
private var instance: ContactsDataBase? = null
fun getInstance(context: Context): ContactsDataBase {
if (instance == null) {
instance = Room.databaseBuilder(context.applicationContext,
ContactsDataBase::class.java,
"contacts.db").build()
}
return instance as ContactsDataBase
}
}
}
没错，还是使用注释，这里我们定义ContactsDataBase抽象类，让它继承RoomDatabase抽象类。当然也是同@Database来标明它是一个数据库。它接收两个参数，分别为entities与version，前者接收的类型是Class[]数组，内容为对于表的Class；后者是int的数据库版本号。
在ContactsDataBase中还需定义一个抽象方法，让它返回由@Dao注释的ContactsDao，即提供获取数据表的方法。本质的为数据库暴露操作数据表的入口。至于它的具体方法实现也可以通过build来查看对应的自动生成文件ContactsDataBase_Impl类。
因为contactsDao是数据库的唯一入口，避免每次对数据库进行操作时都创建ContactsDataBase实例，如上代码我们可以使用单例模式来减少实例频繁创建的开销。
使用
经过上面的Entity、DAO与Database的创建，现在我们已经有了完整的本地数据库结构。接下来我们来看史上最简数据库使用的调用代码：
private val mContactsDao by lazy { ContactsDataBase.getInstance(application).contactsDao() }
fun getContactsById(id: Int): LiveData<ContactsModel> = mContactsDao.getContactsById(id)
你没看错只需两行代码，我们就能获取数据库中Contacts表中的所用数据。
第一行代码我们获取了ContactsDao实例，该实例包含操作数据表的所以方法。而第二行代码就是调用ContactsDao中的操作方法。返回我们所需的数据。
在第二行代码，细心的你们可能会发现它返回了LiveData<ContactsModel>类型数据。它是ACC的另一强大组件，这也是Room的另一强大之处，它可以直接返回LiveData数据类型，完美与LiveData结合。至于LiveData的作用，敬请关注下一篇文章Android Architecture Components Part2:LiveData
总结
如果你的App使用了Room，那么你的App本地数据获取架构将会是这样的
最后文章中的代码都可以在Github中获取到。使用时请将分支切换到feat_architecture_components
相关文章
Android Architecture Components Part2:LiveData
Android Architecture Components Part3:Lifecycle
Android Architecture Components Part4:ViewModel
推荐
Bitmap的图片压缩汇总
tensorflow-梯度下降,有这一篇就足够了
Android共享动画兼容实现
Kotlin最佳实践
RecyclerView下拉刷新与上拉更多
七大排序算法总结
关注
网友评论