MVP实战心得---封装Retrofit2

2401_84132479

于 2024-04-18 07:30:45 发布

阅读量628

点赞数 13

分类专栏：程序员文章标签： echarts 前端 javascript

本文链接：https://blog.csdn.net/2401_84132479/article/details/137901396

版权

程序员专栏收录该内容

170 篇文章 1 订阅

订阅专栏

传送门:RxJava---------这个作为入门学习rxjava非常好

2.Retrofit

这个写点基本的用法吧…

首先看用的包:

//retrofit2–看名字就知道是啥了
compile ‘com.squareup.retrofit2:retrofit:2.1.0’
//CallAdapterFactory的Rx依赖包—导这个包才能配合rxAndroid使用
compile ‘com.squareup.retrofit2:adapter-rxjava:2.1.0’
//ConverterFactory的String依赖包----这个是解析数据的工厂.用来格式化数据的,配置编码啊,gson解析啊.
compile ‘com.squareup.retrofit2:converter-scalars:2.1.0’

然后是retrofit注解：(使用retrofit,注解是很重要的)

方法注解 : 包含@GET、@POST、@PUT、@DELETE、@PATCH、@HEAD、@OPTIONS、@HTTP。

这个不多讲.一般用的就是@GET、@POST,很明显,一个是get请求,一个是post请求

标记注解 : 包含@FormUrlEncoded、@Multipart、@Streaming。
这个得和参数注解一起说

参数注解 : 包含@Query,@QueryMap、@Body、@Field，@FieldMap、@Part，@PartMap。

@Get---------用的参数注解就@Query,@QueryMap,

@Post--------则会用到 @Body、@Field，@FieldMap、@Part，@PartMap。

@Body-------将数据转化成Json,然后post.具体转化根据设置的解析工厂(下面有讲)
---------------------------------------------------分割线----------------------------------------------------------
@Field，@FieldMap------post上传表单.@Field表示单个,@FieldMap表示集合.
需要添加上面的@FormUrlEncoded表示表单提交 ,
对应Content-Type:application/x-www-form-urlencoded
如:
@FormUrlEncoded
@POST(“login的url”)
Observable login(@Field(“name”) String name, @FieldMap Map params);
--------------------------------------------------分割线------------------------------------------------------------
@Part，@PartMap----post上传文件/数据.@Part表示单个,@PartMap表示集合.
其中@Part MultipartBody.Part 类型代表文件，@Part(“key”) RequestBody类型代表参数
需要添加@Multipart表示支持文件上传的表单，Content-Type: multipart/form-data
@Multipart
@POST(“update的url”)
Observable update(@Part (“file”) MultipartBody.Part file, @Part(“key”) RequestBody key,@PartMap Map<String,RequestBody> files);
如果参数较少,使用@Part (“file”)就可以解决了,如果参数较多,那就需要使用@PartMap了.

其他注解 : @Path、@Header,@Headers、@Url
这几个用处挺大的,这里就不细说了,并不是必用的,我用的不多.

Retrofit 配置代码.

//这个是处理网络请求的log信息的,可以实现Interceptor接口来自定义.
HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger() {
@Override
public void log(String message) {
HLog.i(“RxJava”, message);
}
});

OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(interceptor)
.build();
Retrofit retrofit = new Retrofit.Builder()
.client(client)//Retrofit需要配置一个OkHttpClient实例.
.baseUrl(API_HOST)//需要指定一个baseUrl,一般就是服务器的域名
.addConverterFactory(FastjsonConverterFactory.create())//这个是数据解析工厂,我用的是fastjson
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())//支持rxJava,在第二个jar包里面
.build();

下面是完整代码:

/**

写成单例模式,因为并不需要多个Retrofit存在.
/
public class RetrofitUtil {
/*
服务器地址
*/
private static final String API_HOST =“你的BaseUrl”;
private RetrofitUtil() {

}
public static Retrofit getRetrofit() {
return Instanace.retrofit;
}
//静态内部类,保证单例并在调用getRetrofit方法的时候才去创建.
private static class Instanace {
private static final Retrofit retrofit = getInstanace();
private static Retrofit getInstanace() {
HttpLoggingInterceptor interceptor = new HttpLoggingInterceptor(new HttpLoggingInterceptor.Logger(){
@Override
public void log(String message) {
HLog.i(“RxJava”, message);
}
});
OkHttpClient client = new OkHttpClient.Builder()
.addInterceptor(interceptor)
.build();
Reretrofit = new Retrofit.Builder()
.client(client)
.baseUrl(API_HOST)
.addConverterFactory(FastjsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.build();
return retrofit;
}
}
}

json解析工厂,代码太多,具体可以见demo

3.RxAndroid

如果没接触的话,可以看前面的Rxjava链接.

(1).首先看Reretrofit+RxAndroid是怎么使用的

@GET(“login地址”)
Observable<BaseResponse> login(@QueryMap HashMap<String, Object> params);

其实所谓的Reretrofit+RxAndroid就是这么回事.

没有RxAndroid的Reretrofit请求接口是这样写的:

@GET(“login地址”)
Call<BaseResponse> login(@QueryMap HashMap<String, Object> params);

把Call换成了Observable而已.

(2)写一个接口类

/**
*所有的网络请求都可以写在这个接口类里面.
*/
public interface APIService {
@GET(“login地址”)
Observable<BaseResponse> login(@QueryMap HashMap<String, Object> params);
…
}

(3)接口类的实现

/**

请求生成类。Retrofit一次生成,并作为单例.
*/
public class ApiServcieImpl {
private ApiServcieImpl() {

}
public static APIService getInstance() {
return createAPIService.apiService;
}

/**

Retrofit生成接口对象.
*/
private static class createAPIService {
//Retrofit会根据传入的接口类.生成实例对象.
private static final APIService apiService = RetrofitUtil.getRetrofit().create(APIService.class);
}
}

然后就可以通过ApiServcieImpl.getInstance()去调用APIService里面写的接口了. 如:

ApiServcieImpl.getInstance().login(new HashMap<String, Object>()) //传入参数
.subscribe(new Action1<BaseResponse>() {//简单的回调
@Override
public void call(BaseResponse loginDataBaseResponse) {
//拿到数据,做处理
}
});

4.封装

有没有发现,设置泛型的是,包了一层BaseResponse 这么做是为了请求完成后对返回的数据进行统一处理.

先看BaseResponse:

public class BaseResponse {
private boolean success;//请求是否成功
private int resultCode;//状态吗
private String msg;//返回的提示消息
private T data;//主要内容,因为不知道返回的会是什么类型,所以用泛型来表示
//get set方法就不贴了.
}

怎么处理.

/**

@author jlanglang 2016/11/15 16:14
*/
public class ModelFilteredFactory {
private final static Observable.Transformer transformer = new SimpleTransformer();

/**

将Observable<BaseResponse>转化Observable,并处理BaseResponse
@return 返回过滤后的Observable.
*/
@SuppressWarnings(“unchecked”)
public static Observable compose(Observable<BaseResponse> observable) {
return observable.compose(transformer);
}

/**

这里就不细讲了,具体可以去看rxjava的使用.这个类的意义就是转换Observable.
*/
private static class SimpleTransformer implements Observable.Transformer<BaseResponse, T> {
//这里对Observable,进行一般的通用设置.不用每次用Observable都去设置线程以及重连设置
@Override
public Observable call(Observable<BaseResponse> observable) {
return observable.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.unsubscribeOn(Schedulers.io())
.timeout(5, TimeUnit.SECONDS)//重连间隔时间
.retry(5)//重连次数
.flatMap(new Func1<BaseResponse, Observable>() {
@Override
public Observable call(BaseResponse tBaseResponse) {
return flatResponse(tBaseResponse);
}
});
}

/**

处理请求结果,BaseResponse
@param response 请求结果
@return 过滤处理, 返回只有data数据的Observable
*/
private Observable flatResponse(final BaseResponse response) {
return Observable.create(new Observable.OnSubscribe() {
@Override
public void call(Subscriber<? super T> subscriber) {
if (response.isSuccess()) {//请求成功
if (!subscriber.isUnsubscribed()) {
subscriber.onNext(response.getData());
}
} else {//请求失败
int resultCode = response.getResultCode();
if (!subscriber.isUnsubscribed()) {
//这里抛出自定义的一个异常.可以处理服务器返回的错误.
subscriber.onError(new APIException(response.getResultCode(), response.getMsg()));
}
return;
}
if (!subscriber.isUnsubscribed()) {//请求完成
subscriber.onCompleted();
}
}
});
}
}
}

仅仅只有上面那些了么?接着看.

/**

@author jlanglang 2016/11/14 17:32
Subscriber,这个是用来处理Observable的结果的.
*/
public abstract class SimpleSubscriber extends Subscriber {

@Override
public void onCompleted() {//这个是请求完成时调用.如果走了onError()就不会走这个方法.

}

@Override
public void onError(Throwable e) {//这里通常就处理异常
if (e instanceof APIException) {
APIException exception = (APIException) e;
ToastUtil.showToast( exception.message);
} else if (e instanceof UnknownHostException) {
ToastUtil.showToast(“请打开网络”);
} else if (e instanceof SocketTimeoutException) {
ToastUtil.showToast( “请求超时”);
} else if (e instanceof ConnectException) {
ToastUtil.showToast(“连接失败”);
} else if (e instanceof HttpException) {
ToastUtil.showToast(“请求超时”);
}else {
ToastUtil.showToast(“请求失败”);
}
e.printStackTrace();
}

@Override
public void onNext(T t) {//这里的是获得了数据,方法意思很明显,下一步干啥
if (t != null) {//这里最好判断一下是否为null.
call(t);
} else {
ToastUtil.showToast(“连接失败”);
}
}
/**
*因为具体的处理这里无法得知,所以抽象.
*/
public abstract void call(T t);
}

好了,看看现在的具体使用吧:

ModelFilteredFactory.compose(ApiServcieImpl.getInstance().login(new HashMap<String, Object>()))
.subscribe(new SimpleSubscriber() {
@Override
public void call(LoginData loginData) {

}
});
看起来之前用起来差不多,但是却做了很多的处理:
1.对Observable做了通用设置.网络重连次数,线程设置,重连时间.
2.做了对服务器返回结果的统一处理.比如根据resultcode,处理登陆过期啊啥的.
3.判断了data是否为null,不会在call()里面担心loginData是否为null
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。