MVVMLin一个基于Jatpack+Kotlin+协程+Retrofit的快速开发框架

MVVMLin

一个基于MVVM用Kotlin+Retrofit+协程+Databinding+LiveData来封装的快速开发框架： 项目地址：MVVMLin

Github上关于MVVM的框架也很多，以前一直在用RxJava +Retrofit 用MVP模式来作项目，如今AndroidX 是大势所趋，Kotlin已经成官方语言两年了，今年GoogleIO大会又出了新东西，哎~~~~学不动了呀。近期项目不太忙，把这几个新东西结合起来，封装了一个MVVM的框架，分享出来给你们献丑了。 抛弃了强大的RxJava，内心仍是有点虚的。

框架简介

• 使用技术 基于MVVM模式用了 kotlin+协程+retrofit+livedata+DataBinding，默认使用了AndroidX
• 基本封装 封装了BaseActivity、BaseFragment、BaseViewModel基于协和的网络请方式更加方便，考虑到有些小伙伴不太喜欢用DataBinding在xml中绑定数据的方式，也提供了相应的适配，两种方式自行选择。Retrofit2.6提供了对协程的支持，使用起来更加方便，不用考虑类型的转换了。
• 特色 使用Rxjava 处理很差的话会有内存泄露的风险，咱们会用使用AutoDispose、RxLifecycle等方式来处理，可是使用协程来请求数据，彻底不用担忧这个问题，全部请求都是在viewModelScope中启动，当页面销毁的时候，会统一取消，不用关心这个问题了。用Kotlin封装，大量语法糖可以使用。
• 引入第三方库 AndroidUtilCode：包含了大量的经常使用工具类，简直是必备神器啊。 material-dialogs：弹窗 glide：图片加载 Retrofit：网络请求

1，如何使用

1.1 启用databinding

在主工程app的build.gradle的android {}中加入：

dataBinding {
    enabled true
}
复制代码

1.2 依赖

在主项目app的build.gradle中依赖

dependencies {
    ...
   implementation 'me.aleyn:MVVMLin:1.0'
}
复制代码

或者 下载到本地导入Module

1.3 配置依赖版本文件 config.gradle

复制Demo的 config,gradle 到要目录，在项目的build.gradle 中加入：

apply from: "config.gradle"
复制代码

2，快速开始

2.1Activity

继承BaseActivity

class DetailActivity : BaseActivity<NoViewModel, ViewDataBinding>() {
	override fun layoutId() = R.layout.activity_detail
	
	override fun initView(savedInstanceState: Bundle?) {
       ....
    }

    override fun initData() {
      ....
    }
}
复制代码

第一个泛型是VIewModel,若是页面很简单不须要ViewModel，直接传入NoViewModel便可。 第二个泛型是Databinding,若是页面使用Databinding的话，就要传对应生成的Binding类，若是这个页面不使用DataBinding，传ViewDataBinding，基类不会初始化mBinding而会使用**setContentView(l)**方式。 layoutId() 方法返回对应布局 initView() 和 initData() 为默认实现，作初始化UI等操做

2.2 Fragment

继承BaseFragment

class HomeFragment : BaseFragment<HomeViewModel, ViewDataBinding>() {
		override fun layoutId() = R.layout.home_fragment
		override fun initView(savedInstanceState: Bundle?) {  }
		override fun lazyLoadData() { 
			....
		}
}
复制代码

实现方法同Activity同样，Fragment多了懒加载方法lazyLoadData() 可选择性重写。 setUserVisibleHint() 方法已经被弃用，懒加载使用新的方式实现。

一样Fragment中若是想不使用Databinding，泛型传ViewDataBinding：

2，使用DataBinding,布局文件：

<layout>
    <data>
    .....
    </data>
    .....
</layout>
复制代码

泛型传对应生成Binding类：

class ProjectFragment : BaseFragment<ProjectViewModel, ProjectFragmentBinding>() {
		.........
}
复制代码

2.3 ViewModel

继承BaseViewModel

class HomeViewModel : BaseViewModel() {
		.........
}
复制代码

若是一个页面内容不多，不须要ViewModel，咱们可能不想再建一个ViewModel类，泛型传NoViewModel便可。 BaseVIewModel 中对协程进行了简单封装，BaseViewMode 已经作了对网络请求异常的统一处理。好比咱们的网络请求能够这样写：

class HomeViewModel : BaseViewModel() {
    private val homeRepository by lazy { InjectorUtil.getHomeRepository() }
    val mBanners = MutableLiveData<List<BannerBean>>()
    fun getBanner() {
    	//只返回结果，其余全抛自定义异常
        launchOnlyresult({ homeRepository.getBannerData() }, {
            mBanners.value = it
        })
    }
}
复制代码

那若是咱们想本身处理错误怎么办？

class HomeViewModel : BaseViewModel() {
    private val homeRepository by lazy { InjectorUtil.getHomeRepository() }
    val mBanners = MutableLiveData<List<BannerBean>>()
    fun getBanner() {
        launchOnlyresult({ homeRepository.getBannerData() }, {
            mBanners.value = it
        },{
         // 这里是Error 返回   ()
        })
    }
}
复制代码

只须要加一个方法参数就好了。

另外一种不过滤返回结果的方式：

class MeViewModel : BaseViewModel() {
    private val homeRepository by lazy { InjectorUtil.getHomeRepository() }
    var popularWeb = MutableLiveData<List<UsedWeb>>()
    fun getPopularWeb() {
        launch({
            val result = homeRepository.getPopularWeb()  //
            if (result.isSuccess()) {
                popularWeb.value = result.data
            }
        })
    }
}
复制代码

要本身处理Error 跟上面同样，加一个方法参数就好了。

每一个网络请求都会加等待框，若是咱们不想要等待框：

fun getProjectType() {
        launchOnlyresult({
            homeRepository.getNaviJson()
        }, {
            navData.addAll(it)
            it.forEach { item ->
                navTitle.add(item.name)
            }
        }, isShowDialog = false)
 }
复制代码

isShowDialog 传false，默认是true

3，例子

Demo中只展现了三种列表使用方式

3.1 不使用Databinging,结合BRVAH

详见Demo的 HomeFragment

3.2 使用Databinging,结合bindingcollectionadapter

结合bindingcollectionadapter不用写Adapter适配器了，详见Demo的 ProjectFragment

3.2 使用Databinging,结合BRVAH

BRVAH 对DataBinding也作了支持，详见Demo的 MeFragment

4，关于框架

刚刚完成1.0版，也算是我对新东西的一个学习过程，问题应该仍是挺多的，后续会进一步完善，下一步会考虑把Eventbus加进去，也欢迎你们多提意见。顺手给个Stat。哈哈~~~~~~