第一步 Android studio 项目配置
在build.gradle 中添加以下配置
compile ‘io.reactivex.rxjava2:rxjava:2.1.1’
compile ‘io.reactivex.rxjava2:rxandroid:2.0.1’
compile ‘com.squareup.retrofit2:retrofit:2.3.0’
compile ‘com.squareup.retrofit2:converter-gson:2.3.0’
complie ‘com.squareup.retrofit2:adapter-rxjava2:2.3.0’
complie ‘com.squareup.okhttp3:logging-intereceptor:3.8.0’
注意事项 retrofit2.3.0 是基于OKHttp3.8.0 添加
com.squareuo.okhttp3:logging-intereceptor:3.8.0
注意版本要一致，否则运行时会失败
第二步 retrofit 注解
注解 retrofit通过使用注解来简化请求，大体分为以下几类：
retrofit通过使用注解来简化请求，大体分为以下几类
1.用于标注请求方式的注解
2.用于标记请求头的注解
3.用于标记请求参数的注解
4.用于标记请求和响应格式的注解
请求方法注解
注解 说明
GET get请求
POST post请求
PUT put请求
DELETE delete请求
PATCH patch请求，该请求是对put请求的补充，用于更新局部资源
HEAD head请求
OPTIONS option请求
HTTP 通用注解,可以替换以上所有的注解，其拥有三个属性：method，path，hasBody
请求头注解
注解 说明
Headers 用于添加固定请求头，可以同时添加多个。通过该注解添加的请求头不会相互覆盖，而是共同存在
Header 作为方法的参数传入，用于添加不固定值的Header，该注解会更新已有的请求头
请求参数注解
名称 说明
Body 多用于post请求发送非表单数据,比如想要以post方式传递json格式数据
Filed 多用于post请求中表单字段,Filed和FieldMap需要FormUrlEncoded结合使用
FiledMap 和@Filed作用一致，用于不确定表单参数
Part 用于表单字段,Part和PartMap与Multipart注解结合使用,适合文件上传的情况
PartMap 用于表单字段,默认接受的类型是Map，可用于实现多文件上传
Path 用于url中的占位符
Query 用于Get中指定参数
QueryMap 和Query使用类似
Url 指定请求路径
请求和响应格式注解
名称 说明
FormUrlEncoded 表示请求发送编码表单数据，每个键值对需要使用@Field注解
Multipart 表示请求发送multipart数据，需要配合使用@Part
Streaming 表示响应用字节流的形式返回.如果没使用该注解,默认会把数据全部载入到内存中.该注解在在下载大文件的特别有用
第三步 retrofit 基础类创建
创建请求
publicinterfaceRetrofitService{
@POST("Account/Login")
Observable> login(@BodyLogin login);
@GET("Order/Query")
Observable>> queryOrder(@Query("page")intpage,@Query("pageSize")intpageSize,
@Query("status")intstatus,@Query("time") String time,
@Query("date") String date,@Query("key") String key,
@Query("token") String token);
}
创建拦截器
* 创建日志拦截器
*
*@return
*/
privatestaticHttpLoggingInterceptorlogInterceptor(){
HttpLoggingInterceptor logInterceptor =newHttpLoggingInterceptor(newHttpLoggingInterceptor.Logger(){
@Verride
publicvoidlog(String message){
Log.e("OKhttp","log= "+ message);
}
});
logInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
returnlogInterceptor;
}
创建OKHttpClient
privatestaticOkHttpClient okHttpClient =newOKHttpClient.Builder()
//添加通用的 Header 拦截器替换原有的COOKIE 可根据需要自行添加不同拦截器
.addInterceptor(newInterceptor(){
@Override
publicResponseintercept(Chain chain)throwsIOException{
//替换原有的COOKIE
Request request = chain.request();
Request.Builder builder = request.newBuilder().removeHeader("COOKIE");
builder.addHeader("COOKIE", cookie)
returnchain.procedd(builder.build());
}
.addInterceptor(logInterceptor())
.connectTimeout(30, TimeUint.SECONDS)
.readTimeout(100, TimeUint.SECONDS)
.build();
})
提供retrofit 方法调用
RetrofitService retrofitService =newRerofit.Builder()
.baseUrl(baseUrl)
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.cilent(okHttpClient)
.build()
.create(RetrofitService.class);
publicstaticRetrofitServicegetInstance(){
returnretrofitService;
}
接口调用
Login login =newLogin("name","passWord");
ObserVable> obserVable = RetrofitFactory.getInstance.login(login);
observable.subscribeOn(Schedulers.io())
.filter(userBaseBean -> userBaseBean.isResult())
.map(userBaseBean -> {
Constant.setLogUser(userBeseBean.getData());
returnuserBaseBean.getData();
}).observeOn(AndroidSchedulers.mainThread())
.subscribe(userBean ->{
startActivity(newIntetn(context, MainActivity.class));
})
增加通用ObserVable
publicabstractclassBaseObserverimplementsObserver>{
privatestaticfinalString TAG ="BaseObserver";
privateContext mContext;
publicBaseObserver(Context mContext){
this.mContext = mContext;
}
@Override
publicvoidonSubscribe(@NonNull Disposable d){
}
@Override
publicvoidonNext(@NonNull BaseBean tBaseBean){
if(tBaseBean.isResult()){
onHandleSuccess(tBaseBean.getData());
}else{
onHandleError(tBaseBean.getMessage());
}
}
@Override
publicvoidonError(@NonNull Throwable e){
LogUtil.e(e.toString(), BaseObserver.class);
}
@Override
publicvoidonComplete(){
LogUtil.d("onComplete()", BaseObserver.class);
}
protectedabstractvoidonHandleSuccess(T t);
protectedvoidonHandleError(String msg){
LogUtil.e(msg, getClass());
Looper mainLooper = mContext.getMainLooper();
newHandler(mainLooper).post(() -> {
if(mContextinstanceofParentActivity){
((ParentActivity) mContext).hideLoading();
}elseif(mContextinstanceofParentFragmentActivity)
((ParentFragmentActivity) mContext).hideLoading();
FinalToast.ErrorContext(mContext, msg);
});
}
}
