原文链接:https://futurestud.io/blog/retrofit-synchronous-and-asynchronous-requests
在此前发布的文章中,我们带您经历如何设置 Retrofit 来集成对任何Web服务或API的认证。这篇文章将向您展示如何通过两种方式执行实际请求:同步或异步。
Retrofit 系列目录
- 开始创建android客户端[已翻译]
- Android上的基本认证[已翻译]
- Android上的令牌认证[已翻译]
- Android上的OAuth
- 多个 Query 参数使用同一名字[已翻译]
- 同步与异步请求
- 在请求体里发送对象[已翻译]
- 自定义一个响应转换器[已翻译]
- 添加自定义请求头
- 可选的 Query 参数
- 如何集成 XML 转换器
- 使用 Log Level 调试请求
- 如何上传文件
- Series Round-Up
- Retrofit 2 — 1.9 升级指南
- Retrofit 2 — 如何上传文件
- Retrofit 2 — Log 请求与响应
- Retrofit 2 — Android 上的 Hawk 认证
- Retrofit 2 — 简单错误处理
- 如何在 Retrofit 1 里使用 OkHttp 3
- Retrofit 2 — 图书更新发布庆典
- 提交表单数据 — Urlencoded
- 提交表单数据 — Urlencoded 使用FieldMap
- Retrofit 2 — 在 OkHttp 拦截器里管理请求头部
- Retrofit 2 — 如何给每一个请求添加 Query 参数
- Retrofit 2 — 使用QueryMap 添加多个 Query 参数
- Retrofit 2 — 如何在请求时使用动态 Url
- Retrofit 2 — Url 处理,分辨和解析
- Retrofit 2 — POST 和PUT 请求里的常量, 默认值和逻辑值
- Retrofit 2 — 如何下载文件
- Retrofit 2 — 取消请求
- Retrofit 2 — 重用分析请求
- Retrofit 2 — 如何在运行时修改 API Base Url
- 可选Path参数
- 如何刷新 Access Token
- Retrofit 2 — 如何提交文本请求体
- Retrofit 2 — 使用 Query 参数来分页
- Retrofit 2 — 使用 链接头和动态 Url 来分页(比如GitHub)
- Retrofit 2 — 使用范围头字段来分页 (比如 Heroku)
- Retrofit 2 — 转换器介绍
- Retrofit 2 — 添加并自定义 Gson 转换器
- Retrofit 2 — 实现自定义转换器
- Retrofit 2 — 只在开发环境里启用日志
- Retrofit 2 — 如何上传多个文件
- Retrofit 2 — Passing Multiple Parts Along a File with @PartMap
- Retrofit 2 — 模仿服务端响应基本概念
- Retrofit 2 — 模仿服务端响应自定义网络行为
- Retrofit 2 — 使用 @HeaderMap 定义动态请求头
Retrofit 支持同步和异步请求. 用户通过设置返回类型(同步或异步)定义具体的执行。
同步请求
Retrofit 1.9 的同步请求通过定义一个返回类型声明. 下面的例子中当执行getTasks
方法时, 我们期望一个Task
列表作为响应.
Retrofit 1.9
public interface TaskService {
@GET("/tasks")
List<Task> getTasks();
}
Retrofit 2
public interface TaskService {
@GET("/tasks")
Call<List<Task>> getTasks();
}
在 Retrofit 2,每个请求被包裹成一个Call
对象. 实际的同步或异步请求使用在随后创建的call
对象上的方法来执行不同的流程 . 无论如何,在 Retrofit 2 中对于同步和异步请求的接口定义是相同的.
同步方法是在主线程上执行. 这意味着, 在请求执行过程中UI被阻塞, 没有任何交互可能.
警告: 同步请求在 Android 4.0 及以上版本中可能导致程序崩溃. 你将得到一个
NetworkOnMainThreadException
错误.
同步方法提供了直接使用返回值的能力,因为你的网络请求阻塞一切.
对于非阻塞UI,你必须自己在一个独立的线程中执行请求. 这意味着,在等待响应过程中你仍然可以与应用程序交互.
得到同步请求的结果
让我们将目标转向实际请求. 此处 Retrofit 版本1 到 版本2 有变化. 下列代码片段展示了 Retrofit 的同步请求执行, 此处假设你已经熟悉了先前文章介绍的ServiceGenerator
类.
Retrofit 1.9
TaskService taskService = ServiceGenerator.createService(TaskService.class);
List<Task> tasks = taskService.getTasks();
Retrofit 2
TaskService taskService = ServiceGenerator.createService(TaskService.class);
Call<List<Task>> call = taskService.getTasks();
List<Task>> tasks = call.execute().body();
在 Retrofit 2 中, 使用call
对象的.execute()
方法将会执行同步请求. 反序列化的响应体通过响应对象的.body()
方法获得.
异步请求
除了同步调用, Retrofit 支持开箱即用的异步请求. 在 Retrofit1.9 中异步请求没有返回类型. 相反,定义的方法需要一个类型的回调作为最后方法的参数.
Retrofit 1.9
public interface TaskService {
@GET("/tasks")
void getTasks(Callback<List<Task>> cb);
}
Retrofit 2
public interface TaskService {
@GET("/tasks")
Call<List<Task>> getTasks();
}
Retrofit 在单独的线程中执行并处理方法体. Callback
类是通用的,它映射你定义的返回类型. 在我们的例子中返回的是Task
列表, Callback
做内部的映射.
如上面已经提到的: Retrofit 2 的接口定义对于同于和异步请求都是相同的. 所需的返回类型被封装到Call
对象, 实际的请求执行决定它的类型 (同步/异步).
得到异步请求的结果
使用异步请求迫使你实现一个Callback
与它的两个回调方法: success
和failure
. 当从服务类调用异步的getTasks()
方法时,你必须实现一个新的Callback
和定义一旦请求完成应做什么. 下列代码片段展示了示范性的实现.
Retrofit 1.9
TaskService taskService = ServiceGenerator.createService(TaskService.class);
taskService.getTasks(new Callback<List<Task>>() {
@Override
public void success(List<Task> tasks, Response response) {
// here you do stuff with returned tasks
}
@Override
public void failure(RetrofitError error) {
// you should handle errors, too
}
});
Retrofit 2
TaskService taskService = ServiceGenerator.createService(TaskService.class);
Call<List<Task>> call = taskService.getTasks();
call.enqueue(new Callback<List<Task>>() {
@Override
public void onResponse(Call<List<Task>> call, Response<List<Task>> response) {
if (response.isSuccessful()) {
// tasks available
} else {
// error response, no access to resource?
}
}
@Override
public void onFailure(Call<List<Task>> call, Throwable t) {
// something went completely south (like no internet connection)
Log.d("Error", t.getMessage());
}
}
获得原生 HTTP 响应
如果你需要原始的HTTP响应对象,只是将其定义为方法的返回类型. Response
类像任何其他类一样同时适用于两种方法.
Retrofit 1.9
// synchronous
@GET("/tasks")
Response getTasks();
// asynchronous
@GET("/tasks")
void getTasks(Callback<Response> cb);
Retrofit 2
在 Retrofit 2 中,你并不需要定义Response
类作为返回类型,而是你可以在onResponse()
回调方法内得到它. 让我们看一下下列的代码片段如何得到原生响应:
call.enqueue(new Callback<List<Task>>() {
@Override
public void onResponse(Call<List<Task>> call, Response<List<Task>> response) {
// get raw response
Response raw = response.raw();
}
@Override
public void onFailure(Call<List<Task>> call, Throwable t) {}
}
祝您编码愉快! 如果你遇到任何问题或者需要帮助, 请 Twitter @futurestud_io.
附加资源
Retrofit API 声明 的 synchronous vs. asynchronous vs. observable章节