WxNews一款Android开源小项目



https://github.com/yangwenxin/wxNews

一款基于 Material Design + Rxjava2 + Retrofit + dagger2 + MVP 构架项目

前言

之前在工作当中一直使用的是Mvc模式,一个逻辑复杂的界面会导致Activity当中代码过于臃肿,这样很不便于阅读,后期维护性也很差,代码看起来乱糟糟的,大部分同学应该有过这种的感受(公司突然扔给你一个项目说有个bug处理下,打开后发现Activity上千行,代码各种乱,阅读性极差,心里瞬间想太阳dog,还只能含泪改bug....)所以为了避免以上情况的发生,坚定了要学习Mvp并运用在新项目中的决心。

MVP架构模式

相信大家对mvp已经非常熟悉了,我就说一下自己的理解好了

mvp架构模式可以提高代码的可维护性、可扩展性以及可阅读性。

它将view层和model层做了分离,用一个presenter当做桥梁来交互。

Model

Model用于获取数据,比如项目初期后台接口还没有完善,那么就需要模拟一些数据返回来显示界面,接口完善后,修改下返回方式即可。

View

View一般表示我们常用的Activity或Fragment,主要用于和用户的交互,那么它只需要做显示的操作即可。

Presenter

Presenter是用作Model和View之间交互的桥梁,比如View层调用mPresenter.XXXX()函数去请求网络,Presenter会从Model中获取到数据,处理完逻辑之后回调到View层去显示

WxNews一款Android开源小项目_第1张图片

Retrofit + okhttp + Rxjava联网

用法不过多介绍,推荐两篇文章

给 Android 开发者的 RxJava 详解 ,扔物线 大佬的rxjava详解

从微观角度解读RxJava源码 ,张磊 大佬分析的rxjava1.1.9的源码,十分详细

常用姿势

1.联网过程中弹出dialog给用户友好的提示

2.特定的界面需要多状态显示比如(加载中、联网失败、数据为空)

姿势1

该姿势其实在项目中非常的常见,使用频率也非常高,几乎每一个请求都要显示和隐藏dialog,当时对于刚刚上手mvp+Retrofit+Rxjava的我一脸懵逼,后来看到有人在View层回调出两个方法showDialog()和hideDialog(),然后就屁颠屁颠的定义在了BaseView中使用起来。

后来发现每个界面我都需要这样回调出两个方法,实在是太麻烦了,有没有什么方式能通过框架封装一下省去这个操作?

沿着这个思路我就研究了rxjava的源码,当时使用的是rxjava1 在源码会发现subscribe订阅时会先调用Subscriber的onStart(),(rx2是onSubscribe(Disposabled))这个方法就可以很好的利用起来做一些准备操作,比如我们想实现的showDialog();

于是就封装了一个Callback来实现Observer接口 (rxjava2)

public abstract class Callback implements Observer {

     private Context mContext;//该context必须是Activity的context

     public ProgressDialogHandler mHandler;//用于显示dialog

     public Callback() {  //无参构造表示不显示dialog

     }

    public Callback(Context context) {//传递activity的context进行联网显示dialog

                   this.mContext=context;

                   mHandler=newProgressDialogHandler(context);

    }

   @Override

    public void onSubscribe(Disposable d) { 

                 showProgressDialog();//联网前显示dialog

                 subscribe(d);//添加到CompositeDisposable中用于onDestroy时解除订阅

     }

    @Override 

     public void onError(Throwable e) {

                 LogUtils.e("出错了 -------------- "+e.toString());

                 onFailure();

                 dismissProgressDialog();//发生错误隐藏dialog

      }

     @Override

     public void onComplete() {

             dismissProgressDialog();//执行结束隐藏dialog

     }

    @Override

     public void onNext(T t) {

          HttpResult result= (HttpResult)t;

         if(!result.isError()) {//成功

              onSuccess(t);

         }

    }

    private void showProgressDialog() {

         if(mHandler!=null){

mHandler.obtainMessage(ProgressDialogHandler.SHOW_PROGRESS_DIALOG).sendToTarget();

         }

    }

private void dismissProgressDialog() {

       if(mHandler!=null) {

mHandler.obtainMessage(ProgressDialogHandler.DISMISS_PROGRESS_DIALOG).sendToTarget();

         mHandler=null;

      }

}

protected abstract void subscribe(Disposabled);

protected abstract void onFailure();

protected abstract void onSuccess(T t);

}

以上代码便是实现方式,subscribe订阅时直接new CallBack() 通过是否传递context来决定是否显示dialog,但是有一个比较坑的一点创建dialog时,如果传入构造方法不是一个activity类型的上下文会抛出抛出BadTokenException异常

如果该问题感兴趣 请看此文章 创建Dialog所需的上下文为什么必须是Activity?

姿势2

多状态布局其实是代理了一个FrameLayout,我们都知道FrameLayout帧布局非常简单,摆放的控件是一个一个叠加在左上角的,那么就可以创建三个我们需要显示状态的布局添加进framelayout

在LoadingPage的构造方法中执行了一个init()方法,去添加3种不同状态的布局

WxNews一款Android开源小项目_第2张图片

并且记录几种需要的状态,之后通过showPage()去决定界面的显示状态;


WxNews一款Android开源小项目_第3张图片

这样我们就可以封装到BaseFragment中去使用,Fragment中onCreateView需要返回一个View,那么我们就可以直接返回一个LoadingPage

WxNews一款Android开源小项目_第4张图片


在loadDeta当中去进行联网操作,无论是成功失败,都可以通过setState,改变当前LoadingPage所记录的state调用showPage进行界面状态的改变,如果是success,那么就会调用LoadingPage的getLayout去获取我们的布局id创建一个successView添加在Loadingpage当中,之后会调用initView,  LoadingPage的initView调用了我们BaseFragment抽象出的init方法这样可以在当中去初始化加载成功的界面了,setAdapter.......

WxNews一款Android开源小项目_第5张图片

好了,就说到这里吧0.0 

希望看到此项目的同学能有所收获,如果有好的建议欢迎issue,我们共同学习进步!

总结

感谢 代码家 的开放api接口

感谢 JessYan 大佬的 MVPArms 使我从中学习到了dagger2的应用姿势。

感觉dagger2其实是这些框架当中比较难理解的,之所以没讲是因为我也懂的不是很多,刚开始接触确实不太容易理解,经常研究着就懵逼了,直到现在掌握的也不是很好,但是我认为dagger2的分层很重要,比如Retrofit的创建等等 我们希望是它在应用中的实例只有一个,那么就需要通过Application Component在Application中去注入创建实例,再注入到Activity Component去供Activity使用。

当然这只是最近学习中一些自己的看法,并不一定正确,dagger2的学习之路还很长。。。

你可能感兴趣的:(WxNews一款Android开源小项目)