类库介绍 EasyAndroid

• 现在Android的框架很多，第三方库也很多，当做一个项目的时候，会考虑怎么整合那么多的资源，以达到复用快速开发。
• 今天要说的这个框架就是整合了主流Retrofit2网络层封装、Fresco图片加载、都使用OKHTTP3进行网络处理、使用MVP架构，来快速灵活开发复用我们的项目。

框架说明

Retrofit2

为什么要使用它呢？我们来想想如果不使用它的话，我们直接操作OKHTTP3的网络请求，还需要做哪些操作？当发送请求的时候，来封装要以get或者post方式发送，然后回来了GJSON解析成我们需要的实体对象，还要看返回的数据相应码等等，来正确解析我们的数据，那么Retrofit2就是为了高效解决这些事情的，当然Retrofit2不止这些功能，具体大家可看API。

Fresco

比较了一些主流的图片加载以及各种对比，Fresco算是综合比较好的，支持较多，更新及时。

OKHTTP3

不解释了 大家都在用

Other类库

都是一些用的比较多的，Cookie自动管理、View注入Butterknife、以及RecycleView下拉刷新BaseRecyclerViewAdapterHelper、Utilcode工具库、Logger日志库 大家以前没用过的可以关注下 都很好用 灵活

MVP 架构思想

下面重点说一下MVP的Clean模式，现在MVP很火，大行其道，不搞一套MVP架构都感觉缺少点啥，哈哈，为什么呢？MVP难道就是简单的加了一个Presenter层吗？显然不是，它是一种思想，如果简单的一个应用每个Activity类中500行搞定，还需要MVP吗？我觉得就不适合了。越大型的APP、越复杂的APP才会让你觉得MVP的好。怎么做到让代码各司其职。

MVP Clean模式

上面这张图就是Clean的架构，为什么需要Clean架构呢，我们来想想，我们把业务逻辑部分都放到了Presenter层，如果这个页面做的逻辑很多，十来个业务操作（请求数据，数据库操作等），这样Presenter也会非常庞大，既然臃肿，我们继续抽象，在Presenter层下面在加一层Use Cases Domain层，专门处理增删改查等任务岂不业务更清晰明了，Presenter只需要执行相关UseCases任务，操作完回调处理就OK了。

MVP Dagger2模式

Dagger2又是个什么东东？我想说你写了Activity或者Fragment依赖Prensenter，然后呢Clean模式又让Presenter依赖UseCases，每次new一个实例进去，然后传递啊等等，想想都累，那么Dagger2可以帮你生成这些实例，你依赖啥，我注入啥，这就是它的精髓依赖注入，不止这些，第三方库，以及其它的提供者都可以进行注入，只要你需要，还有我们的Presenter对象的实例生命周期你怎么管理，UseCases层的对象呢，这一切Dagger2可以帮你做到，可以自定义Scopes，java自动帮你处理

还有一点差点忘了为什么叫Dagger2，版本号2呢，因为它2，哈哈，因为Dagger1使用的是运行时反射机制，这样会影响性能，Dagger2使用编译时自动生成对应代码，直接运行性能不会受到影响。

怎么使用这个库

DEMO代码结构图

• com.wjj.easy.easyandroidHelper
  
  • common
    
    • base
      
      • BaseActivity
      • BaseFragment
      • BasePresenter
      • BaseView
      • SimpleActivity
      • SimpleFragment
    • di
      
      • ActivityCommonComponent
      • AppCommonComponent
      • AppCommonModule
      • FragmentCommonComponent
    • net
      
      • ApiService
      • AppHttp
  • model
  • module
    
    • login
      
      • LoginActivity
      • LoginContract
      • LoginPresenter
  • utils
  • AppApplication

在app module里面common包里面包含了业务逻辑层需要实现的代码演示，大家拷贝到自己项目中就行了，里面的base包包含基本的Activity、Fragment封装，我们用的时候只要在继承的时候指定需要的Presenter，会自动帮我们生成这个Presenter实例。

public class LoginActivity extends BaseActivity<LoginPresenter>

di包，就是我们的dagger2使用包了，在这里面提供我们的实例，生成我们通用的注入器，不懂不要紧，不要关心，拿过去用就行了，只用来做一些presenter、task、全局实例的注入、其它大可不必用这个，本来是为了增加代码健壮性、提高效率的不能本末倒置了。要你做的就是在ActivityCommonComponent或者FragmentCommonComponent中注入我们要添加的Activity或者Fragment就行了。

/**
 * Activity注入器
 * @author wujiajun
 */
@ActivityScope
@Component(dependencies = AppCommonComponent.class, modules = {ActivityModule.class})
public interface ActivityCommonComponent extends ActivityComponent {

    void inject(LoginActivity activity);

    void inject(MainActivity activity);
}

net就是Retrofit2封装 ApiService包含全部的接口请求，包括请求参数、请求方式、地址、文件上传、下载，请求格式，都可以注解操作。

    /**
     * 获取注册验证码
     */
    @FormUrlEncoded
    @POST(HOST + "app/sendSMS.do")
    Call<BaseStatus> getVerifyCode(@Field("username") String username, @Field("password") String pwd);

AppHttp就是对我们的接口进行调用处理

    public void getVerifyCode(String username, String pwd, final Http.HttpCallback<BaseStatus> callback) {
        Call<BaseStatus> call = apiService.getVerifyCode(username, pwd);
        call.enqueue(new Http.CallbackDefault(callback));
        call.request();
    }

module里面拿login来举例吧 LoginActivity对LoginPresenter的依赖，以及LoginPresenter对LoginContract.View的依赖，都在类继承的时候指定就好了，会自动帮你生成，不需要传递。

/**
 * 登录Activity
 *
 * @author wujiajun
 */

public class LoginActivity extends BaseActivity<LoginPresenter> implements LoginContract.View {

    @BindView(R.id.set_user_name)
    EditText setUserName;
    @BindView(R.id.set_pwd)
    EditText setPwd;
    @BindView(R.id.set_verify_code)
    EditText setVerifyCode;
    @BindView(R.id.get_verify_code)
    TextView getVerifyCode;
    @BindView(R.id.tv_login)
    TextView tvLogin;
    @BindView(R.id.tool_bar)
    Toolbar toolbar;

    @Override
    protected void initInject() {
        getActivityComponent().inject(this);
    }

    @Override
    protected void initEventAndData() {
        toolbar.setLogo(R.mipmap.icon_app);
        toolbar.setTitle(R.string.app_name);
        toolbar.setTitleTextColor(ContextCompat.getColor(this, R.color.white));
        toolbar.setTitleMarginStart(getResources().getDimensionPixelSize(R.dimen.padding_size_30));
        setSupportActionBar(toolbar);
    }

    @Override
    protected int getContentView() {
        return R.layout.activity_login;
    }


    @OnClick({R.id.get_verify_code, R.id.tv_login})
    public void onClick(View view) {
        switch (view.getId()) {
            case R.id.get_verify_code:
                getPresenter().getVerifyCode(setUserName.getText().toString(), setPwd.getText().toString());
                startActivity(new Intent(this, MainActivity.class));
                break;
            case R.id.tv_login:
                getPresenter().login(setUserName.getText().toString(), setPwd.getText().toString(), setVerifyCode.getText().toString());
                break;
        }
    }

}

• Presenter也是一样，关注于Task的执行

/**
 * Login Presenter
 * Created by wujiajun on 17/4/7.
 */
public class LoginPresenter extends BasePresenter<LoginContract.View> implements LoginContract.Presenter {

    @Inject
    GetVerifyCodeTask mGetVerifyCodeTask;
    @Inject
    LoginTask mLoginTask;

    @Inject
    public LoginPresenter() {
    }

    @Override
    public void getVerifyCode(String userName, String pwd) {
        mGetVerifyCodeTask.setUserName(userName);
        mGetVerifyCodeTask.setPwd(pwd);
        mGetVerifyCodeTask.setCallback(new UseCase.Callback<BaseStatus>() {
            @Override
            public void success(BaseStatus baseStatus) {
                getView().toast("getVerifyCode success!");
            }

            @Override
            public void fail() {
                getView().toast("getVerifyCode fail!");
            }
        });
        getThreadExecutor().execute(mGetVerifyCodeTask);
    }

    @Override
    public void login(String userName, String pwd, String verifyCode) {
        getView().showLoading();
        mLoginTask.setUserName(userName);
        mLoginTask.setPwd(pwd);
        mLoginTask.setVerifyCode(verifyCode);
        mLoginTask.setCallback(new UseCase.Callback<LoginResponse>() {
            @Override
            public void success(LoginResponse loginResponse) {
                getView().toast("login success!");
            }

            @Override
            public void fail() {
                getView().toast("login fail!");
            }
        });
        getThreadExecutor().execute(mLoginTask);
    }
}

domain层只关注于怎么完成这个任务 请求验证码或者登陆操作

/**
 * 获取验证码任务
 *
 * @author wujiajun
 */

public class GetVerifyCodeTask extends AbstractUseCase {

    String publicKey = "11";

    String userName;
    String pwd;

    @Inject
    AppHttp appHttp;

    @Inject
    public GetVerifyCodeTask() {
    }

    @Override
    public void run() {
        appHttp.getVerifyCode(userName, SecretUtils.encryptByPublicKey(pwd, publicKey), new Http.HttpCallback<BaseStatus>() {
            @Override
            public void onResponse(BaseStatus baseStatus) {
                getCallback().success(baseStatus);
            }

            @Override
            public void onFailure(Throwable t) {
                getCallback().fail();
            }
        });
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

}

结语

EasyAndroid框架的主要部分都一一介绍了一下，以及它的思想，关于MVP这些我也参考了很多，简单DEMO的很多，真正能够使用的很少，写这个也想大家少走弯路，希望把这个框架能够不断完善，至少DEMO中内容很少，感兴趣的可以Fork修改，有什么好的建议可以私聊我。

GitHub地址

https://github.com/wu928320442/EasyAndroid

需要的环境

• JDK1.8
• SDK
• AndroidStudio开发工具

特性

• 整合主流HTTP网络、图片加载、MVP（Clean＋Dagger2）架构的一套快速高效的开发框架
• 包含app library 两个Module 组件化开发

用到的第三方框架

• SDK自带扩展依赖包
• Retrofit2网络层处理 使用OKHTTP3处理
• Fresco图片加载处理 使用OKHTTP3处理
• OKHTTP3 HTTP基础库，提供给网络层处理和图片加载
• PersistentCookieJar快速Cookie持久化与缓存库
• Dagger2 依赖注入库，整合Activity，Fragment，Presenter，Task之间的依赖关系
• Butterknife View的注入库
• BaseRecyclerViewAdapterHelper Recycler下拉加载库
• Utilcode实用工具库
• Logger 一个简洁漂亮的日志打印库

类库导入

compile ‘com.wjj.easy:easyandroid:1.0.0‘

联系方式

• QQ 928320442
• Email wujiajun311@gmail.com

参考资料

• https://github.com/googlesamples/android-architecture
• https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html
• https://google.github.io/dagger/
• https://github.com/Blankj/AndroidUtilCode
• https://github.com/franmontiel/PersistentCookieJar
• https://github.com/codeestX/GeekNews
• https://github.com/JakeWharton/butterknife
• https://github.com/square/retrofit
• https://github.com/CymChad/BaseRecyclerViewAdapterHelper
• https://github.com/android10/Android-CleanArchitecture
• http://www.jianshu.com/p/cd2c1c9f68d4