iceCola7/KotlinMVPSamples:

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称（OpenSource Name）：

iceCola7/KotlinMVPSamples

开源软件地址(OpenSource Url)：

https://github.com/iceCola7/KotlinMVPSamples

开源编程语言(OpenSource Language)：

Kotlin 97.1%

开源软件介绍(OpenSource Introduction)：

Kotlin 版 MVP 基础框架

项目 https://github.com/iceCola7/WanAndroid 已经使用该框架
Java 版 MVP 基础框架：https://github.com/iceCola7/MVPSamples
Kotlin 版 MVP 基础框架：https://github.com/iceCola7/KotlinMVPSamples

简介

快速搭建 Kotlin+MVP+RxJava+Retrofit+EventBus 的框架，方便快速开发新项目、减少开发成本，让所写的代码更加简洁，让开发者只需要关注业务的实现。

代码结构

1. View 层的基类封装

BaseActivity 、 BaseFragment 是抽象类，封装了布局文件 ID 、初始化 View 、初始化数据、开始请求、是否使用 EventBus 、状态栏等；
BaseMvpActivity 、 BaseMvpFragment 分别继承 BaseActivity 和 BaseFragment 并实现了 IView 接口，将 MVP 基础架构封装起来；注：如果想使用 MVP 架构就继承 BaseMvpActivity 或者 BaseMvpFragment ，如果不适用 MVP 架构就继承 BaseActivity 或者 BaseFragment ；
BaseMvpTitleActivity 继承 BaseMvpActivity ，简单了封装了 Toolbar，可扩展。

2. ext 相关的封装（主要用到了 Kotlin 扩展函数）

封装 loge 、 showToast 、 showSnackMsg 、ss 、 sss 等通用方法，项目中可以直接调用；
ss 、 sss ，这两个方法主要是对网络请求的统一封装，使用起来非常方便（亮点）；

mModel?.getBanners()?.ss(mModel, mView) {
    mView?.showBanners(it.data)
}
addDisposable(
    mModel?.getBanners()?.sss(mView) {
        mView?.showBanners(it.data)
    }
)

这里贴上 ss 和 sss 方法的代码（这两个方法用起来真的太爽了）：

fun <T : BaseBean> Observable<T>.ss(
    model: IModel?,
    view: IView?,
    isShowLoading: Boolean = true,
    onSuccess: (T) -> Unit
) {
    this.compose(SchedulerUtils.ioToMain())
        .retryWhen(RetryWithDelay())
        .subscribe(object : Observer<T> {
            override fun onComplete() {
                view?.hideLoading()
            }
            override fun onSubscribe(d: Disposable) {
                if (isShowLoading) {
                    view?.showLoading()
                }
                model?.addDisposable(d)
                if (!NetWorkUtil.isConnected()) {
                    view?.showDefaultMsg("当前网络不可用，请检查网络设置")
                    d.dispose()
                    onComplete()
                }
            }
            override fun onNext(t: T) {
                when {
                    t.errorCode == ErrorStatus.SUCCESS -> onSuccess.invoke(t)
                    t.errorCode == ErrorStatus.TOKEN_INVAILD -> {
                        // Token 过期，重新登录
                    }
                    else -> view?.showDefaultMsg(t.errorMsg)
                }
            }
            override fun onError(t: Throwable) {
                view?.hideLoading()
                view?.showError(ExceptionHandle.handleException(t))
            }
        })
}

fun <T : BaseBean> Observable<T>.sss(
    view: IView?,
    isShowLoading: Boolean = true,
    onSuccess: (T) -> Unit
): Disposable {
    if (isShowLoading) {
        view?.showLoading()
    }
    return this.compose(SchedulerUtils.ioToMain())
        .retryWhen(RetryWithDelay())
        .subscribe({
            when {
                it.errorCode == ErrorStatus.SUCCESS -> onSuccess.invoke(it)
                it.errorCode == ErrorStatus.TOKEN_INVAILD -> {
                    // Token 过期，重新登录
                }
                else -> view?.showDefaultMsg(it.errorMsg)
            }
            view?.hideLoading()
        }, {
            view?.hideLoading()
            view?.showError(ExceptionHandle.handleException(it))
        })
}

3. 网络通讯通用类

封装 RetrofitFactory 来构建不同 baseUrl 的 RetrofitService （注：项目中 baseUrl 很多的情况下，不建议使用，建议重新封装）；
封装 cookie 相关、统一的异常处理、 CacheInterceptor 、 HeaderInterceptor 、 SaveCookieInterceptor 等；
封装请求重连操作，详情请见类 RetryWithDelay 。

object MainRetrofit : RetrofitFactory<MainApi>() {
    override fun baseUrl(): String = Constant.BASE_URL
    override fun getService(): Class<MainApi> = MainApi::class.java
}
interface MainApi {
    @GET("/banner/json")
    fun getHomeBanner(): Observable<HttpResult<MutableList<Banner>>>
}

4. MVP 基础架构

MVP 即是 Model , View , Presenter 三层，把 Activity 中的 UI 逻辑抽象成 View 接口，把业务逻辑抽象成 Presenter 接口， Model 类还是原来的 Model ，实现了 Model 层和 View 层完全解耦。

用户触发 V 层事件， V 层把事件通知 P 层， P 层通知 M 层处理这个事件， M 层处理完之后把结果发送给 P 层， P 层再发送给 V 层，最后 V 层做出相应的处理，这是 MVP 架构的一整套流程。

M 层：模型层，负责数据的请求、解析、过滤等操作；
V 层：视图层，负责视图部分展示、视图时间处理， Activity 、 Fragment 、 Dialog 、 ViewGroup 等呈现视图的组件都可以承担该角色；
P 层：模型层和视图层交互的桥梁。

MVP 架构的优缺点

A. 优点

模块职责划分明显,层次清晰,接口功能清晰；
Model层和View层分离,解耦.修改 View 而不影响 Model ；
功能复用度高,方便.一个 Presenter 可以复用于多个 View ,而不用更改 Presenter 的逻辑；
有利于测试驱动开发,以前的 Android 开发是难以进行单元测试；
如果后台接口还未写好,但已知返回数据类型的情况下,完全可以写出此接口完整的功能。

B. 缺点

MVP 中接口过多；
每一个功能,相比于 MVC 要多写好几个文件；
如果某一个界面中需要请求多个服务器接口,这个界面文件中会实现很多的回调接口,导致代码繁杂；
如果更改了数据源和请求中参数,会导致更多的代码修改；
额外的代码复杂度及学习成本。

5. rx 相关

封装 SchedulerUtils 工具类、 IoMainScheduler 等；
BaseObserver 和 BaseSubscriber 对 ResourceObserver 和 ResourceSubscriber 通用封装。

6. 工具类和帮助类

封装 Preference 类，主要采用了 kotlin 委托属性和 SharedPreference 的实例；
封装 StatusBarUtil （适配状态栏）、 KeyBoardUtil （键盘相关）、 NetWorkUtil （网络相关）、 RomUtil （手机ROM相关）、 FileProvider7 （7.0手机文件适配）等。

7. 自定义控件

封装 Toast 、 LoadingView 和 OnNoDoubleClickListener （防止连续点击）。

如何使用？

只需要五步就可以实现 MVP 架构。

第一步：导入baselibs库

Clone or Download 后导入 baselibs 库，再根据需求自行修改即可。

第二步：定义一个Contract

需要定义一个 Contract 接口，来抽象 View、Presenter、Model 的方法，并且它们需要分别继承 IView、IPresenter、IModel 接口。

案例： MainContract

interface MainContract {
    interface View : IView {
        fun showBanners(banners: MutableList<Banner>)
    }
    interface Presenter : IPresenter<View> {
        fun getBanner2()
    }
    interface Model : IModel {
        fun getBanners(): Observable<HttpResult<MutableList<Banner>>>
    }
}

第三步：创建一个Model接口的实现类，需要继承 BaseModel 类并实现Model接口

案例： MainModel

class MainModel : BaseModel(), MainContract.Model {
    override fun getBanners(): Observable<HttpResult<MutableList<Banner>>> {
        return MainRetrofit.service.getHomeBanner()
    }
}

第四步：创建一个Presenter接口的实现类，需要继承 BasePresenter<M : IModel, V : IView> 并实现 MainContract.Presenter 接口

案例： MainPresenter

class MainPresenter : BasePresenter<MainContract.Model, MainContract.View>(), MainContract.Presenter {
    override fun createModel(): MainContract.Model? = MainModel()
    override fun getBanner2() {
        mModel?.getBanners()?.ss(mModel, mView) {
            mView?.showBanners(it.data)
        }
    }
}

第五步：创建一个View的接口实现类，这是一个Activity或者Fragment，需要继承BaseMvpActivity<in V : IView, P : IPresenter> 或者 BaseMvpFragment<in V : IView, P : IPresenter> 并实现 View 接口

案例：MainActivity

class MainActivity : BaseMvpTitleActivity<MainContract.View, MainContract.Presenter>(), MainContract.View {
    override fun attachChildLayoutRes(): Int = R.layout.activity_main
    override fun createPresenter(): MainContract.Presenter = MainPresenter()
    override fun initView() {
    }
    override fun initData() {
    }
    override fun start() {
        mPresenter?.getBanner2()
    }
    override fun showBanners(banners: MutableList<Banner>) {
        tv_result.text = banners.toString()
    }
}

至此， Kotlin 基础框架已经搭建完成，如有错误之处还请指正。

最后

完整的项目地址：https://github.com/iceCola7/KotlinMVPSamples。

LICENSE

Copyright 2018 iceCola7 

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.