目录
- 使用Kotlin构建MVVM应用程序—总览篇
- 使用Kotlin构建MVVM应用程序—第一部分：入门篇
- 使用Kotlin构建MVVM应用程序—第二部分：Retrofit及RxJava
- 使用Kotlin构建MVVM应用程序—第三部分：Room
写在前面
这是使用Kotlin构建MVVM应用程序—第三部分：Room
在上一篇中我们了解了MVVM是怎么处理网络数据的，而这一篇则介绍的是如何进行数据持久化。
Room
Room是google推出的一个数据持久化库，它是 Architecture Component的一部分。它让SQLiteDatabase的使用变得简单，大大减少了重复的代码，并且把SQL查询的检查放在了编译时。
Room使用起来非常简单，而且可以和RxJava配合使用，和我们的技术体系十分契合。
加入依赖
首先在项目的build.gradle中加入
allprojects {
repositories {
maven {
url 'https://maven.google.com'
}
jcenter()
}
}
接着在app的build.gradle中加入它的依赖
//room (local)
implementation 'android.arch.persistence.room:runtime:1.0.0'
implementation 'android.arch.persistence.room:rxjava2:1.0.0'
kapt 'android.arch.persistence.room:compiler:1.0.0'
//facebook出品，可在Chrome中查看数据库
implementation 'com.facebook.stetho:stetho:1.5.0'
现在的结构
MVVM
这里我们多了一层Repository，使用这一层来确保单一数据源，保证数据来源的唯一和正确性（即不管是来自网络或是本地缓存的）。ViewModel层并不需要知道它使用到的数据是怎么来的，就好似开发者并不需要知道设计师是如何画出UI图的一样。
开始正文
使用Room进行持久化
-
新建相应的表
Room为每个用@Entity注解了的类创建一张表
@Entity(tableName = "articles")
class Article(var title: String?){
@PrimaryKey
@ColumnInfo(name = "articleid")
var id: Int = 0
var content: String? = null
var readme: String? = null
@SerializedName("describe")
var description: String? = null
var click: Int = 0
var channel: Int = 0
var comments: Int = 0
var stow: Int = 0
var upvote: Int = 0
var downvote: Int = 0
var url: String? = null
var pubDate: String? = null
var thumbnail: String? = null
}
-
创建相关的Dao
相当于Retrofit中的api接口
DAO负责定义操作数据库的方法。在SQLite实现的版本中，所有的查询都是在LocalUserDataSource文件中完成的，里面主要是 使用了Cursor对象来完成查询的工作。有了Room，我们不再需要Cursor的相关代码，而只需在Dao类中使用注解来定义查询。
@Dao
interface PaoDao{
@Insert(onConflict = OnConflictStrategy.REPLACE)
fun insetAll(articles: List<Article>)
@Query("SELECT * FROM Articles WHERE articleid= :id")
fun getArticleById(id:Int):Single<Article>
@Insert(onConflict = OnConflictStrategy.REPLACE)
fun insertArticle(article :Article)
}
-
创建数据库
相当于创建RetrofitClient对象
我们需要定义一个继承了RoomDatabase的抽象类。这个类使用@Database来注解，列出它所包含的Entity以及操作它们的 DAO 。
@Database(entities = arrayOf(Article::class),version = 1) abstract class AppDatabase :RoomDatabase(){ abstract fun paoDao(): PaoDao companion object { @Volatile private var INSTANCE: AppDatabase? = null fun getInstance(context: Context): AppDatabase = INSTANCE ?: synchronized(this) { INSTANCE ?: buildDatabase(context).also { INSTANCE = it } } private fun buildDatabase(context: Context) = Room.databaseBuilder(context.applicationContext, AppDatabase::class.java, "app.db") .build() } }
Over ，集成Room十分的简单。
更多关于Room的使用方法，它的迁移，表之间的关联和字段。
推荐查看泡网的Room专题：Room
实践
这里我们对上一篇中的从服务器端获取到的Article文章进行持久化。
- 修改一下Model层的代码，添加Repository作为ViewModel层的数据源
class PaoRepo constructor(private val remote:PaoService,private val local :PaoDao){
//首先查看本地数据库是否存在该篇文章
fun getArticleDetail(id:Int)= local.getArticleById(id)
.onErrorResumeNext {
//本地数据库不存在，会抛出EmptyResultSetException
//转而获取网络数据,成功后保存到数据库
remote.getArticleDetail(id)
.doOnSuccess { local.insertArticle(it) }
}
}
我们的目录结构会如下图所示：
结构
- 修改我们的ViewModel层的数据源
在上一篇中我们使用的是PaoService网络数据作为数据源，这里只需要修改为PaoRepo
class PaoViewModel(private val repo: PaoRepo)
以后统一使用PaoRepo来为PaoViewModel提供数据
- 在View层中将
PaoRepo注入到PaoViewModel
//////model
val remote=Retrofit.Builder()
.baseUrl(Constants.HOST_API)
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create())
.build().create(PaoService::class.java)
val local=AppDatabase.getInstance(applicationContext).paoDao()
val repo = PaoRepo(remote, local)
/////ViewModel
mViewMode= PaoViewModel(repo)
////binding
mBinding.vm=mViewMode
看看效果
image
写在最后
本项目的github地址：https://github.com/ditclear/MVVM-Android
更多的例子可以查看：https://github.com/ditclear/PaoNet
这是使用Kotlin构建MVVM项目的第三部分，主要讲了怎么在MVVM中进行数据的持久化以及为ViewModel层提供Repository作为唯一的数据源。
总结一下前三篇的内容便是:
使用Retrofit提供来自服务端的数据，使用Room来进行持久化，然后提供一个Repository来为ViewModel提供数据，ViewModel层利用RxJava来进行数据的转换，配合DataBinding引起View层的变化。
逻辑很清晰了，但唯一的遗憾便是为了提供一个ViewModel我们需要写太多模板化的代码了
//////model
val remote=Retrofit.Builder()
.baseUrl(Constants.HOST_API)
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create())
.build().create(PaoService::class.java)
val local=AppDatabase.getInstance(applicationContext).paoDao()
val repo = PaoRepo(remote, local)
/////ViewModel
mViewMode= PaoViewModel(repo)
如果能不写该多好。
上帝说：可以。
所以下一篇的内容便是依赖注入—Dagger2，从入门到放弃到恍然大悟到爱不释手。。。
网友评论