Android Retrofit2詳解

一、什麼是Retrofit2？

1、Retrofit2是一個RESTful網絡請求工具庫，是Square公司基於OkHttp網絡庫封裝而成的，它可以直接將HTTP API轉換為Java語言的接口。

2、Retrofit2的目標是使HTTP訪問更簡單、更快捷、更有趣，它在很大程度上簡化了與HTTP客戶端的交互過程。使用Retrofit2，可以使網絡請求代碼變得更加清晰、簡潔。

3、Retrofit2具有類型安全、可解析、高效、易用、可擴展等優點。

二、如何使用Retrofit2？

1、依賴庫：在build.gradle文件中添加以下內容：

dependencies {
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
}

2、定義接口：定義一個Java接口，使用Retrofit2的註解將HTTP API轉換為Java接口。

public interface ApiService {
    @GET("api/data/{type}/{count}/{page}")
    Call getGankData(@Path("type") String type, @Path("count") int count, @Path("page") int page);
}

3、創建Retrofit實例：使用Retrofit2的Builder設計模式創建Retrofit實例，在構造中指定基礎URL和一個轉換器Factory，可以使用多個轉換器，如轉換為Gson數據類型等。

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(baseUrl)
        .addConverterFactory(GsonConverterFactory.create())
        .build();

4、使用配置好的Retrofit實例創建APIService實例：

ApiService apiService = retrofit.create(ApiService.class);

5、 創建Call對象並發送網絡請求：

Call call = apiService.getGankData(type, count, page);
call.enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) {
        //處理響應結果
    }

    @Override
    public void onFailure(Call call, Throwable t) {
        //處理請求失敗
    }
});

三、Retrofit2的註解

1、@GET：用於發送HTTP GET請求。

//url為http://www.example.com/api/data/Android/10/1
@GET("api/data/{type}/{count}/{page}")
Call getGankData(@Path("type") String type, @Path("count") int count, @Path("page") int page);

2、@POST：用於發送HTTP POST請求。

@POST("api/user/login")
Call login(@Body User user);

3、@PUT：用於發送HTTP PUT請求。

@PUT("api/user/{id}")
Call updateUser(@Path("id") int id, @Body User user);

4、@DELETE：用於發送HTTP DELETE請求。

@DELETE("api/user/{id}")
Call deleteUser(@Path("id") int id);

5、@Query：用於向URL中添加查詢參數。

@GET("api/user/list")
Call<List> getUserList(@Query("gender") String gender);

6、@Path：用於替換URL中的一部分，如上面的@Path(「type」)。

7、@Body：用於發送一個實體的請求體，比如可以發送一個用戶註冊信息。

8、@Header：用於向請求頭中添加一個參數，如下面的@Header(「Authorization」)。

@GET("api/user")
Call getUserInfo(@Header("Authorization") String token);

四、Retrofit2的其他用法

1、使用RxJava2構建響應式API，可以將Call對象轉換為Observable對象。

2、使用Interceptor可以添加請求攔截器和響應攔截器，可以實現請求重試、請求頭添加、緩存等功能。

3、使用Converter將響應數據轉換為指定的格式，如Gson、Jackson、Xml等。

4、支持多種HTTP客戶端配置，如OkHttp、Java的HttpURLConnection、Android內置HttpClient等。

5、支持異步和同步請求。

五、Retrofit2個人體會

1、Retrofit2很好地實現了將HTTP API轉換為JAVA接口的功能，使得網絡請求更加簡單直觀。

2、Retrofit2支持各種HTTP客戶端和轉換器，可以實現自定義的網絡請求和數據解析。

3、Retrofit2的註解靈活易用，可以支持各種類型的請求方法和參數傳遞方式。

4、Retrofit2的設計思想使得網絡請求可以更加簡潔優雅，減少了網絡請求的代碼量。