×

使用Kotlin构建MVVM应用程序—第三部分:Room

96
ditclear
2018.04.14 20:41* 字数 1069

目录

写在前面

这是使用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进行持久化

  1. 新建相应的表

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
}
  1. 创建相关的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)

}
  1. 创建数据库

    相当于创建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文章进行持久化。

  1. 修改一下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) }
            }
}

我们的目录结构会如下图所示:

结构
  1. 修改我们的ViewModel层的数据源

在上一篇中我们使用的是PaoService网络数据作为数据源,这里只需要修改为PaoRepo

class PaoViewModel(private val repo: PaoRepo) 

以后统一使用PaoRepo来为PaoViewModel提供数据

  1. 在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,从入门到放弃到恍然大悟到爱不释手。。。

android
Web note ad 1