1、Retrofit的作用
A type-safe HTTP client for Android and Java
看到这句话时候在想什么是类型安全?
百度一下:类型安全代码指访问被授权可以访问的内存位置。例如,类型安全代码不能从其他对象的私有字段读取值。它只从定义完善的允许方式访问类型才能读取。类型安全的代码具备定义良好的数据类型。
所以看起来Retrofit定义类型安全的含义应该在于它的接口返回类型是用户定义好的,类型是安全的。
Retrofit将网络请求封装起来,用户不需要怎么进行网络请求,只需要定义返回数据类型,给出url,框架就可以保证当用户请求时,返回的数据是你想要的数据。
Retrofit依赖于OkHttp,可以对数据在返回时进行预处理等。
2、Retrofit的原理
3、Retrofit的实现
Retrofit使用Builder模式来进行创建,使用Call.Factory执行网络请求(默认实现OkHttpClient)。用户如果需要使用自己的网络请求,需要实现Call.Factory,并调用Builder中的
callFactory进入赋值。
用户主要需要实现或者定义4个接口:Callback,Converter,CallAdapter,Call;
Callback用于数据返回后的回调;
call.enqueue(new Callback<MovieSubject>() {
@Override
public void onResponse(Call<MovieSubject> call, Response<MovieSubject> response) {
// mMovieAdapter.setMovies(response.body().subjects);
// mMovieAdapter.notifyDataSetChanged();
//ok.
}
@Override
public void onFailure(Call<MovieSubject> call, Throwable t) {
t.printStackTrace();
}
});
Converter用于请求返回时的数据预处理;
CallAdapter用户自定义用户实现Call的过程,主要使用Adapter模式和工厂模式。在默认的ExecutorCallAdapterFactory中还使用了delegate模式进行call的实现,其中定义了Call执行的Executor。
Call是Retrofit定义的调用网络框架的地方,直接与Okhttp交互。
Retrofit中有一个重要的类ServiceMethod,这个类串联了CallAdapter和Method,在Retrofit中进行了缓存。
Retrofit默认使用MainLooper的Handler处理消息,用户可以自定义处理线程。
4、Retrofit的流程(看不清楚时建议下载或者图片另起网址打开)
5、Retrofit的使用
5.1 Retrofit turns your HTTP API into a Java interface.
public interface GitHubService {
@GET("users/{user}/repos")
Call<List<Repo>> listRepos(@Path("user") String user);
}
5.2 The Retrofit
class generates an implementation of the GitHubService
interface.
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.github.com/")
.build();
GitHubService service = retrofit.create(GitHubService.class);
5.3 Each Call
from the created GitHubService
can make a synchronous or asynchronous HTTP request to the remote webserver.
Call<List<Repo>> repos = service.listRepos("octocat");
5.4 sync and async
sync: repos.execute(new Callback(){...});
async: repos.enqueue(new Callback(){...});