安卓Retrofit 2 介绍|设置 1

Retrofit 是一个基于 OkHttp 的网络请求框架，它能够将网络请求映射到 Java 方法上，使用起来非常方便，特别适合与 RESTful 服务端进行集成。在这篇文章中，我们将介绍如何设置 Retrofit 2。

设置依赖项

为了使用 Retrofit 2，首先需要将它的依赖项添加到你的项目中。你可以向 Android Studio 的 build.gradle 文件中添加如下代码行：

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

创建 Retrofit 实例

创建 Retrofit 实例时需要使用 Retrofit.Builder 类，该类提供了一些配置选项，如设置服务器 URL 和设置 OkHttp 客户端。代码示例如下：

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

其中，baseUrl() 函数用于设置服务器的 URL，client() 函数用于设置 OkHttp 客户端，addConverterFactory() 函数用于设置转换工厂，该转换工厂用于将服务器响应转换成预定义的数据类型。

创建接口

在创建接口时，可以使用 Retrofit 注解来标记接口的函数，这些函数将用于发出网络请求。例如，我们可以创建一个 UserService 接口，其中包含一个用于获取用户信息的函数：

public interface UserService {
    @GET("user/{id}") 
    Call<User> getUser(@Path("id") int userId); 
}

上述函数使用 @GET 注解标记，用于发出一个 GET 请求。该函数还包含一个 @Path 注解，用于将 id 参数映射到对应的 URL 路径。在该函数中，我们将其返回类型设为 Call，其中 User 是一个 POJO 类，用于描述服务器响应。

发送网络请求

当创建了一个 Retrofit 实例和接口后，就可以通过该实例发送网络请求了。在实际使用中，我们通常会在 Activity 或 Fragment 中调用 Retrofit 的函数来发送网络请求。下面是一个示例代码：

private void getUserInfo() {
    UserService userService = retrofit.create(UserService.class);
    Call<User> call = userService.getUser(1);
    call.enqueue(new Callback<User>() {
        @Override
        public void onResponse(Call<User> call, Response<User> response) {
            User user = response.body();
            // 处理用户信息
        }

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

在上述代码中，我们首先使用 retrofit.create() 函数创建了 UserService 的实例，然后使用 getUser() 函数创建了一个 Call 对象，该对象用于异步地返回服务器响应。最后我们使用了 enqueue() 函数发送 Call 请求，并在 onResponse() 函数中处理响应。

总结

在这篇文章中，我们介绍了如何设置 Retrofit 2，包括添加依赖项、创建 Retrofit 实例、创建接口和发送网络请求。使用 Retrofit 2 可以帮助我们轻松地与 RESTful 服务端进行交互，代码量也变得非常简洁。