Android MVP 详解（下）
樱桃大丸子
9年前
<h2>5. 最佳实践</h2> <p>好了终于要点讲自己的东西了，有点小激动。下面这些仅表示个人观点，非一定之规，各位看官按需取用，有说的不对的，敬请谅解。关于命名规范可以参考我的另一篇文章“<a href="/misc/goto?guid=4959669977307807484">Android 编码规范</a>”。老规矩先上图：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/2298796a691481718e54bf09c2882a94.png"></p> <p>MVPBestPractice 思维导图</p> <p><br> 在参考了 <a href="/misc/goto?guid=4959652242682901726">kenjuwagatsuma</a> 的 <a href="/misc/goto?guid=4959669977428184501">MVP Architecture in Android Development</a> 和 <a href="/misc/goto?guid=4959661700496598757">Saúl Molinero</a> 的 <a href="/misc/goto?guid=4959669977540546894">A useful stack on android #1, architecture</a> 之后，我决定采用如下的分层方案来构建这个演示Demo，如下：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/423cfc4aa782b3ee0dd2c16be2e24721.png"></p> <p>分层架构方案</p> <p><br> 总体架构可以被分成四个部分 ：<br> <strong>Presentation</strong>：负责展示图形界面，并填充数据，该层囊括了 View 和 Presenter （上图所示的Model我理解为 ViewModel -- 为 View 提供数据的 Model，或称之为 VO -- View Object）。<br> <strong>Domain</strong>：负责实现app的业务逻辑，该层中由普通的Java对象组成，一般包括 UserCases 和 Business Logic。<br> <strong>Data</strong>：负责提供数据，这里采用了 Repository 模式，Repository 是仓库管理员，Domain 需要什么东西只需告诉仓库管理员，由仓库管理员把东西拿给它，并不需要知道东西实际放在哪。Android 开发中常见的数据来源有，RestAPI、SQLite数据库、本地缓存等。<br> <strong>Library</strong>：负责提供各种工具和管理第三方库，现在的开发一般离不开第三方库（当然可以自己实现，但是不要重复造轮子不是吗？），这里建议在统一的地方管理（那就是建一个单独的 module），尽量保证和 Presentation 层分开。</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/26bd5df0cedb4bbd46ab77bf9f14430e.png"></p> <p>AndroidStudio 中构建项目</p> <h2>5.1. 关于包结构划分</h2> <p>一个项目是否好扩展，灵活性是否够高，包结构的划分方式占了很大比重。很多项目里面喜欢采用按照特性分包（就是Activity、Service等都分别放到一个包下），在模块较少、页面不多的时候这没有任何问题；但是对于模块较多，团队合作开发的项目中，这样做会很不方便。所以，我的建议是按照模块划分包结构。其实这里主要是针对 Presentation 层了，这个演示 Demo 我打算分为四个模块：登录，首页，查询天气和我的（这里仅仅是为了演示需要，具体如何划分模块还得根据具体的项目，具体情况具体分析了）。划分好包之后如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/7ba55d84318e20d5006ccc55804d74b7.png"></p> <p>包结构划分</p> <h2>5.2. 关于res拆分</h2> <p>功能越来越多，项目越做越大，导致资源文件越来越多，虽然通过命名可以对其有效归类（如：通过添加模块名前缀），但文件多了终究不方便。得益于 Gradle，我们也可以对 res 目录进行拆分，先来看看拆分后的效果：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/6adb59178d24df449c9f173c8807de3a.png"></p> <p>按模块拆分 res 目录</p> <p><br> <strong>注意</strong>：resource 目录的命名纯粹是个人的命名偏好，该目录的作用是用来存放那些不需要分模块放置的资源。<br> res 目录的拆分步骤如下：<br> 1) 首先打开 module 的 build.gradle 文件</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/1292801fa7869af24ff0c332c22c4954.png"></p> <p>res 拆分 Step1</p> <p><br> 2) 定位到 defaultConfig {} 与 buildTypes {} 之间</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/6adb59178d24df449c9f173c8807de3a.png"></p> <p>res 拆分 Step2.png</p> <p><br> 3) 在第二步定位处编辑输入 sourceSets {} 内容，具体内容如下：</p> <pre> <code>sourceSets { main { manifest.srcFile 'src/main/AndroidManifest.xml' java.srcDirs = ['src/main/java','.apt_generated'] aidl.srcDirs = ['src/main/aidl','.apt_generated'] assets.srcDirs = ['src/main/assets'] res.srcDirs = [ 'src/main/res/home', 'src/main/res/login', 'src/main/res/mine', 'src/main/res/weather', 'src/main/res/resource', 'src/main/res/' ] } }</code></pre> <p>4) 在 res 目录下按照 sourceSets 中的配置建立相应的文件夹，将原来 res 下的所有文件（夹）都移动到 resource 目录下，并在各模块中建立 layout 等文件夹，并移入相应资源，最后 Sync Project 即可。</p> <h2>5.3. 怎么写 Model</h2> <p>这里的 Model 其实贯穿了我们项目中的三个层，Presentation、Domain 和 Data。暂且称之为 Model 吧，这也我将提供 Repository 功能的层称之为 Data Layer 的缘故（有些称这一层为 Model Layer）。</p> <p><strong>首先</strong>，谈谈我对于 Model 是怎么理解的。应用都离不开数据，而这些数据来源有很多，如网络、SQLite、文件等等。一个应用对于数据的操作无非就是：获取数据、编辑（修改）数据、提交数据、展示数据这么几类。从分层的思想和 JavaEE 开发中积累的经验来看，我觉得 Model 中的类需要分类。从功能上来划分，可以分出这么几类：<br> <strong>VO（View Object）</strong>：视图对象，用于展示层，它的作用是把某个指定页面（或组件）的所有数据封装起来。<br> <strong>DTO（Data Transfer Object）</strong>：数据传输对象，这个概念来源于 JavaEE 的设计模式，原来的目的是为了 EJB 的分布式应用提供粗粒度的数据实体，以减少分布式调用的次数，从而提高分布式调用的性能和降低网络负载，但在这里，我泛指用于展示层与服务层之间的数据传输对象。<br> <strong>DO（Domain Object）</strong>：领域对象，就是从现实世界中抽象出来的有形或无形的业务实体。<br> <strong>PO（Persistent Object）</strong>：持久化对象，它跟持久层（通常是关系型数据库）的数据结构形成一一对应的映射关系，如果持久层是关系型数据库，那么，数据表中的每个字段（或若干个）就对应 PO 的一个（或若干个）属性。</p> <p><strong>注意</strong>：关于vo、dto、do、po可以参考这篇文章-“<a href="/misc/goto?guid=4959669977624637261">领域驱动设计系列文章——浅析VO、DTO、DO、PO的概念、区别和用处</a>”</p> <p>当然这些不一定都存在，这里只是列举一下，可以有这么多分类，当然列举的也不全。</p> <p><strong>其次</strong>，要搞清楚 Domain 层和 Data 层分别是用来做什么的，然后才知道哪些 Model 该往 Data 层中写，哪些该往 Domain 层中写。<br> Data 层负责提供数据。<br> Data 层不会知道任何关于 Domain 和 Presentation 的数据。它可以用来实现和数据源（数据库，REST API或者其他源）的连接或者接口。这个层面同时也实现了整个app所需要的实体类。<br> Domain 层相对于 Presentation 层完全独立，它会实现应用的业务逻辑，并提供 Usercases。<br> Presentation 从 Domain 层获取到的数据，我的理解就是 VO 了，VO 应该可以直接使用。</p> <blockquote> <p>注意：这里说的直接使用是指不需要经过各种转换，各种判断了，如 Activity 中某个控件的显示隐藏是根据 VO 中的 visibility 字段来决定，那么这个最好将 visibility 作为 int 型，而且，取值为VISIBLE/INVISIBLE/GONE，或者至少是 boolean 型的。</p> </blockquote> <p><strong>注意</strong>：这里所谓的业务逻辑可能会于 Presenter 的功能概念上有点混淆。打个比方，假如 usecase 接收到的是一个 json 串，里面包含电影的列表，那么把这个 json 串转换成 json 以及包装成一个 ArrayList，这个应当是由 usecase 来完成。而假如 ArrayList 的 size 为0，即列表为空，需要显示缺省图，这个判断和控制应当是由 Presenter 完成的。（上述观点参考自：<a href="/misc/goto?guid=4959661700496598757">Saúl Molinero</a>）</p> <p><strong>最后</strong>，就是关于 Data 层，采用的 Repository 模式，建议抽象出接口来，Domain 层需要感知数据是从哪里取出来的。</p> <h2>5.4. 怎么写 View</h2> <p>先区分一下Android View、View、界面的区别<br> <strong>Android View</strong>： 指的是继承自android.view.View的Android组件。<br> <strong>View</strong>：接口和实现类，接口部分用于由 Presenter 向 View 实现类通信，可以在 Android 组件中实现它。一般最好直接使用 Activity，Fragment 或自定义 View。<br> <strong>界面</strong>：界面是面向用户的概念。比如要在手机上进行界面间切换时，我们在代码中可以通过多种方式实现，如 Activity 到 Activity 或一个 Activity 内部的 Fragment/View 进行切换。所以这个概念基于用户的视觉，包括了所有 View 中能看到的东西。</p> <p>那么该怎么写 View 呢？</p> <p>在 MVP 中 View 是很薄的一层，里面不应该有业务逻辑，所以一般只提供一些 getter 和 setter 方法，供 Presenter 操作。关于 View，我有如下建议：</p> <ol> <li>简单的页面中直接使用 Activity/Fragment 作为 View 的实现类，然后抽取相应的接口</li> <li>在一些有 Tab 的页面中，可以使用 Activity + Fragment ( + ViewPager) 的方式来实现，至于 ViewPager，视具体情况而定，当然也可以直接 Activity + ViewPager 或者其他的组合方式</li> <li>在一些包含很多控件的复杂页面中，那么建议将界面拆分，抽取自定义 View，也就是一个 Activity/Fragment 包含多个 View（实现多个 View 接口）</li> </ol> <h2>5.5. 怎么写 Presenter</h2> <p>Presenter 是 Android MVP 实现中争论的焦点，上篇中介绍了多种“MVP 框架”，其实都是围绕着<strong>Presenter应该怎么写</strong>。有一篇专门介绍如何设计 Presenter 的文章（<a href="/misc/goto?guid=4959669977718704761">Modeling my presentation layer</a>），个人感觉写得不错，这里借鉴了里面不少的观点，感兴趣的童鞋可以去看看。下面进入正题。<br> 为什么写 Presenter 会这么纠结，我认为主要有以下几个问题：</p> <ol> <li>我们将 Activity/Fragment 视为 View，那么 View 层的编写是简单了，但是这有一个问题，当手机的状态发生改变时（比如旋转手机）我们应该如何处理Presenter对象，那也就是说 Presenter 也存在生命周期，并且还要“手动维护”（别急，这是引起来的，下面会细说）</li> <li>Presenter 中应该没有 Android Framework 的代码，也就是不需要导 Framework 中的包，那么问题来了，页面跳转，显示对话框这些情况在 Presenter 中该如何完成</li> <li>上面说 View 的时候提到复杂的页面建议通过抽取自定义 View 的方式，将页面拆分，那么这个时候要怎么建立对应的 Presenter 呢</li> <li>View 接口是可以有多个实现的，那我们的 Presenter 该怎么写呢</li> </ol> <p>好，现在我将针对上面这些问题一一给出建议。</p> <h3>5.5.1. 关于 Presenter 生命周期的问题</h3> <p>先看图（更详细讲解可以看看这篇文章<a href="/misc/goto?guid=4959669977803308704">Presenter surviving orientation changes with Loaders</a>）</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/6dbe073ed3bd27f780ec5d222162c438.png"></p> <p>Presenter生命周期</p> <p><br> 如上图所示，方案1和方案2都不够优雅（这也是很多“MVP 框架”采用的实现方案），而且并不完善，只适用于一些场景。而方案3，让人耳目一新，看了之后不禁想说 Loader 就是为 Presenter 准备的啊。这里我们抓住几个关键点就好了：</p> <ul> <li>Loader 是 <strong>Android 框架</strong>中提供的</li> <li>Loader 在手机状态改变时是<strong>不会被销毁</strong>的</li> <li>Loader 的生命周期是是由<strong>系统控制</strong>的，会在Activity/Fragment不再被使用后<strong>由系统回收</strong></li> <li>Loader 与 Activity/Fragment 的生命周期绑定，所以<strong>事件会自己分发</strong></li> <li>每一个 Activity/Fragment 持有<strong>自己的 Loader 对象</strong>的引用</li> <li>具体怎么用，在 <a href="/misc/goto?guid=4959669977892346141">Antonio Gutierrez</a> 的文章已经阐述的很明白，我就不再赘述了</li> </ul> <blockquote> <p>好吧，我有一点要补充，上面说的方案1和方案2不是说就没有用了，还是视具体情况而定，如果没有那么多复杂的场景，那么用更简单的方案也未尝不可。能解决问题就好，不要拘泥于这些条条框框...（话说，咱这不是为了追求完美吗，哈哈）</p> </blockquote> <h3>5.5.2. 关于页面跳转和显示Dialog</h3> <p>首先说说页面跳转，前一阵子忙着重构公司的项目，发现项目中很多地方使用 startActivity() 和使用 Intent 的 putExtra() 显得很乱；更重要的是从 Intent 中取数据的时候需要格外小心——类型要对应，key 要写对，不然轻则取不到数据，重则 Crash。还有一点，就是当前 Activity/Fragment 必须要知道目标 Activity 的类名，这里耦合的很严重，有没有。当时就在想这是不是应该封装一下啊，或者有更好的解决方案。于是，先在网上搜了一下，知乎上有类似的提问，有人建议写一个 Activity Router（Activity 路由表）。嗯，正好和我的思路类似，那就开干。</p> <p>我的思路很简单，在 util 包中定义一个 NavigationManager 类，在该类中按照模块使用注释先分好区块（为什么要分区块，去看看我的 “<a href="/misc/goto?guid=4959669977307807484">Android 编码规范</a>”）。然后为每个模块中的 Activity 该如何跳转，定义一个静态方法。</p> <p>如果不需要传递数据的，那就很简单了，只要传入调用者的 Context，直接 new 出 Intent，调用该 Context 的 startActivity() 方法即可。代码如下：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/e177e7032cfeedce7066e1ebcf1fd98d.png"></p> <p>导航管理类-跳转系统页面</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/5db8d7c00bc45ce01b92f5eae5d0c121.png"></p> <p>导航管理类-跳转不需要传递数据的页面</p> <p>如果需要传递数据呢？刚才说了，使用 Bundle 或者 putExtra() 这种方式很不优雅，而且容易出错（那好，你个给优雅的来看看，哈哈）。确实，我没想到比较优雅的方案，在这里我提供一个粗糙的方案，仅供大家参考一下，如有你有更好的，那麻烦也和我分享下。</p> <p>我的方案是这样的，使用序列化对象来传递数据（建议使用 Parcelable，不要偷懒去用 Serializable，这个你懂的）。为需要传递数据的 Activity 新建一个实现了 Parcelable 接口的类，将要传递的字段都定义在该类中。其他页面需要跳转到该 Activity，那么就需要提供这个对象。在目标 Activity 中获取到该对象后，那就方便了，不需要去找对应的 key 来取数据了，反正只要对象中有的，你就能直接使用。</p> <blockquote> <p>注意：这里我建议将序列化对象中的所有成员变量都定义为 public 的，一来，可以减少代码量，主要是为了减少方法数（虽说现在对于方法数超 64K 有比较成熟的 dex 分包方案，但是尽量不超不是更好）；二来，通过对象的 public 属性直接读写比使用 getter/setter 速度要快（听说的，没有验证过）。</p> <p>注意：这里建议在全局常量类（没有，那就定义一个，下面会介绍）中定义一个唯一的 INTENT_EXTRA_KEY，往 Bundle 中存和取得时候都用它，也不用去为命名 key 费神（命名从来不简单，不是吗），取的时候也不用思考是用什么 key 存的，简单又可以避免犯错。</p> </blockquote> <p>具体如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/ae56f9abb0d6aabf52163bd9b40e518a.png"></p> <p>导航管理类-跳转需要传递数据的页面</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/dc89a7f3ebc2e964eae14b6c70f2d800.png"></p> <p>导航管理类-传递数据</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/dfad954b92ce0ee449f3dcd2c2caee4e.png"></p> <p>导航管理类-获取传递的数据</p> <p><br> 导航管理类代码如下：</p> <pre> <code>//==========逻辑方法========== public static <T> T getParcelableExtra(Activity activity) { Parcelable parcelable = activity.getIntent().getParcelableExtra(NavigateManager.PARCELABLE_EXTRA_KEY); activity = null; return (T)parcelable; } private static void overlay(Context context, Class<? extends Activity> targetClazz, int flags, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); setFlags(intent, flags); putParcelableExtra(intent, parcelable); context.startActivity(intent); context = null; } private static void overlay(Context context, Class<? extends Activity> targetClazz, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); putParcelableExtra(intent, parcelable); context.startActivity(intent); context = null; } private static void overlay(Context context, Class<? extends Activity> targetClazz, Serializable serializable) { Intent intent = new Intent(context, targetClazz); putSerializableExtra(intent, serializable); context.startActivity(intent); context = null; } private static void overlay(Context context, Class<? extends Activity> targetClazz) { Intent intent = new Intent(context, targetClazz); context.startActivity(intent); context = null; } private static void forward(Context context, Class<? extends Activity> targetClazz, int flags, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); setFlags(intent, flags); intent.putExtra(PARCELABLE_EXTRA_KEY, parcelable); context.startActivity(intent); if (isActivity(context)) return; ((Activity)context).finish(); context = null; } private static void forward(Context context, Class<? extends Activity> targetClazz, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); putParcelableExtra(intent, parcelable); context.startActivity(intent); if (isActivity(context)) return; ((Activity)context).finish(); context = null; } private static void forward(Context context, Class<? extends Activity> targetClazz, Serializable serializable) { Intent intent = new Intent(context, targetClazz); putSerializableExtra(intent, serializable); context.startActivity(intent); if (isActivity(context)) return; ((Activity)context).finish(); context = null; } private static void forward(Context context, Class<? extends Activity> targetClazz) { Intent intent = new Intent(context, targetClazz); context.startActivity(intent); if (isActivity(context)) return; ((Activity)context).finish(); context = null; } private static void startForResult(Context context, Class<? extends Activity> targetClazz, int flags) { Intent intent = new Intent(context, targetClazz); if (isActivity(context)) return; ((Activity)context).startActivityForResult(intent, flags); context = null; } private static void startForResult(Context context, Class<? extends Activity> targetClazz, int flags, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); if (isActivity(context)) return; putParcelableExtra(intent, parcelable); ((Activity)context).startActivityForResult(intent, flags); context = null; } private static void setResult(Context context, Class<? extends Activity> targetClazz, int flags, Parcelable parcelable) { Intent intent = new Intent(context, targetClazz); setFlags(intent, flags); putParcelableExtra(intent, parcelable); if (isActivity(context)) return; ((Activity)context).setResult(flags, intent); ((Activity)context).finish(); } private static boolean isActivity(Context context) { if (!(context instanceof Activity)) return true; return false; } private static void setFlags(Intent intent, int flags) { if (flags < 0) return; intent.setFlags(flags); } private static void putParcelableExtra(Intent intent, Parcelable parcelable) { if (parcelable == null) return; intent.putExtra(PARCELABLE_EXTRA_KEY, parcelable); } private static void putSerializableExtra(Intent intent, Serializable serializable) { if (serializable == null) return; intent.putExtra(PARCELABLE_EXTRA_KEY, serializable); }</code></pre> <p>传递数据用的序列化对象，如下：</p> <pre> <code>public class DishesStockVO implements Parcelable { public boolean isShowMask; public int pageNum; @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel dest, int flags) { dest.writeByte(isShowMask ? (byte) 1 : (byte) 0); dest.writeInt(this.pageNum); } public DishesStockVO() { } protected DishesStockVO(Parcel in) { this.isShowMask = in.readByte() != 0; this.pageNum = in.readInt(); } public static final Creator<DishesStockVO> CREATOR = new Creator<DishesStockVO>() { public DishesStockVO createFromParcel(Parcel source) { return new DishesStockVO(source); } public DishesStockVO[] newArray(int size) { return new DishesStockVO[size]; } }; @Override public String toString() { return "DishesStockVO{" + "isShowMask=" + isShowMask + ", pageNum=" + pageNum + '}'; } }</code></pre> <p>好像，还没入正题。这里再多说一句，beautifulSoup 写了一篇文章，说的就是 Android 路由表框架的，可以去看看——“<a href="/misc/goto?guid=4959669977984574916">Android路由框架设计与实现</a>”。</p> <p>好了，回到主题，在 Presenter 中该如何处理页面跳转的问题。在这里我建议简单处理，在 View Interface 中定义好接口（方法），在 View 的实现类中去处理（本来就是它的责任，不是吗？）。在 View 的实现类中，使用 NavigationManager 工具类跳转，达到解耦的目的。如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/63fc3659f6a16ab4f61648aba9761910.png"></p> <p>对页面跳转的处理</p> <p><br> 显示对话框<br> 我在这里采用和页面跳转的处理类似的方案，这也是 View 的责任，所以让 View 自己去完成。这里建议每个模块都定义一个相应的 XxxDialogManager 类，来管理该模块所有的弹窗，当然对于弹窗本来就不多的，那就直接在 util 包中定义一个 DialogManager 类就好了。如下图：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/cf43c3645cda018487a53b01c03cdcf5.png"></p> <p>对显示对话框的处理</p> <h3>5.5.3. 一个页面多个View的问题</h3> <p>对于复杂页面，一般建议拆成多个自定义 View，那么这就引出一个问题，这时候是用一个 Presenter 好，还是定义多个 Presenter 好呢？我的建议是，每个 View Interface 对应一个 Presenter，如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/a4ac5f5409bb0ec24ce8363ca2b7b16e.png"></p> <p>一个页面多个 View 处理</p> <h3>5.5.4. 一个View有两个实现类的问题</h3> <p>有些时候会遇到这样的问题，只是展示上有差别，两个页面上所有的操作都是一样的，这就意味着 View Interface 是一样的，只是有两个实现类。</p> <p>这个问题该怎么处理，或许可以继续使用同样的Presenter并在另一个Android组件中实现View接口。不过这个界面似乎有更多的功能，那要不要把这些新功能加进这个Presenter呢？这个视情况而定，有多种方案：一是将Presenter整合负责不同操作，二是写两个Presenter分别负责操作和展示，三是写一个Presenter包含所有操作（在两个View相似时）。记住没有完美的解决方案，编程的过程就是让步的过程。（参考自：<a href="/misc/goto?guid=4959669978067849351">Christian Panadero PaNaVTEC</a> 的 <a href="/misc/goto?guid=4959669977718704761">Modeling my presentation layer</a>）<br> 如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/9fdf36e00f321c27efed2d05d10a7ebf.png"></p> <p>一个 View 多个实现类处理</p> <h2>5.6. 关于 RestAPI</h2> <p>一般项目当中会用到很多和服务器端通信用的接口，这里建议在每个模块中都建立一个 api 包，在该包下来统一处理该模块下所有的 RestAPI。<br> 如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/d4cc324e024e1986bdeaefe8c14d9bd7.png"></p> <p>统一管理 RestAPI</p> <p><br> 对于网络请求之类需要异步处理的情况，一般都需要传入一个回调接口，来获取异步处理的结果。对于这种情况，我建议参考 onClick(View v) {} 的写法。那就是为每一个请求编一个号（使用 int 值），我称之为 taskId，可以将该编号定义在各个模块的常量类中。然后在回调接口的实现类中，可以在回调方法中根据 taskId 来统一处理（一般是在这里分发下去，分别调用不同的方法）。<br> 如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/53731489ebcc728fd6ad494863645d41.png"></p> <p>定义 taskId</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/62ed891f79b8bfc61097c4d5c9718dd1.png"></p> <p>异步任务回调处理</p> <h2>5.6. 关于项目中的常量管理</h2> <p>Android 中不推荐使用枚举，推荐使用常量，我想说说项目当中我一般是怎么管理常量的。<br> 灵感来自 R.java 类，这是由项目构建工具自动生成并维护的，可以进去看看，里面是一堆的静态内部类，如下图：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/0e45176349d3b662a756aec5e0231d71.png"></p> <p>Android 中的 R 文件</p> <p><br> 看到这，可能大家都猜到了，那就是定义一个类来管理全局的常量数据，我一般喜欢命名为 C.java。这里有一点要注意，我们的项目是按模块划分的包，所以会有一些是该模块单独使用的常量，那么这些最好不要写到全局常量类中，否则会导致 C 类膨胀，不利于管理，最好是将这些常量定义到各个模块下面。如下图所示：</p> <p><img alt="Android MVP 详解（下）" src="https://simg.open-open.com/show/d143c51686766d330aadf6e8b98ede3d.png"></p> <p>全局常量 C 类</p> <h2>5.7. 关于第三方库</h2> <p>Android 开发中不可避免要导入很多第三方库，这里我想谈谈我对第三方库的一些看法。关于第三方库的推荐我就不做介绍了，很多专门说这方面的文章。</p> <h3>5.7.1. 挑选第三方库的一些建议</h3> <ol> <li>项目中确实需要（这不是废话吗？用不着，我要它干嘛？呵呵，建议不要为了解决一个小小的问题导入一个大而全的库）</li> <li>使用的人要多（大家都在用的一般更新会比较快，出现问题解决方案也多）</li> <li>效率和体量的权衡（如果效率没有太大影响的情况下，我一般建议选择体量小点的，如，Gson vs Jackson，Gson 胜出；还是 65K 的问题）</li> </ol> <h3>5.7.2. 使用第三方库尽量二次封装</h3> <p>为什么要二次封装？<br> 为了方便更换，说得稍微专业点为了降低耦合。<br> 有很多原因可能需要你替换项目中的第三方库，这时候如果你是经过二次封装的，那么很简单，只需要在封装类中修改一下就可以了，完全不需要去全局检索代码。<br> 我就遇到过几个替换第三方库的事情：</p> <ol> <li>替换项目中的统计埋点工具</li> <li>替换网络框架</li> <li>替换日志工具</li> </ol> <p>那该怎么封装呢？<br> 一般的，如果是一些第三方的工具类，都会提供一些静态方法，那么这个就简单了，直接写一个工具类，提供类似的静态方法即可（就是用静态工厂模式）。<br> 如下代码所示，这是对系统 Log 的简单封装：</p> <pre> <code>/** * Description: 企业中通用的Log管理 * 开发阶段LOGLEVEL = 6 * 发布阶段LOGLEVEL = -1 */ public class Logger { private static int LOGLEVEL = 6; private static int VERBOSE = 1; private static int DEBUG = 2; private static int INFO = 3; private static int WARN = 4; private static int ERROR = 5; public static void setDevelopMode(boolean flag) { if(flag) { LOGLEVEL = 6; } else { LOGLEVEL = -1; } } public static void v(String tag, String msg) { if(LOGLEVEL > VERBOSE && !TextUtils.isEmpty(msg)) { Log.v(tag, msg); } } public static void d(String tag, String msg) { if(LOGLEVEL > DEBUG && !TextUtils.isEmpty(msg)) { Log.d(tag, msg); } } public static void i(String tag, String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { Log.i(tag, msg); } } public static void w(String tag, String msg) { if(LOGLEVEL > WARN && !TextUtils.isEmpty(msg)) { Log.w(tag, msg); } } public static void e(String tag, String msg) { if(LOGLEVEL > ERROR && !TextUtils.isEmpty(msg)) { Log.e(tag, msg); } } }</code></pre> <p>现在如果想替换为 <a href="/misc/goto?guid=4959651437725398993">orhanobut</a> 的 <a href="/misc/goto?guid=4958988896745342899">Logger</a>，那很简单，代码如下：</p> <pre> <code>/** * Description: 通用的Log管理工具类 * 开发阶段LOGLEVEL = 6 * 发布阶段LOGLEVEL = -1 */ public class Logger { public static String mTag = "MVPBestPractice"; private static int LOGLEVEL = 6; private static int VERBOSE = 1; private static int DEBUG = 2; private static int INFO = 3; private static int WARN = 4; private static int ERROR = 5; static { com.orhanobut.logger.Logger .init(mTag) // default PRETTYLOGGER or use just init() .setMethodCount(3) // default 2 .hideThreadInfo() // default shown .setLogLevel(LogLevel.FULL); // default LogLevel.FULL } public static void setDevelopMode(boolean flag) { if(flag) { LOGLEVEL = 6; com.orhanobut.logger.Logger.init().setLogLevel(LogLevel.FULL); } else { LOGLEVEL = -1; com.orhanobut.logger.Logger.init().setLogLevel(LogLevel.NONE); } } public static void v(@NonNull String tag, String msg) { if(LOGLEVEL > VERBOSE && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.v(tag, msg); com.orhanobut.logger.Logger.t(tag).v(msg); } } public static void d(@NonNull String tag, String msg) { if(LOGLEVEL > DEBUG && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.d(tag, msg); com.orhanobut.logger.Logger.t(tag).d(msg); } } public static void i(@NonNull String tag, String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.i(tag, msg); com.orhanobut.logger.Logger.t(tag).i(msg); } } public static void w(@NonNull String tag, String msg) { if(LOGLEVEL > WARN && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.w(tag, msg); com.orhanobut.logger.Logger.t(tag).w(msg); } } public static void e(@NonNull String tag, String msg) { if(LOGLEVEL > ERROR && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.e(tag, msg); com.orhanobut.logger.Logger.t(tag).e(msg); } } public static void e(@NonNull String tag, Exception e) { tag = checkTag(tag); if(LOGLEVEL > ERROR) { // Log.e(tag, e==null ? "未知错误" : e.getMessage()); com.orhanobut.logger.Logger.t(tag).e(e == null ? "未知错误" : e.getMessage()); } } public static void v(String msg) { if(LOGLEVEL > VERBOSE && !TextUtils.isEmpty(msg)) { // Log.v(mTag, msg); com.orhanobut.logger.Logger.v(msg); } } public static void d(String msg) { if(LOGLEVEL > DEBUG && !TextUtils.isEmpty(msg)) { // Log.d(mTag, msg); com.orhanobut.logger.Logger.d(msg); } } public static void i(String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { // Log.i(mTag, msg); com.orhanobut.logger.Logger.i(msg); } } public static void w(String msg) { if(LOGLEVEL > WARN && !TextUtils.isEmpty(msg)) { // Log.w(mTag, msg); com.orhanobut.logger.Logger.v(msg); } } public static void e(String msg) { if(LOGLEVEL > ERROR && !TextUtils.isEmpty(msg)) { // Log.e(mTag, msg); com.orhanobut.logger.Logger.e(msg); } } public static void e(Exception e) { if(LOGLEVEL > ERROR) { // Log.e(mTag, e==null ? "未知错误" : e.getMessage()); com.orhanobut.logger.Logger.e(e == null ? "未知错误" : e.getMessage()); } } public static void wtf(@NonNull String tag, String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.i(tag, msg); com.orhanobut.logger.Logger.t(tag).wtf(msg); } } public static void json(@NonNull String tag, String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.i(tag, msg); com.orhanobut.logger.Logger.t(tag).json(msg); } } public static void xml(@NonNull String tag, String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { tag = checkTag(tag); // Log.i(tag, msg); com.orhanobut.logger.Logger.t(tag).xml(msg); } } public static void wtf(String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { // Log.i(tag, msg); com.orhanobut.logger.Logger.wtf(msg); } } public static void json(String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { // Log.i(tag, msg); com.orhanobut.logger.Logger.json(msg); } } public static void xml(String msg) { if(LOGLEVEL > INFO && !TextUtils.isEmpty(msg)) { // Log.i(tag, msg); com.orhanobut.logger.Logger.xml(msg); } } private static String checkTag(String tag) { if (TextUtils.isEmpty(tag)) { tag = mTag; } return tag; }</code></pre> <p>这里是最简单的一些替换，如果是替换网络框架，图片加载框架之类的，可能要多费点心思去封装一下，这里可以参考“门面模式”。（在这里就不展开来讲如何对第三库进行二次封装了，以后有时间专门写个帖子）</p> <h3>5.7.3. 建立单独的 Module 管理所有的第三库</h3> <p>原因前面已经说过了，而且操作也很简单。网上有不少拆分 Gradle 文件的方法，讲的都很不错。那我们就先从最简单的做起，赶快行动起来，把项目中用到的第三方库都集中到 Library Module 中来吧。</p> <h2>5.8. MVP vs MVVM</h2> <p>关于 MVP 和 MVVM 我只想说一句，它们并不是相斥的。具体它们是怎么不相斥的，<a href="/misc/goto?guid=4959669978216830590">markzhai</a> 的这篇文章“<a href="/misc/goto?guid=4959669978296794832">MVPVM in Action, 谁告诉你MVP和MVVM是互斥的</a>”说得很详细。</p> <h2>5.9. Code</h2> <p>抱歉，要食言了，AndroidStudio 出了点问题，代码还没写完，代码估计要这周末才能同步到 <a href="/misc/goto?guid=4959669978380495202">GitHub</a> 上了，目前只上传了一个空框架。</p> <h2>5.10. 小结</h2> <p>历时三天的 MVP 总结，总算要告一段落了。前期断断续续地花了将近一周左右零散的时间去调研 MVP，直到正式开始码字的时候才发现准备的还不够。看了很多文章，有观点一致的，也有观点很不一致的。最关键的是，自己对于 MVP 还没有比较深刻的认知，所以在各种观点中取舍花了很长时间。<br> 这算得上是我第一次真正意义上的写技术性的文章，说来惭愧，工作这么长时间了，现在才开始动笔。<br> 总体来说，写得并不尽如人意，套一句老话——革命尚未成功，同志仍需努力。这算是一次尝试，希望以后会越写越顺畅。在这里给各位坚持看到此处的看官们问好了，祝大家一同进步。（欢迎大家围观我的<a href="/misc/goto?guid=4959669963181087807">GitHub</a>，周末更新，会渐渐提交更多有用的代码的）</p> <h2>6. 进阶与不足</h2> <p>鉴于本人能力有限，还有很多想写的和该写的内容没有写出来，很多地方表达的也不是很清晰。下面说一说我觉得还有哪些不足和下一步要进阶的方向。</p> <ol> <li>说好的“show me the code”，代码呢？（再次抱歉了）</li> <li>上篇当中关于各种 Presenter 方案只是做了简单的罗列，并没有仔细分析各个方案的优点和不足</li> <li>没有形成自己的框架（呵呵，好高骛远了，但是梦想还是要有的...）</li> <li>没有单元测试（项目代码都还没有呢，提倡 TDD 不是，呵呵）</li> <li>很多细节没有介绍清楚（如关于Model、Domain、Entity 等概念不是很清晰）</li> <li>很多引用的观点没有指明出处（如有侵权，马上删除）<br> ......</li> </ol> <p>最后想说一句，没有完美的架构，没有完美的框架，赶紧编码吧！</p> <h2>7. 附录</h2> <p>附上我的思维导图：<br> <a href="/misc/goto?guid=4959669978488994891">MVPBestPractice.mmap</a><br> <a href="/misc/goto?guid=4959669978575410433">MVP总结.mmap</a><br> <a href="/misc/goto?guid=4959669978658224756">Presenter生命周期.mmap</a><br> <a href="/misc/goto?guid=4959669978756864500">怎么写Presenter.mmap</a></p> <p>参考：<br> <a href="/misc/goto?guid=4959669964442457390">https://segmentfault.com/a/1190000003871577</a><br> <a href="http://www.open-open.com/lib/view/open1450008180500.html">http://www.open-open.com/lib/view/open1450008180500.html</a><br> <a href="/misc/goto?guid=4959669978866990177">http://www.myexception.cn/android/2004698.html</a><br> <a href="/misc/goto?guid=4959669978958131939">http://gold.xitu.io/entry/56cbf38771cfe40054eb3a34</a><br> <a href="/misc/goto?guid=4959669979039329970">http://kb.cnblogs.com/page/531834/</a><br> <a href="/misc/goto?guid=4959669978296794832">http://blog.zhaiyifan.cn/2016/03/16/android-new-project-from-0-p3/</a><br> <a href="http://www.open-open.com/lib/view/open1446377609317.html">http://www.open-open.com/lib/view/open1446377609317.html</a><br> <a href="/misc/goto?guid=4959669979140460428">http://my.oschina.net/mengshuai/blog/541314?fromerr=3J2TdbiW</a><br> <a href="/misc/goto?guid=4959669979222689824">http://gold.xitu.io/entry/56fcf1f75bbb50004d872e74</a><br> <a href="/misc/goto?guid=4959669979314410700">https://github.com/googlesamples/android-architecture/tree/todo-mvp-loaders/todoapp</a><br> <a href="/misc/goto?guid=4959669978296794832">http://blog.zhaiyifan.cn/2016/03/16/android-new-project-from-0-p3/</a><br> <a href="/misc/goto?guid=4959669963853068626">http://android.jobbole.com/82375/</a><br> <a href="/misc/goto?guid=4959669979450951960">http://blog.csdn.net/weizhiai12/article/details/47904135</a><br> <a href="/misc/goto?guid=4959669979541033996">http://android.jobbole.com/82051/</a><br> <a href="/misc/goto?guid=4959669963539524378">http://android.jobbole.com/81153/</a><br> <a href="/misc/goto?guid=4959668205062328010">http://blog.chengdazhi.com/index.php/115</a><br> <a href="/misc/goto?guid=4959669962506300577">http://blog.chengdazhi.com/index.php/131</a><br> <a href="/misc/goto?guid=4959669965341842004">http://原网站已经失效/article/android-mvp-practice.html</a><br> <a href="/misc/goto?guid=4959669965833010283">http://www.wtoutiao.com/p/h01nn2.html</a><br> <a href="/misc/goto?guid=4958835641839039298">http://blog.jobbole.com/71209/</a><br> <a href="/misc/goto?guid=4959669966001575500">http://www.cnblogs.com/tianzhijiexian/p/4393722.html</a><br> <a href="/misc/goto?guid=4959669979854923282">https://github.com/xitu/gold-miner/blob/master/TODO/things-i-wish-i-knew-before-i-wrote-my-first-android-app.md</a><br> <a href="/misc/goto?guid=4959669979943359483">http://gold.xitu.io/entry/56cd79c12e958a69f944984c</a><br> <a href="/misc/goto?guid=4958986814445309986">http://blog.yongfengzhang.com/cn/blog/write-code-that-is-easy-to-delete-not-easy-to/</a><br> <a href="/misc/goto?guid=4959669966628029078">http://kb.cnblogs.com/page/533808/</a></p> <p>原文链接：http://www.jianshu.com/p/0590f530c617<br> </p>