MVPKotlin

该项目是使用Kotlin语言搭建的Android MVP架构案例。

更新日志

概述

什么是MVP架构？

简单介绍下：

通常一般的Android项目结构，我们会在Activity\Fragment中编写大量代码，例如：网络请求、数据填充、页面切换等等，这种项目结构宏观的称之为MVC。

MVC：我们可以把数据源（网络请求、IO...）看作Model层，xml等布局文件看作View层，Activity\Fragment看作Controller层。但在android中xml能力太薄弱了，以至于Activity不得不做很多本不属于它的工作。

MVP：在MVP架构中Model层与MVC一样作为数据源，不过将Activity\Fragment都看作为View层的一部分负责数据的展示和填充，将Model层与View层的关联操作交给了Presenter层。

一个基本的MVP架构图如下：

与之前的Android MVC相比，不仅Activity的分工不明确问题得到了解决，还带来另一个好处：Model层与View层不再直接可见，耦合问题得到解决。

该项目MVP架构

在此基础上，该项目中的MVP架构对每个模块进行细化，大致架构图如下：

1、View层根据自己的需要继承对应的BaseMvpActivity\BaseMvpFragment\BaseMvpFragmentActivity，并实现createPresenter()函数，它们提供基础的View层模版；

  /**
   *  1、继承BaseMvpActivity
   *  2、通过泛型告诉View层，当前Presenter的契约接口LoginContract.IPresenter
   *  3、实现自己的契约接口LoginContract.IView
   */
  class LoginActivity : BaseMvpActivity<LoginContract.IPresenter>(), LoginContract.IView {
  
       override fun registerPresenter() = LoginPresenter::class.java
  	...
  ｝

2、Presenter层提供了基础的IBasePresent接口模板，考虑到整个项目使用rxjava2作为异步库，为了方便管理rx生命周期，额外提供了一个BaseRxLifePresenter抽象类；

  /**
   * 1、继承BaseRxLifePresenter
   * 2、通过泛型告诉Presenter层，当前View的契约接口LoginContract.IView
   * 3、实现自身的契约接口LoginContract.IPresenter
   */
  class LoginPresenter(mvpView: LoginContract.IView) : BaseRxLifePresenter<LoginContract.IView>(mvpView), LoginContract.IPresenter {
  	
  	//rxjava生命周期管理举例
      override fun delayGoHomeTask() {
          Observable.timer(1500, TimeUnit.MILLISECONDS)
                  .subscribe { getMvpView().goHome() }
                  .bindRxLifeEx(RxLife.ON_DESTROY)
      }
  		
  	//登录功能
      override fun login(userName: String) {
          RxUtils.dispose(mLoginDisposable)
          mLoginDisposable = HttpFactory.getProtocol(IUserHttp::class.java)
  				.getUserInfoByName(userName)
                  .subscribeOn(Schedulers.io())
                  .observeOn(AndroidSchedulers.mainThread())
                  .subscribeEx({
                      if (it.message.isNullOrBlank()) {
                          getMvpView().loginSuccess()
                      } else {
                          getMvpView().loginError(it.message)
                      }
                  }, {
                      getMvpView().loginError(null)
                  }).bindRxLifeEx(RxLife.ON_DESTROY)
      }
  ｝

3、View层与Presenter层的交互通过接口进行解耦。例如上方的LoginActivity与LoginPresenter的交互都在LoginContract中进行限制；

  /**
   * 登录页View层\Presenter层通讯契约接口
   */
  interface LoginContract {
  
      interface IView : IBaseViewContract {
          fun loginSuccess()
          fun loginError(errorMsg: String?)
          fun goHome()
      }
  
      interface IPresenter : IBasePresenterContract {
          fun login(userName: String)
          fun delayGoHomeTask()
      }
  }

4、Modle层封装Protocol，用于包装数据源并提供转换为Observable的函数，方便与Rxjava2结合使用（项目中DaoProtocol通过继承BaseDAOProtocol实现，HttpProtocol通过Retrofit实现，这块可以根据自己实际情况封装），并实现自身向Presenter公开的约束接口；

  class UserDaoProtocol : BaseDaoProtocol(), IUserDaoProtocol {
  
      override fun saveUser(context: Context, user: User) = createObservable {
          saveUserImpl(context, user)
      }
  
      private fun saveUserImpl(context: Context, user: User): Boolean =
              if (findUserByUserIdImpl(context, user.id) == null) {
                  insertUserImpl(context, user)
              } else {
                  updateUserImpl(context, user)
              }
  	
  	...
  ｝

--------------- 分割线 ------------------

  //Model层对外提供的约束接口
  interface IUserDaoProtocol : DaoInterface {
      /**
       * 保存用户信息
       * */
      fun saveUser(context: Context, user: User): Observable<Boolean>

  	...
  }

5、每个Protocol对象建议通过Factory产出（DaoProtocol需在DaoFactoryConfig中进行配置，HttpProtocol得益于Retrofit自身的实现，不需要我们手动关联工厂代码），从而与Presenter进行解耦；

  object DaoFactoryConfig {
  
      //TODO  在此处配置DAO接口
      @Suppress("UNCHECKED_CAST")
      fun <T> configProtocol(clazz: Class<T>): T = when (clazz) {
          IUserDaoProtocol::class.java -> UserDaoProtocol()
          else -> throw IllegalStateException("NotFound Dao Interface Object  : ${clazz.name}")
      } as T
  }

例如：通过DaoFactory获取UserDAOProtocol的父级IUserDaoProtocol接口引用，而不是它的自身引用，避免直接操作接口约束之外的公共域：

DaoFactory.getProtocol(IUserDaoProtocol::class.java).saveUser(context, user)
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe()

6、一个View对应一个Presenter，View与Presenter交互通过Contract接口进行约束，一个Presenter可对应多个Modle对象，这些Modle对象通过Factory产出（Protocol，每个Protocol都应该是可复用，且内存安全的）.

1072258106 / mvp-kotlin

MVPKotlin

更新日志

概述

截图：

About

Languages