- 项目 https://github.com/iceCola7/WanAndroid 已经使用该框架
- Java 版 MVP 基础框架:https://github.com/iceCola7/MVPSamples
- Kotlin 版 MVP 基础框架:https://github.com/iceCola7/KotlinMVPSamples
快速搭建 Kotlin+MVP+RxJava+Retrofit+EventBus 的框架,方便快速开发新项目、减少开发成本,让所写的代码更加简洁,让开发者只需要关注业务的实现。
BaseActivity
、BaseFragment
是抽象类,封装了布局文件ID
、初始化View
、初始化数据、开始请求、是否使用EventBus
、状态栏等;BaseMvpActivity
、BaseMvpFragment
分别继承BaseActivity
和BaseFragment
并实现了IView
接口,将MVP
基础架构封装起来;注:如果想使用MVP
架构就继承BaseMvpActivity
或者BaseMvpFragment
,如果不适用MVP
架构就继承BaseActivity
或者BaseFragment
;BaseMvpTitleActivity
继承BaseMvpActivity
,简单了封装了Toolbar
,可扩展 。
- 封装
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))
})
}
- 封装
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>>>
}
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 层:模型层和视图层交互的桥梁。
A. 优点
-
模块职责划分明显,层次清晰,接口功能清晰;
-
Model层和View层分离,解耦.修改
View
而不影响Model
; -
功能复用度高,方便.一个
Presenter
可以复用于多个View
,而不用更改Presenter
的逻辑; -
有利于测试驱动开发,以前的
Android
开发是难以进行单元测试; -
如果后台接口还未写好,但已知返回数据类型的情况下,完全可以写出此接口完整的功能。
B. 缺点
-
MVP
中接口过多; -
每一个功能,相比于
MVC
要多写好几个文件; -
如果某一个界面中需要请求多个服务器接口,这个界面文件中会实现很多的回调接口,导致代码繁杂;
-
如果更改了数据源和请求中参数,会导致更多的代码修改;
-
额外的代码复杂度及学习成本。
- 封装
SchedulerUtils
工具类、IoMainScheduler
等; BaseObserver
和BaseSubscriber
对ResourceObserver
和ResourceSubscriber
通用封装。
- 封装
Preference
类,主要采用了kotlin
委托属性和SharedPreference
的实例; - 封装
StatusBarUtil
(适配状态栏) 、KeyBoardUtil
(键盘相关) 、NetWorkUtil
(网络相关) 、RomUtil
(手机ROM相关) 、FileProvider7
(7.0手机文件适配) 等。
- 封装
Toast
、LoadingView
和OnNoDoubleClickListener
(防止连续点击)。
只需要五步就可以实现 MVP 架构。
Clone or Download
后导入baselibs
库,再根据需求自行修改即可。
需要定义一个 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>>>
}
}
案例: MainModel
class MainModel : BaseModel(), MainContract.Model {
override fun getBanners(): Observable<HttpResult<MutableList<Banner>>> {
return MainRetrofit.service.getHomeBanner()
}
}
案例: 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。
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.