Retrofit2使用方式和源码解析

关注

原创最新推荐文章于 2026-06-07 16:52:48 发布 1.3w 阅读 AI 写同款· GEO 优化 ›

Android 网络框架之Retrofit源码解析，满满干货指导算法知识点繁多，企业考察的题目千变万化，面对越来越近的“金九银十”，我给大家准备好了一套比较完善的学习方法，希望能帮助大家在有限的时间里尽可能系统快速的恶补算法，通过高效的学习来提高大家面试中算法模块的通过率。这一套学习资料既有文字档也有视频，里面不仅仅有关键知识点的整理，还有案例的算法相关部分的讲解，可以帮助大家更好更全面的进行学习，二者搭配起来学习效果会更好。部分资料展示：有了这套学习资料，坚持刷题一周，你就会发现自己的算法知识体系有明显的完善，离大厂Offer的距离更加近。【GitHub】阅读详情

简单介绍

Retrofit是一套RESTful架构的Android(Java)客户端实现，基于注解，提供JSON to POJO(Plain Ordinary Java Object,简单Java对象)，POJO to JSON，网络请求(POST，GET,PUT，DELETE等)封装。

软件首页http://square.github.io/retrofit/

github地址https://github.com/square/retrofit

具体使用

官方文档非常清晰，Retrofit2对Retrofit做了很大改进，针对改进做一下分析和使用说明

底层okhttp不同

Retrofit 默认使用okhttp
Retrofit2 默认使用okhttp3

Service接口定义方式不同

在Retrofit2之前如果定义一个同步的函数，应该这样定义：

public interface GitHubService {
  
    @POST("/list")
    Repo loadRepo();
  
}

异步函数定义

public interface GitHubService {
  
    @POST("/list")
    void loadRepo(Callback<Repo> cb);
  
}

Retrofit2 同步异步方法定义一个接口就可以了

mport retrofit.Call;
public interface GitHubService {
  
    @POST("/list")
    Call<Repo> loadRepo();
  
}

如果要调用同步请求，只需调用execute；而发起一个异步请求则是调用enqueue。

Retrofit2 可以取消请求方法

Retrofit2请求使用Call，Call有cancel方法可以取消请求
只需调用call.cancel()就可以取消请求。

Converter现在从Retrofit2中删除，需要根据自己的需要引入Converter

这里是Square提供的官方Converter modules列表。选择一个最满足你需求的。

Gson: com.squareup.retrofit:converter-gson
Jackson: com.squareup.retrofit:converter-jackson
Moshi: com.squareup.retrofit:converter-moshi
Protobuf: com.squareup.retrofit:converter-protobuf
Wire: com.squareup.retrofit:converter-wire
Simple XML: com.squareup.retrofit:converter-simplexml

Retrofit2 新的URL定义方式

Retrofit接口请求URL要求用/开头，必须设置baseUrl,接口请求URL不能是完整路径。可以使用Endpoint切换服务器路径
于 Retrofit2中新的URL定义方式,建议
- Base URL: 总是以 /结尾
- @Url: 不要以 / 开头
Retrofit2中没有Endpoint这个类，@Url中可以包含完整的路径，包含完整路径baseUrl会被忽略

public interface APIService {
    @POST("http://api.test.com/test)
    Call<Users> loadUsers();
}

Retrofit2 需要OkHttp的支持

OkHttp在Retrofit里是可选的。如果你想让Retrofit 使用OkHttp 作为HTTP 连接接口，需要手动包含okhttp 依赖。
但是在Retrofit2中，OkHttp 是必须的，并且自动设置为了依赖。
Retrofit2缺少INTERNET权限会导致SecurityException异常
在Retrofit 中，如果忘记在AndroidManifest.xml文件中添加INTERNET权限。异步请求会直接进入failure回调方法，得到PERMISSION DENIED 错误消息。没有任何异常被抛出。但是在Retrofit2中，当调用call.enqueue或者call.execute，将立即抛出SecurityException，如果不使用try-catch会导致崩溃。

即使response存在问题onResponse依然被调用

在Retrofit中，如果获取的 response 不能背解析成定义好的对象，则会调用failure。但是在Retrofit2中，不管 response 是否能被解析。onResponse总是会被调用。但是在结果不能被解析的情况下，response.body()会返回null。只有抛出异常才会调用onFailure

拦截器不同

在Retrofit中，可以使用RequestInterceptor来拦截一个请求，但是它已经从Retrofit2 移除了，因为HTTP连接层已经完全转为OkHttp。
Retrofit2使用okhttp的拦截器

源码分析

Retrofit的创建

Retrofit是个final类，不能再定义子类，Retrofit没有public构造方法，只能使用构建的者方式Retrofit.Builder构建。

etrofit.Builder可以指定url根地址、采用的网络客户端、回调线程池、请求拦截器、返回数据格式器和错误处理。

通常必须调用baseUrl，addConverterFactory这两个方法。

构建器默认使用OkHttpClient作为网络请求工具，addCallAdapterFactory用来构建请求实例，callbackExecutor指定回调方法线程池，根据不同平台构建不同，Android构建的是defaultCallbackExecutor,默认在主线程中。validateEagerly默认为false，表示执行的时候再去解析注解。如果设置为true，那么create实例之后，就会先解析接口所有方法。

if (baseUrl == null) {
       throw new IllegalStateException("Base URL required.");
     }<pre name="code" class="java"> public <T> T create(final Class<T> service) {
    Utils.validateServiceInterface(service);
    if (validateEagerly) {
      eagerlyValidateMethods(service);
    }
    return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
......

请求实例的创建

调用Retrofit的create方法，创建了执行请求对象的代理，代理方法的执行中，对于Object方法和默认方法，直接执行，其它方法解析后执行。使用代理加注解，是Retrofit的核心思想。

  return (T) Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
        new InvocationHandler() {
          private final Platform platform = Platform.get();

          @Override public Object invoke(Object proxy, Method method, Object... args)
              throws Throwable {
            // If the method is a method from Object then defer to normal invocation.
            if (method.getDeclaringClass() == Object.class) {
              return method.invoke(this, args);
            }
            if (platform.isDefaultMethod(method)) {
              return platform.invokeDefaultMethod(method, service, proxy, args);
            }
            ServiceMethod serviceMethod = loadServiceMethod(method);
            OkHttpCall okHttpCall = new OkHttpCall<>(serviceMethod, args);
            return serviceMethod.callAdapter.adapt(okHttpCall);
          }
        });

接口的解析过程

loadServiceMethod中首先从缓存中找解析的方法，找到直接返回，否则解析方法，然后放入缓存中。解析过的接口保存在了serviceMethodCache中，防止重复解析，提高效率。解析方法使用ServiceMethod.Builder构建解析器。

build过程中，首先创建callAdapter，

解析中有一系列规则，发现异常会抛出异常

方法返回的参数不能是泛型，不能是基本数据类型，不能是void。

注解不能为空

创建完callAdapter继续构建其他ServiceMethod属性，需要注意其他抛出异常的情况

返回类型不能是一个Response

httpMethod注解不能为空

如果请求中没有body，不能使用Multipart和FormEncoded
参数类型不能是基本类型和泛型
参数不能没有注解
URL不能为空
Form-encoded方法至少包含一个@Field注解
Multipart方法至少包含一个@Part注解
满足以上要求，才能正确构建ServiceMethod。

  ServiceMethod loadServiceMethod(Method method) {
    ServiceMethod result;
    synchronized (serviceMethodCache) {
      result = serviceMethodCache.get(method);
      if (result == null) {
        result = new ServiceMethod.Builder(this, method).build();
        serviceMethodCache.put(method, result);
      }
    }
    return result;
  }

  public ServiceMethod build() {
      callAdapter = createCallAdapter();
      responseType = callAdapter.responseType();
      if (responseType == Response.class || responseType == okhttp3.Response.class) {
        throw methodError("'"
            + Utils.getRawType(responseType).getName()
            + "' is not a valid response body type. Did you mean ResponseBody?");
      }
      responseConverter = createResponseConverter();
......

网络请求处理

方法解析完成之后，调用CallAdapter的adapt方法返回Call

内部构建如下

public CallAdapter<Call<?>> get(Type returnType, Annotation[] annotations, Retrofit retrofit) {
    if (getRawType(returnType) != Call.class) {
      return null;
    }
    final Type responseType = Utils.getCallResponseType(returnType);
    return new CallAdapter<Call<?>>() {
      @Override public Type responseType() {
        return responseType;
      }

      @Override public <R> Call<R> adapt(Call<R> call) {
        return new ExecutorCallbackCall<>(callbackExecutor, call);
      }
    };
  }

此时并没有发起请求，只是构建除了call,具体来说构建的是ExecutorCallbackCall，真正用来执行请求的是call内部的代理delegate，这个代理的真实身份是OkHttpCall，Retrofit2相当于将请求全权交给OKhttp处理，异步请求enqueue方法，同步请求execute方法都是执行的Okhttpclient对应的方法，

一下是okhttp请求的真实创建方法

  private okhttp3.Call createRawCall() throws IOException {
    Request request = serviceMethod.toRequest(args);
    okhttp3.Call call = serviceMethod.callFactory.newCall(request);
    if (call == null) {
      throw new NullPointerException("Call.Factory returned null.");
    }
    return call;
  }

异步执行完之后，利用callbackExecutor将回调抛回主线程。

Retrofit2比Retrofit简化了很多，但是功能却更加强大了。真的非常奇妙。作为网络请求框架，整个代码中居然没有用线程池，因为Okhttp本身对异步处理已经做的很好了。充分发挥了其它模块的功能，简化了自身逻辑。

欢迎扫描二维码，关注公众号