Android进阶：七、Retrofit2-0原理解析之最简流程【上】

最新推荐文章于 2024-09-30 15:37:45 发布

2401_84132496

最新推荐文章于 2024-09-30 15:37:45 发布

阅读量659

点赞数 18

分类专栏：程序员文章标签： android

本文链接：https://blog.csdn.net/2401_84132496/article/details/137530501

版权

程序员专栏收录该内容

440 篇文章 0 订阅

订阅专栏

本文介绍了Retrofit的基础用法，包括如何定义API接口、初始化Retrofit实例、生成接口实现类以及发起网络请求。重点展示了Retrofit如何基于OkHttp简化网络请求过程，特别关注了初始化过程中的参数设置和单例模式的应用。

摘要由CSDN通过智能技术生成

###一.retrofit入门

定义网络请求的API接口：

interface GithubApiService {
@GET(“users/{name}/repos”)
Call searchRepoInfo(@Path(“name”) String name);
}

使用了注解表明请求方式，和参数类型，这是retrofit的特性，也正是简化了我们的网络请求过程的地方！

初始化一个retrofit的实例：

Retrofit retrofit = new Retrofit.Builder()
.baseUrl(“https://api.github.com/”)
.build();

retrofit的实例化很简单，采用链式调用的设计，把需要的参数传进去即可，复杂的参数我们这里就不举例了。

生成接口实现类：

GithubApiService githubService = retrofit.create(service)
Call call = githubService.searchRepoInfo(“changmu175”);

我们调用retrofit的create方法就可以把我们定义的接口转化成实现类，我们可以直接调用我们定义的方法进行网络请求，但是我们只定义了一个接口方法，也没有方法体，请求方式和参数类型都是注解，create是如何帮我们整理参数，实现方法体的呢？一会我们通过源码解析再去了解。

发起网络请求

//同步请求方式
call.request();
//异步请求方式
call.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response response) {
//请求成功回调
}

@Override
public void onFailure(Call call, Throwable t) {
//请求与失败回调
}
});

至此，retrofit的一次网络请求示例已经结束，基于对okhttp的封装，让网络请求已经简化了很多。当然retrofit最适合的还是REST API类型的接口，方便简洁。

下面我们就看看retrofit的核心工作是如何完成的！

###二.retrofit初始化
retrofit的初始化采用了链式调用的设计

Retrofit retrofit = new Retrofit.Builder()
.baseUrl(“https://api.github.com/”)
.build();

很明显这个方法是在传一些需要的参数，我们简单的跟踪一下：

首先看看Builder()的源码：

public Builder() {
this(Platform.get());
}

这句代码很简单就是调用了自己的另一个构造函数：

Builder(Platform platform) {
this.platform = platform;
}

这个构造函数也很简单，就是一个赋值，我们把之前的Platform.get()点开，看看里面做在什么：

private static final Platform PLATFORM = findPlatform();

static Platform get() {
return PLATFORM;
}

我们发现这里使用使用了一个饿汉式单例，使用Platform.get()返回一个实例，这样写的好处是简单，线程安全，效率高，不会生成多个实例！

我们再看看findPlatform() 里做了什么：

private static Platform findPlatform() {
try {
Class.forName(“android.os.Build”);
if (Build.VERSION.SDK_INT != 0) {
return new Android();
}
} catch (ClassNotFoundException ignored) {
}

…省略部分代码…
}

所以是判断了一下系统，然后根据系统实例化一个对象。这里面应该做了一些和Android平台相关的事情，属于细节，我们追究，感兴趣的可以只看看。
再看看baseUrl(url)的源码

public Builder baseUrl(String baseUrl) {
checkNotNull(baseUrl, “baseUrl == null”);
HttpUrl httpUrl = HttpUrl.parse(baseUrl);
…
return baseUrl(httpUrl);
}

public Builder baseUrl(HttpUrl baseUrl) {
checkNotNull(baseUrl, “baseUrl == null”);
…
this.baseUrl = baseUrl;
return this;
}

这两段代码也很简单，校验URL，生成httpUrl对象，然后赋值给baseUrl

看看build() 方法在做什么
参数基本设置完了，最后就要看看build() 这个方法在做什么：

public Retrofit build() {
if (baseUrl == null) {
throw new IllegalStateException(“Base URL required.”);
}

okhttp3.Call.Factory callFactory = this.callFactory;
if (callFactory == null) {
callFactory = new OkHttpClient();
}
…

return new Retrofit(callFactory, baseUrl, unmodifiableList(converterFactories),
unmodifiableList(callAdapterFactories), callbackExecutor, validateEagerly);
}
}
}

代码中有大量的参数校验，有些复杂的参数我们没有传，所以我就把那些代码删除了。简单看一下也能知道，这段代码就是做一些参数校验，baseUrl不能为空否则会抛异常，至于其他的参数如果为null则会创建默认的对象。其中callFactory就是okhttp的工厂实例，用于网络请求的。
最后我们看到，这个方法最终返回的是一个Retrofit的对象，初始化完成。
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。