詳解Retrofit中的GET請求

在進行Android開發中，我們經常需要與服務器進行通信。而HTTP請求是實現客戶端與服務器端通信的重要方式之一。在此，我們介紹Retrofit庫中的GET請求。Retrofit 庫是一個Square公司推出的基於Okhttp的RESTful 風格的HTTP網絡請求庫，非常方便易用。下面，我們從以下幾個方面來詳解Retrofit的GET請求：

一、概述

Retrofit庫提供了註解的方式來定義 HTTP 請求，只需要寫一個接口，Retrofit 就可以根據這個接口使用註解的方式生成對應的請求對象。GET請求是最常見和最基礎的HTTP請求方式，我們首先了解下Retrofit的GET請求是如何實現的。

二、使用方法

先看一個例子代碼：

public interface ApiService {

    @GET("login")
    Call<ResponseBody> login(@Query("username") String username, @Query("password") String password);
}

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("http://www.example.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .client(client)
    .build();

ApiService service = retrofit.create(ApiService.class);
Call<ResponseBody> call = service.login("username", "password");
call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
        //處理響應
    }

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

如上所示，我們首先定義一個接口 ApiService，使用@GET註解定義接口請求類型是GET請求，其中”login”是接口請求的路徑。使用@Query註解定義接口請求的參數，比如username和password。當我們需要請求該接口時，可以通過Retrofit實例的 create() 方法來創建 ApiService 的代理對象 service, 然後使用service就可以進行網絡請求。

三、支持各種數據類型的返回值

網絡請求不同接口返回的數據類型不同，但是Retrofit庫支持各種數據類型的返回值，比如：ResponseBody、Bean、List等等。調用接口時，只需將返回值類型傳入call()方法即可。例如：

@GET("user")
Call<UserBean> getUserInfo();

如上所示，我們定義接口getUserInfo() 請求地址是“user”, 且返回值的類型是UserBean。當我們調用該請求時，我們可以使用Call調用。同理，如果返回值是List、ResponseBody等也是類似的操作。

四、動態URL

在GET請求中，我們還能夠使用註解動態傳遞URL，例如下面的例子：

@GET（）
Call<ResponseBody> getDetailInfo(@Url String url);

如上代碼所示，當需要傳遞的URL是動態的，可以使用 @Url 來進行替換。例如，當需要請求 www.example.com/user/1001 接口時，只需要將 @Url 註解替換成 @Url(“user/1001”) 即可，注意user/1001是相對路徑。

五、在URL中傳參

除了上面的@Query對GET請求進行參數賦值外，還可以直接使用正則表達式通過@Path在URL中傳參，例如下面的代碼：

@GET("user/{id}")
Call<UserBean> getUserInfo(@Path("id") int id);

如上代碼所示，使用@Path來匹配URL中的參數（即{id}），實現根據不同參數生成不同請求的目的，其中 {id} 會被替換成指定的參數id值。當我們請求“user/1001”時，只需要傳入id=1001即可。

六、請求頭設置

在進行HTTP請求時，常常需要在HTTP請求頭中設置一些參數，可以使用@Header註解。例如下面的代碼：

@GET("user")
Call<UserBean> getUserInfo(@Header("Authorization") String authorization, @Query("id") int id);

如上所示，我們在請求頭中設置了一個Authorization參數，值為傳入的authorization參數值。同時，在請求參數中還使用了@Query註解設置了一個請求參數id。

七、總結

在本文中，我們講解了Retrofit庫中的GET請求的基本使用和相關操作，包括了接口定義、各種數據類型的返回值、動態URL、在URL中傳參、請求頭設置等。GET請求是最基礎的HTTP請求，我們在使用該功能時，應當結合實際情況進行實現。當然，除了GET請求外，Retrofit還支持其他的HTTP請求方式，有興趣的同學可以深入了解一下。