Retrofit 博客

Retrofit 是一个基于注解的、简化网络请求的库，它将网络请求和数据解析封装在一起，使得我们只需要关注业务逻辑即可。

下面我来介绍一下如何使用 Retrofit。

1. 添加依赖

首先，需要在项目的 build.gradle 文件中添加 Retrofit 的依赖：

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

如果需要使用 Retrofit 的 Gson 转换器，还需要添加以下依赖：

implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

2. 创建 Retrofit 实例

在使用 Retrofit 之前，需要先创建一个 Retrofit 实例。通常情况下，我们会在 Application 的 onCreate() 方法中创建 Retrofit 实例。

public class MyApplication extends Application {

    private static Retrofit retrofit;

    @Override
    public void onCreate() {
        super.onCreate();

        // 创建 Retrofit 实例
        retrofit = new Retrofit.Builder()
                .baseUrl("https://api.github.com/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();
    }

    public static Retrofit getRetrofit() {
        return retrofit;
    }
}

在上面的代码中，我们通过 Retrofit.Builder() 方法创建了一个 Retrofit 实例，并通过 baseUrl() 方法设置了服务器的地址。addConverterFactory() 方法用于设置数据解析器，这里我们使用 GsonConverterFactory。最后调用 build() 方法创建 Retrofit 实例。

3. 创建网络请求接口

接下来，我们需要创建一个网络请求接口，用于定义具体的网络请求方法。

public interface ApiService {

    @GET("users/{username}")
    Call<User> getUser(@Path("username") String username);
}

在上面的代码中，我们通过 @GET 注解定义了一个 GET 请求方法，并在方法中使用了 @Path 注解来指定动态路径参数。方法的返回值是一个 Call 对象，它表示网络请求的响应结果。

4. 发起网络请求

最后，我们可以在业务逻辑中使用 Retrofit 实例和网络请求接口来发起网络请求。

ApiService apiService = MyApplication.getRetrofit().create(ApiService.class);
Call<User> call = apiService.getUser("octocat");
call.enqueue(new Callback<User>() {
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        if (response.isSuccessful()) {
            User user = response.body();
            // 处理响应结果
        } else {
            // 处理请求失败的情况
        }
    }

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

在上面的代码中，我们通过 MyApplication.getRetrofit() 方法获取 Retrofit 实例，并使用 create() 方法创建 ApiService 的实例。然后调用 getUser() 方法发起网络请求，并在请求回调中处理响应结果。

以上就是 Retrofit 的基本使用方法。通过 Retrofit，我们可以轻松地进行网络请求，同时也可以自定义网络请求的拦截器等功能。