使用Retrofit进行网络请求

# 1. 简介

- 什么是Retrofit
- Retrofit的特点和优势

# 2. 准备工作

- 添加Retrofit依赖
- 创建Retrofit实例
- 配置Retrofit

# 3. 发起简单的GET请求

在这一章节中，我们将学习如何通过Retrofit库发起简单的GET请求来获取服务器返回的数据。

#### 创建API接口

首先，我们需要创建一个接口来定义我们的API请求。在接口中使用注解来指定请求的方法、URL等信息。

public interface ApiService {
    @GET("example-endpoint")
    Call<DataModel> getData();
}

#### 发起GET请求

接下来，我们可以使用Retrofit实例来创建一个实现了API接口的服务类，然后发起GET请求。

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://api.example.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build();

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

Call<DataModel> call = apiService.getData();
call.enqueue(new Callback<DataModel>() {
    @Override
    public void onResponse(Call<DataModel> call, Response<DataModel> response) {
        if (response.isSuccessful()) {
            DataModel data = response.body();
            // 处理响应数据
        } else {
            // 请求失败处理
        }
    }

    @Override
    public void onFailure(Call<DataModel> call, Throwable t) {
        // 网络请求失败处理
    }
});

#### 解析服务器响应数据

在请求成功后，我们可以通过`response.body()`来获取服务器返回的数据，并进行相应的处理。在`onFailure`方法中处理网络请求失败的情况。

通过以上步骤，我们就可以发起一个简单的GET请求并处理服务器响应数据了。

# 4. 发起带参数的请求

在某些情况下，我们需要向服务器发送带参数的请求，比如搜索功能或者筛选功能。下面将演示如何在使用Retrofit时发送带参数的请求。

### 在接口定义中添加参数

首先，我们需要在Retrofit的API接口中定义需要传递的参数。假设我们需要发送一个带有查询关键字的GET请求，接口定义可能如下所示：

public interface ApiService {

    @GET("search")
    Call<ResponseBody> searchItems(@Query("keyword") String keyword);

}

在上面的代码中，我们使用`@Query`注解来指定查询参数的键值对，这样在发起请求时可以传递关键字参数。

### 传递参数并发起请求

接下来，我们将展示如何传递参数并发起带参数的请求：

// 创建Retrofit实例
Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build();

// 创建API服务
ApiService apiService = retrofit.create(ApiService.class);

// 发起带参数的GET请求
Call<ResponseBody> call = apiServi