Retrofit 2.0基於OKHttp更高效更快的網絡框架 以及自定義轉換器

時間關係，本文就 Retrofit 2.0的簡單使用 作講解  至於原理之後有空再去分析

項目全面、簡單、易懂  地址：

關於Retrofit 2.0的簡單使用以下：  https://gitee.com/bimingcong/MyRetrofit

private void initGet() {
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://v.juhe.cn/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        GetService service = retrofit.create(GetService.class);
        final Call<GetBean> call = service.getString3("toutiao", "shehui", "d05b58fa6901ad9bed77a1ef08bd6ccb");
     
call.enqueue(new Callback<GetBean>() {
            @Override
            public void onResponse(Call<GetBean> call, Response<GetBean> response) {
                if (response.isSuccessful()) {
                    GetBean = response.body();
                  
                }
            }

            @Override
            public void onFailure(Call<GetBean> call, Throwable t) {
                
             
            }
        });

    }

 其中的GetService是幹嗎的    裏邊的@query其實能夠理解爲get請求url  ？後邊那一串參數的鍵值對

public interface GetService {
    //直接拼接,記得加問號
    @GET("toutiao/index?type=shehui&key=d05b58fa6901ad9bed77a1ef08bd6ccb")
    Call<GetBean> getString();

    //{name}能夠最簡單的將其理解爲路徑替換塊，用」{}」表示，與註解@path配合使用 ,爲了解耦,參數name==toutiao
    @GET("{name}/index?type=shehui&key=d05b58fa6901ad9bed77a1ef08bd6ccb")
    Call<GetBean> getString2(@Path("name") String name);

    //對於@GET來講，參數信息是能夠直接放在url中上傳的。那麼你立刻就反應過來了，這同樣也存在嚴重的耦合！
    //因而，就有了@query
    @GET("{name}/index")
    Call<GetBean> getString3(@Path("name") String name, @Query("type") String type
            , @Query("key") String key);

    //假設我要在參數中上傳10個參數呢？這意味着我要在方法中聲明10個@Query參數？固然不是！
    //Retrofit也考慮到了這點，因此針對於複雜的參數上傳，爲咱們準備了@QueryMap
    @GET("{name}/index")
    Call<GetBean> getString4(@Path("name") String name, @QueryMap HashMap<String, String> hashMap);

    //通常Get都沒有請求體,因此直接獲取接口網址便可 Url動態化
    @GET()
    Observable<ResponseBody> getString5(@Url String url);

}

針對Post請求  其中的@Field 其實能夠理解爲 post要提交的 參數鍵值對  其中還有單個文件 以及多個文件的上傳

public interface PostService {
    @FormUrlEncoded
    @POST("toutiao/index")
    Call<PostBean> postString(@Field("type") String type, @Field("key") String key);

    // Post表單提交-多個參數-@FieldMa
    @FormUrlEncoded
    @POST("toutiao/index")
    Call<PostBean> postString2(@FieldMap HashMap<String, String> params);

    // Post文件提交 ，每一個鍵值對都須要用@Part註解鍵名字
    //Multipart 支持文件上傳
    @Multipart
    @POST("https://pan.baidu.com/disk/home?#/all?vmode=list&path=%2Fas")
    Call<TestBean> postFile(@Part("photo\";filename=\"test.png\"") RequestBody body);

    @Multipart
    @POST("xxxx")
    Call<TestBean> postFile2(@PartMap HashMap<String, RequestBody> bodyMap, @Field("token") String token);


}

對應的例子以下：

//當我獲取數據成功後要作什麼處理
    public interface OnSuccessListener {
        void onSuccess(Object o);

        void onFaile();
    }

 

 //提供一些方法去調用service實體類的方法，RequestBody上傳單個文件
    public void uploadFile(RequestBody body, final OnSuccessListener listener) {
        Call<TestBean> call = mService.postFile(body);
        call.enqueue(new Callback<TestBean>() {
            @Override
            public void onResponse(Call<TestBean> call, Response<TestBean> response) {
                listener.onSuccess(response);
            }

            @Override
            public void onFailure(Call<TestBean> call, Throwable t) {
                listener.onFaile();
            }
        });

    }

 

轉換器：

至於自定義轉換器 就是 下邊這個參數

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://v.juhe.cn/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();

 好比咱們只但願返回數據是String類型，咱們須要自定義一個ConverterFactory

public class StringConverFactory extends Converter.Factory {
    public static StringConverFactory create() {
        return new StringConverFactory();
    }
 
    @Override
    public Converter<ResponseBody, ?> responseBodyConverter(Type type, Annotation[] annotations,
                                                            Retrofit retrofit) {
        Log.d("wyz", "讀取數據:responseBodyConverter" + type);
        if (type == String.class) {//此處的Type類型 個人理解是一開始Call對象參數定義的返回值類型
            Log.d("wyz", "執行開始");
            return StringResponseBodyConverter.INSTANCE;
        }
        return null;
    }
 
    @Nullable
    @Override
    public Converter<?, RequestBody> requestBodyConverter(Type type, Annotation[] parameterAnnotations, Annotation[] methodAnnotations, Retrofit retrofit) {
        Log.d("wyz", "請求數據類型:" + type);
        if (type == NetRequest.class){
 
        }
        return null;
    }

final class StringResponseBodyConverter implements Converter<ResponseBody, String> {
    public static final StringResponseBodyConverter INSTANCE =new StringResponseBodyConverter();
    @Override
    public String convert(ResponseBody value) throws IOException {
        Log.d("wyz", "轉換開始:" + value);
        String s = value.string();
        return s;
    }

最後將 ConvertFactory設置到Retrofit實例中就能夠了

retrofit = new Retrofit.Builder()
                .baseUrl(BASE_URL)
                .client(getOkHttpClient())
                .addConverterFactory(StringConverFactory.create())

 

日誌：

最後對於 紅色的部分是添加一個自定義的Client 此處主要是對相應級別的日誌去攔截

在retrofit2.0中是沒有日誌功能的。可是retrofit2.0中依賴OkHttp，因此也就可以經過OkHttp中的interceptor來實現實際的底層的請求和響應日誌。在這裏咱們須要修改上一個retrofit實例，爲其自定自定義的OkHttpClient。代碼以下：

HttpLoggingInterceptor httpLoggingInterceptor = new HttpLoggingInterceptor();
httpLoggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
OkHttpClient okHttpClient = new OkHttpClient.Builder()
        .addInterceptor(httpLoggingInterceptor)
        .build();

Retrofit retrofit = new Retrofit.Builder().addCallAdapterFactory(RxJavaCallAdapterFactory.create())
        .client(okHttpClient)
        .baseUrl("https://api.github.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build();

須要添加依賴：

compile 'com.squareup.okhttp3:logging-interceptor:3.1.2'

 

效果：

 

更加詳細的Demo  能夠去個人開源中國裏看 https://gitee.com/bimingcong/MyRetrofit