这是使用Kotlin开发MVVM应用程序的第二部分—Retrofit及RxJava
在前一部分中我们简单了解了MVVM的基本概念和写法。如果你没有看过上一篇,请先快速浏览一遍,因为本系列是循序渐进的。可以在这里查看 使用Kotlin构建MVVM应用程序—第一部分:入门篇
如果第一篇是入了门,那这一篇就有点实战的意思了,更加贴近我们具体的需求,本文将阐述如何在MVVM中处理网络数据。
我们先加入依赖
//rx android
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
compile 'io.reactivex.rxjava2:rxjava:2.1.3'
//retrofit
compile 'com.squareup.retrofit2:retrofit:2.3.0'
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
compile 'com.squareup.retrofit2:adapter-rxjava2:2.3.0'
compile 'com.google.code.gson:gson:2.8.0'
这次相比上一篇稍微加了点难度,这次加入了网络请求库Retrofit和Rxjava。
Retrofit 是现在主流的网络请求库,不了解的看 官网
RxJava 是一个在 Java VM 上使用可观测的序列来组成异步的、基于事件的程序的库。不了解的当然是推荐经久不衰的 给 Android 开发者的 RxJava 详解
准备工作做好后,先看看现在的MVVM结构
MVVM
这次我们的Model层的数据源来自网络,并且在ViewModel中使用RxJava进行数据的转换。
开始正文
带着问题看文章是个好习惯。—ditclear
这次我们先来看看xml布局文件
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<data>
<!--需要的viewModel,通过mBinding.vm=mViewMode注入-->
<variable
name="vm"
type="io.ditclear.app.viewmodel.PaoViewModel"/>
</data>
<!--省略-->
<Button
<!--省略-->
android:onClick="@{()->vm.loadArticle()}"
android:text="load article"/>
<TextView
<!--省略-->
android:text="@{vm.articleDetail}"
tools:text="点击按钮,调用ViewModel中的loadArticle方法,通过DataBinding更新UI"/>
</layout>
要做的和上一篇差不多,只是现在多了网络请求。
看看现在的项目结构:
结构
相比上一篇,多了一个 PaoService.kt
interface PaoService{
//文章详情
@GET("article_detail.php")
fun getArticleDetail(@Query("id") id: Int): Single<Article>
}
为了简单起见,就只有一个加载文章详情的接口 getArticleDetail
我们现在使用 PaoService 作为我们的数据源(Model层),提供数据给我们的 PaoViewModel (ViewModel层)
class PaoViewModel(val remote: PaoService) {
//////////////////data//////////////
val articleDetail = ObservableField<String>()
//////////////////binding//////////////
fun loadArticle() {
//为了简单起见这里先写个默认的id
remote.getArticleDetail(8773)
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe({ t: Article? ->
articleDetail.set(t?.toString())
}, { t: Throwable? ->
articleDetail.set(t?.message ?: "error")
})
}
}
和上一篇对比来看相差也不大,只是现在我们的数据来自网络。
再来看看 PaoActivity.kt (View层)
class PaoActivity : AppCompatActivity() {
lateinit var mBinding : PaoActivityBinding
lateinit var mViewMode : PaoViewModel
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
mBinding=DataBindingUtil.setContentView(this,R.layout.pao_activity)
//////model
val remote=Retrofit.Builder()
.baseUrl("http://api.jcodecraeer.com/")
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create())
.build().create(PaoService::class.java)
/////ViewModel
mViewMode= PaoViewModel(remote)
////binding
mBinding.vm=mViewMode
}
}
基本一模一样,只是改变了数据源而已。
看一下效果:
好的,目的达到了。你可以在这里查看变更
https://github.com/ditclear/MVVM-Android/commit/efd77a850069803d53b5128e62f9ff4f259641fa
为了更有说服力,我优化了一下UI,并加入loading的效果。
image
还算有点模样,那么现在就到了本篇的重点了, 怎么像这样处理返回的网络数据? 。
再来看看xml布局文件,由于篇幅原因,所以这里只截取主要部分,详细请查看 pao_activity.xml
<!--省略-->
<us.feras.mdv.MarkdownView
android:id="@+id/web_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:markdown="@{vm.content}"
android:visibility="@{vm.loading?View.GONE:View.VISIBLE}"/>
<!--省略-->
这里使用到了一个第三方库 MarkdownView ,使用方法是这样的
markdownView.loadMarkdown("## Hello Markdown");
并没有提供 setMarkDown(markdown:String) 方法,相信这种情况很常见,经常需要我们改动第三方库达到项目的需求。所以这里需要自定义一下 BindingAdapter ,具体见 NormalBinds.kt
@BindingAdapter(value = "markdown")
fun bindMarkDown(v: MarkdownView, markdown: String?) {
markdown?.let {
v.setMarkdown(it)
}
}
眼尖的同学就发现了,这不是有 setMarkdown 方法吗?
别急,其实这只是使用 kotlin 给 MarkdownView 添加的扩展函数,具体见 NormalExtens.kt
fun MarkdownView.setMarkdown(markdown : String?){
loadMarkdown(markdown)
}
再来瞧瞧我们的 PaoActivity.kt ,依然捡重点
override fun onCreateOptionsMenu(menu: Menu?): Boolean {
menu?.let {
menuInflater.inflate(R.menu.detail_menu,it)
}
return super.onCreateOptionsMenu(menu)
}
override fun onOptionsItemSelected(item: MenuItem?): Boolean {
item?.let {
when(it.itemId){
R.id.action_refresh -> mViewMode.loadArticle()
}
}
return super.onOptionsItemSelected(item)
}