Android MVP 详解(下)
<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>
本文由用户 樱桃大丸子 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!