概述

Retrofit是一个OkHttp网络请求框架的封装库,Retrofit通过注解配置网络参数,可以按照我们的规则去构造实际的HTTP请求,能够灵活设置URL、头部、请求体、返回值等,是目前最优雅的一个网络框架。

添加依赖


implementation 'com.squareup.retrofit2:retrofit:2.2.0'

implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'//添加对RxJava的支持
implementation 'com.squareup.retrofit2:converter-gson:2.1.0' //添加Json数据的支持

<uses-permission android:name="android.permission.INTERNET"/>//网络请求必要的权限


Retrofit基本使用三部曲

创建实例


Retrofit retrofit = new Retrofit.Builder()
          .baseUrl("http://id1.option****.cc:***1/")//Retrofit2 的baseUlr 必须以 /(斜线) 结束
          .build();
RetrofitService service = retrofit.create(RetrofitService.class);//创建接口的代理对象


定义接口


public interface RetrofitService {
    
    @GET("/pursuit/getPursuitInfo")
    Call<ResponseBody> getBlog(@Query("id") int id);

    @GET("/pursuit/getPursuitInfo/{id}")
    Call<ResponseBody> getBlog2(@Path("id") String id);
    
}


创建 同步/异步 回调 


//异步的回调
Call<ResponseBody> call = service.getBlog(123);
call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, retrofit2.Response<ResponseBody> response) {
        try {
            Log.i("返回信息",response.body().string()+"");//打印返回信息
        } catch (IOException e) {
            e.printStackTrace();
        }

    }
    @Override
    public void onFailure(Call<ResponseBody> call, Throwable t) {
        t.printStackTrace();//错误信息
    }
});

/*同步的回调,如果不是在一个Activity或者一个Fragment中去执行,那么也就意味着,你可以不需要开启子线程去执行网络请求。如果是在主线程,就必须开启子线程来进行同步请求
使用call.execute()同步请求,只能调用一次。如果要多次使用这个方法,需要 call.clone()重新生成新的Call实例*/

new Thread(new Runnable() {
    @Override
    public void run() {
        try {
            retrofit2.Response<ResponseBody> response = call.execute();
            response.body();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
});


HTTP协议中的常用请求

GET: 请求指定的页面信息,以?分割URL和传输数据,参数之间以&相连,最多只能是1024字节,并返回实体主体,该操作用于获取信息而非修改信息

HEAD: 只请求页面的首部。

POST: POST表示可能修改变服务器上的资源的请求,.POST的安全性要比GET的安全性高

PUT: 从客户端向服务器传送的数据取代指定文档的内容。

Retrofit注解的重点详解

注解汇总

需要理解并灵活搭配使用

android retrofit网络请求取消 安卓网络请求框架retrofit_表单

基本请求

Responsebody是Retrofit网络请求回来的原始数据类。get方式可以在url后面串联

@Path注解用于替换请求参数,@Query注解相当于url后面的串联,他们可以同时使用

请看下面第三种表达式:


@GET("/pursuit/getPursuitInfo?id=123")
Call<ResponseBody>  getCall();

@POST("/pursuit/getPursuitInfo")
Call<ResponseBody> getBlog(@Query("id") int id);

@GET("/pursuit/getPursuitInfo/{id}")
Call<ResponseBody> getBlog2(@Path("id") String id);


自定义请求

需要用到@HTTP注解


/* method:网络请求的方法,注意大小写
 * path:网络请求地址路径
 * hasBody:是否有请求体
 * {id} 表示是一个变量*/
@HTTP(method = "GET", path = "/pursuit/getPursuitInfo/{id}", hasBody = false)
Call<ResponseBody> getCall(@Path("id") int id);


请求体非Form表单

@Body是Post方式提交非Form的表单


@POST("/pursuit/getPursuitInfo")
Observable<String> getPursuitInfo(@Body User user);


请求体是Form表单

如果请求的Form表单,需要用@FormUrlEncoded标注,@Field注解用于表单字段,它和@FieldMap都需要@FormUrlEncoded配合使用

@Field和@Query都是表单字段,@FieldMap和@Query都是批量增加表单的提交域。区别如上图,一个拼接在URL上适用于get方式,一个体现在请求体上试用于post方式,区分好使用场景。


@POST("/pursuit/getPursuitInfo") 
@FormUrlEncoded 
Call<ResponseBody> testFormUrlEncoded1(@Field("username") String name, @Field("age") int age);


设置请求头

两种请求头的,@Header用于添加不固定的请求头,作用于方法的参数。@Headers用于添加固定的请求头,作用于方法


@Headers("Authorization: authorization")
@GET("/pursuit/getPursuitInfo")
Call<ResponseBody> getUser();

@GET("/pursuit/getPursuitInfo")
Call<ResponseBody> getUser(@Header("Authorization") String authorization);


动态替换URL

用@Url替换已经设置的baseUrl


@GET
public Call<ResponseBody> profilePicture(@Url String url);


图片上传


@POST("user/updateAvatar.do")
@Multipart
Call<ResponseBody> upload(@Part("upload1\"; filename=\"image1.jpg\"") RequestBody imgs );


文件上传

发送form-encoded的数据,用于有文件上传的场景时要用 @Multipart 注解,@Part和@PartMap适用于有文件上传的情况


@POST("mobile/upload")
@Multipart
Call<ResponseBody> upload(@Part MultipartBody.Part file);


※以上就是所有参数注解的用法,需要实践灵活试用。

Retrofit与Gson

添加对gson的支持


Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("http://id1.option****.cc:***1/")//Retrofit2 的baseUlr 必须以 /(斜线) 结束
        .addConverterFactory(GsonConverterFactory.create())//添加对gson的支持
        .build();


建立接口,返回Bean


public interface PostRoute {
   @Headers({"Content-Type: application/json","Accept: application/json"})//需要添加头
   @POST("api/FlyRoute/Add")
   Call<FlyRouteBean> postFlyRoute(@Body RequestBody route);//传入的参数为RequestBody
}


将Bean转换成json字符串


FlyRouteBean flyRouteBean=new FlyRouteBean();
        flyRouteBean=initdata(flyRouteBean);//根据Bean类初始化一个需要提交的数据类
        Gson gson=new Gson();
        String route= gson.toJson(flyRouteBean);//通过Gson将Bean转化为Json字符串形式


提交json数据


RequestBody body=RequestBody.create(okhttp3.MediaType.parse("application/json; charset=utf-8"),route); //将json转换成RequestBody请求体
Call<FlyRouteBean> call=postRoute.postFlyRoute(body);//提交


Retrifit与RxJava

引入RxJava


compile 'io.reactivex.rxjava2:rxjava:2.1.0'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'


 添加对RxJava的支持


Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("http://id1.option****.cc:***1/")//Retrofit2 的baseUlr 必须以 /(斜线) 结束
        .addConverterFactory(GsonConverterFactory.create())//添加对gson的支持                                       
        .client(client)//添加okhttp的支持
        .addCallAdapterFactory(RxJava2CallAdapterFactory.create())//添加对RxJava的支持
        .build();


连接超时与开启okhttp的日志打印


private static final OkHttpClient client = new OkHttpClient.Builder().
            addInterceptor(new HttpLoggingInterceptor().//开启日志信息
            setLevel(HttpLoggingInterceptor.Level.BODY)).
            connectTimeout(600, TimeUnit.SECONDS).//连接超时
            readTimeout(600, TimeUnit.SECONDS).//读取超时
            writeTimeout(600, TimeUnit.SECONDS).build();//写入超时


建立接口,返回Observable被观察者


@GET("top250")
Observable<MovieEntity> getTopMovie(@Query("start") int start, @Query("count") int count);


建立观察者


Observable<String> observable =service.getTopMovie(0, 10)
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(new Observer<ResponseBody>() {
        @Override
        public void onSubscribe(Disposable d) {

        }

        @Override
        public void onNext(ResponseBody responseBody) {

        }

        @Override
        public void onError(Throwable e) {

        }

        @Override
        public void onComplete() {

        }
    });


Retrofit的简单封装

retrofit工具类


public class WebManager {
    private static WebManager webManager;
    private RetrofitService retrofitService;
    public WebManager(Context context) {
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(StaticConstant.HOST_PORT)//地址
                .addConverterFactory(GsonConverterFactory.create())//添加gson支持
                .client(client)//设置okhttp连接
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create())//添加RxJava的支持
                .build();
        retrofitService = retrofit.create(RetrofitService.class);
    }
    private static final OkHttpClient client = new OkHttpClient.Builder().
            addInterceptor(new HttpLoggingInterceptor().//开启日志信息
            setLevel(HttpLoggingInterceptor.Level.BODY)).
            connectTimeout(600, TimeUnit.SECONDS).//连接超时
            readTimeout(600, TimeUnit.SECONDS).//读取超时
            writeTimeout(600, TimeUnit.SECONDS).build();//写入超时
    //获取单例
    public static WebManager getInstance(Context context){
        if(webManager == null){
            webManager = new WebManager(context);
        }
        return webManager;
    }
    //上传xx信息,使用@Field注解
    public void postInfoField(Callback<ResponseBody> callback, String str){
        retrofitService.getWarrant("queryApplicationForm",null,str)
                .enqueue(callback);
    }
    //上传xx信息,使用@FieldMap注解
    public void postInfoFieldMap(Callback<ResponseBody> callback, String num,String name){
        Map<String, Object> map=new HashMap<>();
        map.put("hotelCode",num);
        map.put("hotelName",name);
        retrofitService.getUnlicensedNum(map).enqueue(callback);
    }
    //上传xx信息,使用@Body 注解
    public void postMultipartBody(Callback<ResponseBody> callback, String key,File file, String name){
        MultipartBody.Builder builder=  new MultipartBody.Builder().setType(MultipartBody.FORM);
        if(file.exists()) {
            builder.addFormDataPart("access_token", key);
            builder.addFormDataPart("name", name);
            builder.addFormDataPart("image", ImageUtil.imageToBase64(file.getPath()));
            builder.addFormDataPart("image_type", "BASE64");
        }
        retrofitService.getUnlicensedCheck(builder.build()).enqueue(callback);
    }
    //上传xx信息,带文件,使用@Body 注解
    public void postMultipartBody2(Callback<ResponseBody> callback, HotelInfo hotelInfo,String pictureCardPath,String picturePath){
        Gson gson=new Gson();
        String json= gson.toJson(hotelInfo);
        File file = new File(pictureCardPath);
        File file2 = new File(picturePath);
        MultipartBody.Builder builder=  new MultipartBody.Builder().setType(MultipartBody.FORM);
        if(!file.exists()&&!file2.exists()) {
            try {
                builder.addFormDataPart("info", json);
                builder.addFormDataPart("file",file.getName(), RequestBody.create(MediaType.parse("multipart/form-data"), file));
                builder.addFormDataPart("file2",file2.getName(), RequestBody.create(MediaType.parse("multipart/form-data"), file2));
                retrofitService.getHotelInfoFile(builder.build()).enqueue(callback);
            } catch (Exception e) {
                e.printStackTrace();
                Log.i("WebManager","上传异常");
            }
        }
    }
    
}


retrofit服务类


public interface RetrofitService {
    @FormUrlEncoded
    @POST("/Hotels/ExpressServlet")
    Call<ResponseBody> getWarrant(@Field("type") String type, @Field("E_Code") String code, 
    @Field("applicationFormId") String id);

    @FormUrlEncoded
    @POST("Hotels/NoRegisterServlet")
    Call<ResponseBody> getUnlicensedNum(@FieldMap Map<String,Object> fieldMap);

    @POST("/rest/2.0/face/v3/person/verify")
    Call<ResponseBody> getUnlicensedCheck(@Body MultipartBody builder);

    @Headers("Connection: close" )
    @POST("/Hotels/UploadFileImgServlet")
    Call<ResponseBody> getHotelInfoFile(@Body MultipartBody builder);

}


 

Retrofit代码混淆配置


-dontwarn retrofit.**
-keep class retrofit.** { *; }
-keepattributes Signature
-keepattributes Exceptions