[译]Google官方关于Android架构中MVP模式的示例

概述

该示例(TODO-MVP)是后续各种示例演变的基础，它主要演示了在不带架构性框架的情况下实现M-V-P模式。其采用手动依赖注入的方式来提供本地数据源和远程数据源仓库。异步任务通过回调处理。

注意：MVP中View的概念是有所不同的：

• android.view.View类我们叫它 "Android View"
• MVP中从P接收命令的东西我们叫它”View”，后文说了，就是Fragment

Fragment

采用Fragment作为视图的载体有两个原因：

• Activity 和 Fragment分离恰好适合用来实现MVP：Activity是创建和连接View与Presenter的总控制器
• 适配平板设备的布局或多视图屏幕的场景都可利用Fragment框架的优势

关键概念

该App(指官方TODO-MVP示例)中有四个功能：

• Tasks
• TaskDetail
• AddEditTask
• Statistics

每个功能拥有下列代码分工：

• 定义VIew和Presenter之间的“契约”接口
• 一个Activity类负责创建Fragment和Presenter
• 一个Fragment类实现VIew接口
• 一个Presenter类实现Presenter接口
  
  一般来说，业务逻辑存在于Presenter中并依赖View完成Android中UI相关的工作。

View中几乎不包含逻辑：它将Presenter的命令转换为UI动作，并监听用户动作传递给Presenter。

“契约”接口用于定义View和Presenter之间的联系。

(译注：

有人立马就问到M哪去了，官方实例里M是轻的，与Repository和DataSource概念分离。在官方的另一个示例中有进一步的描述：http://www.cnblogs.com/x3d/p/6108998.html

/**
 * Immutable model class for a Task.
 */
public final class Task {

    @NonNull
    private final String mId;

    @Nullable
    private final String mTitle;

    @Nullable
    private final String mDescription;

    private final boolean mCompleted;

@NonNull
    public String getId() {
        return mId;
    }

    @Nullable
    public String getTitle() {
        return mTitle;
    }

    @Nullable
    public String getTitleForList() {
        if (!Strings.isNullOrEmpty(mTitle)) {
            return mTitle;
        } else {
            return mDescription;
        }
    }

    @Nullable
    public String getDescription() {
        return mDescription;
    }

    public boolean isCompleted() {
        return mCompleted;
    }

    public boolean isActive() {
        return !mCompleted;
    }

    public boolean isEmpty() {
        return Strings.isNullOrEmpty(mTitle) &&
               Strings.isNullOrEmpty(mDescription);
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Task task = (Task) o;
        return Objects.equal(mId, task.mId) &&
               Objects.equal(mTitle, task.mTitle) &&
               Objects.equal(mDescription, task.mDescription);
    }

    @Override
    public int hashCode() {
        return Objects.hashCode(mId, mTitle, mDescription);
    }

    @Override
    public String toString() {
        return "Task with title " + mTitle;
    }

}

DataSource、Repository相关代码布局：

契约接口定义：

package com.example.android.architecture.blueprints.todoapp.taskdetail;

import com.example.android.architecture.blueprints.todoapp.BasePresenter;
import com.example.android.architecture.blueprints.todoapp.BaseView;

/**
 * This specifies the contract between the view and the presenter.
 */
public interface TaskDetailContract {

    interface View extends BaseView<Presenter> {

        void setLoadingIndicator(boolean active);

        void showMissingTask();

        void hideTitle();

        void showTitle(String title);

        void hideDescription();

        void showDescription(String description);

        void showCompletionStatus(boolean complete);

        void showEditTask(String taskId);

        void showTaskDeleted();

        void showTaskMarkedComplete();

        void showTaskMarkedActive();

        boolean isActive();
    }

    interface Presenter extends BasePresenter {

        void editTask();

        void deleteTask();

        void completeTask();

        void activateTask();
    }
}

)

项目依赖

• Common Android support 库 (com.android.support.*)
• Android Testing Support 库 (Espresso, AndroidJUnitRunner…)
• Mockito
• Guava (null checking)

特性

复杂度 - 易理解性

使用架构性框架/库/工具类：

无

概念复杂度

低，基于Android的纯MVP实现。

可测试性

单元测试

高，Presenter可被单元测试，和仓库与数据源一样。

UI 测试

高，允许使用fake模块注入伪造(fake)数据进行测试。

代码对比

相比于不使用架构的传统项目，该示例引入了额外的类和接口：Presenter、Repositiy、契约接口等，所以MVP中代码行数更多一些。

语言	文件	空行	注释	代码
Java	46	1075	1451	3451
XML	34	97	337	601
SUM	80	1172	1788	4052

可维护性

简化功能的维护或新功能的迭代

高

学习成本

低

相关功能代码能容易查找定位、代码职责清晰。开发者无需熟悉任何外部的依赖就能对该项目开展工作。

Github项目地址：https://github.com/googlesamples/android-architecture/