Retrofit 是一个用于 Android 和 Java 的类型安全的 HTTP 客户端库。它简化了与 RESTful API 进行通信的过程,提供了一种优雅的方式来定义 API 接口、发送网络请求并处理响应
添加依赖项:首先,您需要在项目中添加 Retrofit 的依赖项。您可以在项目的 build.gradle
文件中添加以下代码:
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0' // 如果需要使用 Gson 来解析 JSON 数据
创建 API 接口:定义您的 API 接口,其中包含您要访问的端点和请求方法。您可以使用 Retrofit 的注解来定义请求方法、请求参数、请求头等
public interface MyApiService {
@GET("posts")
Call<List<Post>> getPosts();
@POST("posts")
Call<Post> createPost(@Body Post post);
// 定义其他请求方法...
}
创建 Retrofit 实例:在应用程序的某个地方创建 Retrofit 实例,并配置它以便与您的 API 通信。通常在应用程序的启动过程中进行初始化。
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.example.com/") // 指定基本 URL
.addConverterFactory(GsonConverterFactory.create()) // 添加 Gson 转换器,用于将 JSON 转换为 Java 对象
.build();
创建 API 服务:使用 Retrofit 创建 API 服务的实例,这个实例会实际执行网络请求。
MyApiService service = retrofit.create(MyApiService.class);
发送网络请求:通过调用 API 服务的方法来发送网络请求,并处理响应。
Call<List<Post>> call = service.getPosts();
call.enqueue(new Callback<List<Post>>() {
@Override
public void onResponse(Call<List<Post>> call, Response<List<Post>> response) {
if (response.isSuccessful()) {
List<Post> posts = response.body();
// 处理成功的响应
} else {
// 处理错误响应
}
}
@Override
public void onFailure(Call<List<Post>> call, Throwable t) {
// 处理网络请求失败
}
});