同步请求
public interface TaskService {
@GET("/tasks")
Call<List<Task>> getTasks();
}
在Retrofit 2中,每个请求被包装成一个 Call 对象,实际上同步和异步请求在执行请求方法后创建了一个Call类型的对象。在Retrofit2中,同步和异步请求的接口定义是一样的。同步方法被执行在主线程,这意味着UI线程将会被阻塞在请求执行的时间段内。
Warning: 同步请求可能是导致APP在4.0及以上版本崩溃的原因,你可能会得到一个
NetworkOnMainThreadException 的异常错误
TaskService taskService = ServiceGenerator.createService(TaskService.class);
Call<List<Task>> call = taskService.getTasks();
List<Task>> tasks = call.execute().body();
在Retrofit 2中调用这个call对象的 execute() 方法会产生同步请求,返回的对象通过 body()
方法获取反序列化出来的数据。
异步请求
public interface TaskService {
@GET("/tasks")
Call<List<Task>> getTasks();
}
Retrofit在一个另外的线程中执行这个方法,这个 Callback
是一个通用的类并且会匹配你定义的返回类型。我们的例子返回了一个tasks的list,在Callback内部自己做了映射。
前面已经提到在Retrofit 2中同步请求和异步请求定义的接口是一样的,目标返回类型被封装成一个 Call 对象,实际的请求类型在泛型中。
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请求返回数据
不需要额外定义一个 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) {}
}