Android 官方示例：android-architecture 学习笔记(五)之todo-mvp-clean

项目地址：https://github.com/googlesamples/android-architecture/tree/todo-mvp-clean/

项目结构

本项目的理念基于Clean Architecture.
项目架构基于基本的MVP示例。添加了domain 层，在 presentation层和 repositories层之间。总体就将App分成了三层：

层次说明

MVP

从MVP示例而来的Model View Presenter 架构

Domain

拥有所有的业务逻辑。domain层中的类命名，都以use cases或interactors开始，它们被使用在App中的presenters中。(本项目，实际是在每个功能模块下定义了一个package : domain/usecase)

Repository

与MVP示例中的Repository一样。

模块分析

基础类

主包下多了四个类：
UseCase —— 用例类，是一个抽象类。内部还定义了两个接口RequestValues、ResponseValue，这是两个空接口，用于请求和响应时的回调处理。一个抽象方法executeUseCase()，用于执行用例
UseCaseHandler —— 用例处理类，单例。组合了UseCaseScheduler
UseCaseScheduler :

public interface UseCaseScheduler {    //执行用例    void execute(Runnable runnable);    //响应通知给callback    <V extends UseCase.ResponseValue> void notifyResponse(final V response,            final UseCase.UseCaseCallback<V> useCaseCallback);    //错误通知给callback    <V extends UseCase.ResponseValue> void onError(            final UseCase.UseCaseCallback<V> useCaseCallback);}

UseCaseThreadPoolScheduler —— UseCaseScheduler的实现类
还有一个prod或mock源目录(取决于build variant)下的 Injection类。使用依赖注入的方式，提供获取各种use case类型的访问方法。

statistics模块

包结构：

先来看下usecase/GetStatistics类：

public class GetStatistics extends UseCase<GetStatistics.RequestValues, GetStatistics.ResponseValue> {    private final TasksRepository mTasksRepository;    public GetStatistics(@NonNull TasksRepository tasksRepository) {        mTasksRepository = checkNotNull(tasksRepository, "tasksRepository cannot be null!");    }    @Override    protected void executeUseCase(RequestValues requestValues) {        mTasksRepository.getTasks(new TasksDataSource.LoadTasksCallback() {            @Override            public void onTasksLoaded(List<Task> tasks) {                int activeTasks = 0;                int completedTasks = 0;                // We calculate number of active and completed tasks                for (Task task : tasks) {                    if (task.isCompleted()) {                        completedTasks += 1;                    } else {                        activeTasks += 1;                    }                }                ResponseValue responseValue = new ResponseValue(new Statistics(completedTasks, activeTasks));                getUseCaseCallback().onSuccess(responseValue);            }            @Override            public void onDataNotAvailable() {                getUseCaseCallback().onError();            }        });    }    public static class RequestValues implements UseCase.RequestValues {    }    public static class ResponseValue implements UseCase.ResponseValue {        private final Statistics mStatistics;        public ResponseValue(@NonNull Statistics statistics) {            mStatistics = checkNotNull(statistics, "statistics cannot be null!");        }        public Statistics getStatistics() {            return mStatistics;        }    }}

代码不多。继承了UseCase。组合了TasksRepository，需要构造时传入，用于在executeUseCase()执行获取数据的操作。定义了两个静态内部类，分别实现请求和响应时要用的回调接口。

StatisticsContract —— 契约类，定义V、P的接口与方法
StatisticsPresenter ，部分代码：

public class StatisticsPresenter implements StatisticsContract.Presenter {    private final StatisticsContract.View mStatisticsView;    private final UseCaseHandler mUseCaseHandler;    private final GetStatistics mGetStatistics;    public StatisticsPresenter(            @NonNull UseCaseHandler useCaseHandler,            @NonNull StatisticsContract.View statisticsView,            @NonNull GetStatistics getStatistics) {        mUseCaseHandler = checkNotNull(useCaseHandler, "useCaseHandler cannot be null!");        mStatisticsView = checkNotNull(statisticsView, "StatisticsView cannot be null!");        mGetStatistics = checkNotNull(getStatistics,"getStatistics cannot be null!");        mStatisticsView.setPresenter(this);    }    @Override    public void start() {        loadStatistics();    }    private void loadStatistics() {       …    }}

组合了UseCaseHandler、用例GetStatistics、StatisticsContract.View(V)
mUseCaseHandler用于执行用例mGetStatistics，mStatisticsView显示视图

StatisticsFragment —— 实现StatisticsContract.View接口。依赖StatisticsContract.Presenter。在onResume()中，调用presenter的加载数据方法。

StatisticsActivity —— 初始化StatisticsFragment、StatisticsPresenter。

总结

相较于传统MVP，P不再直接操作M了，而是通过domain层的use case来操作。