mvp+dagger2+retrofit2+rxjava 项目框架 最佳实践

概述

转载地址：http://www.jianshu.com/p/d7b9efde7e15

原来一直在用Android最原生的框架进行开发，最多也就使用了butterknife,减少了很多的findviewById。前段时间看google的IO大会，偶尔听到了新型的Android开发框架dagger2等等，然后对此框架产生了浓厚的兴趣。

通过一段时间的深入学习，把我的学习分享出来，希望大家能够喜欢。

mvp+dagger2+retrofit2+rxjava 一套开发模式自我感觉将是以后Android开发的趋势，尽早的用起来吧。

使用新型框架能给我们带来什么好处？
解耦，降低模块耦合度。
可以更方便的写单元测试。
减少Activity编码
提高团队协作的效率
提高编码的效率
提高代码的可读性

示例：

本文示例功能：
retrofit2+Rxjava进行Http和Https网络请求封装
MVP工程结构
Rxjava的使用示例
dagger2的使用示例

说明

阅读此文首先你要对以下技术有一定的了解。对以上技术还不熟悉的朋友可以先去了解一下。

在我阅读过无数相关技术文章之后，我给大家推荐这些技术学习的文章：

dagger2

理论：http://android.jobbole.com/82694/

实例(网络上没有找到合适的，我自己写的一篇博文)：http://www.jianshu.com/p/269c3f70ec1e

官方:http://google.github.io/dagger/

mvp:

这个理论很简单，自己百度或者google吧

示例：https://github.com/googlesamples/android-architecture

retrofit2:

官方：http://square.github.io/retrofit/

rxjava:

偏理论:http://gank.io/post/560e15be2dca930e00da1083

偏实践：http://blog.chinaunix.net/uid-20771867-id-5187376.html

对上面的
10b54
技术有一定的了解后，我们开始一个示例：

架构搭建

首先我们要一个示例的方式来详细说明整体项目的架构与思想

示例功能；

登录功能
检查用户名和密码是否合法
登录按钮如果不合法则不可点击，合法后登录按钮可以点击
调用登录接口进行登录
将用户名和密码保存本地

文章列表
从网络获取文章列表并展示
将文章列表保存到数据库
点击列表进入文章详情
网络获取图片

单元测试
集成测试
单元测试

整体架构图

未命名.png

运行webserver json

//安装json-server
$ npm install -g json-server
//进入工程目录
$ cd AndroidArchitecture/
//运行服务
json-server --watch login.json

运行后可以通过此地址访问接口
http://localhost:3000/users
http://localhost:3000/topics

关于工程

由于工程代码较多，在这里就不一一将代码贴出了，详细的demo地址见我的github
https://github.com/wlj32011/AndroidArchitecture

下图为demo目录接口，查看demo源码可以参考此结构



AndroidArchitecture.png

关键代码

网络请求返回消息体统一错误处理

消息体结构

//登录
{
"status_msg" : "登录成功",
"status_code" : 200,
"data" : {
"username" : "admin",
"id" : 1,
"password" : "123456",
"gender" : "男"
}
}

模型结构

public class BaseResponse<T> {

private int status_code;
private String status_msg;
private T data;

public int getStatus_code() {
return status_code;
}

public void setStatus_code(int status_code) {
this.status_code = status_code;
}

public String getStatus_msg() {
return status_msg;
}

public void setStatus_msg(String status_msg) {
this.status_msg = status_msg;
}

public T getData() {
return data;
}

public void setData(T data) {
this.data = data;
}
}

使用Rxjava对象变换

public class BaseResponseFunc<T> implements Func1<BaseResponse<T>, Observable<T>> {

@Override
public Observable<T> call(BaseResponse<T> tBaseResponse) {
//遇到非200错误统一处理,将BaseResponse转换成您想要的对象
if (tBaseResponse.getStatus_code() != 200) {
return Observable.error(new Throwable(tBaseResponse.getStatus_msg()));
}else{
return Observable.just(tBaseResponse.getData());
}
}
}

自定义订阅者

/**
* 错误统一处理
*
* Created by wanglj on 16/7/4.
*/

public class ExceptionSubscriber<T> extends Subscriber<T> {

private SimpleCallback<T> simpleCallback;
private Application application;

public ExceptionSubscriber(SimpleCallback simpleCallback, Application application){
this.simpleCallback = simpleCallback;
this.application = application;
}

@Override
public void onStart() {
super.onStart();
if(simpleCallback != null)
simpleCallback.onStart();
}

@Override
public void onCompleted() {
if(simpleCallback != null)
simpleCallback.onComplete();
}

@Override
public void onError(Throwable e) {
e.printStackTrace();
if (e instanceof SocketTimeoutException) {
Toast.makeText(application, "网络中断，请检查您的网络状态", Toast.LENGTH_SHORT).show();
} else if (e instanceof ConnectException) {
Toast.makeText(application, "网络中断，请检查您的网络状态", Toast.LENGTH_SHORT).show();
} else {
Toast.makeText(application, "error:" + e.getMessage(), Toast.LENGTH_SHORT).show();
}
if(simpleCallback != null)
simpleCallback.onComplete();
}

@Override
public void onNext(T t) {
if(simpleCallback != null)
simpleCallback.onNext(t);
}
}

简单的回调模型

public interface SimpleCallback<T> {
void onStart();
void onNext(T t);
void onComplete();
}

presenter层调用

public void login(String username,String password){
apiManager.login(username, password, new SimpleCallback<User>() {
@Override
public void onStart() {
loginView.showLoading();
}

@Override
public void onNext(User user) {
loginView.showUser(user);
}

@Override
public void onComplete() {
loginView.hideLoading();
}
});
}

对外提供ApiManager以及retrofit的封装

@Module
public class ApiModule {
@Provides
@Singleton
public OkHttpClient provideOkHttpClient() {
final OkHttpClient.Builder builder = new OkHttpClient.Builder();
//添加logo日志打印网络请求的拦截器
if (BuildConfig.DEBUG) {
HttpLoggingInterceptor logging = new HttpLoggingInterceptor();
logging.setLevel(HttpLoggingInterceptor.Level.BODY);
builder.addInterceptor(logging);
}

builder.connectTimeout(60 * 1000, TimeUnit.MILLISECONDS)
.readTimeout(60 * 1000, TimeUnit.MILLISECONDS);

return builder.build();
}

@Provides
@Singleton
public Retrofit provideRestAdapter(OkHttpClient okHttpClient) {
Retrofit.Builder builder = new Retrofit.Builder();
builder.client(okHttpClient)
.baseUrl(ApiService.SERVER_URL)
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.addConverterFactory(GsonConverterFactory.create());
return builder.build();
}

@Provides
@Singleton
public ApiService provideApiService(Retrofit restAdapter) {
return restAdapter.create(ApiService.class);
}

@Provides
@Singleton
public ApiManager provideApiManager(Application application,ApiService githubApiService) {
return new ApiManager(githubApiService,application);
}

}

所有的全局共用对象都可以在AppModule里对外提供，比如PreferencesManager DatabaseManager等等

更高级的用法--dagger2 划分更细的scope

目前demo示例是将功能模块直接依赖于整个APP，其实我们可以划分更细的作用域。使一个对象的生命周期存在于多个功能模块中。

比如：项目中登录成功后，获取文章列表需要用户信息，获取文章详情以及文章下的评论列表，又需要当前文章和用户的信息。那么我们就可以这样设计我们的工程架构如图：



scope.png