Retrofit 1.x和Retrofit 2.x的不同

Android
————字数统计 2.9k 字 | 阅读时长 12 分钟————

序言

Retrofit库已经发布很久了，已经是主流的Http client库之一，使用简单、高效，但是随着版本的升级，也出现了一些疑难杂症，下面就详细给大家讲解一下，给大家填填坑：

官方描述：Type-safe HTTP client for Android and Java by Square.
官网地址：Square-Retrofit.
Github地址：Github-Retrofit.

到现在已经经历了1.x到2.x的过程，这自然是一个越来越完善、越强大的趋势，但是Square还是坑了我们一把。在1.x到2.x的迭代过程中，并不是平滑升级的，而是发生了很大的转变，为了防止更多的人遇到这些坑，我就把我了解的一些不同给大家说一所，当然，哪里描述有问题，表述不正确的随时回复。

Retrofit 1.x -> Retrofit 2.x

Retrifit 1系列最高是1.9.0，Retrofit 2 系列目前最高 2.1.0。

Maven & Gradle 依赖

  1. 在Retrofit 1中，你需要导入底层的HTTP客户端。默认情况下，Retrofit 2将OkHttp最为默认的底层库，它已经作为Retrofit 2本身的依赖。
compile 'com.squareup.retrofit2:retrofit:2.1.0'

假如你想要使用指定版本的OkHttp，那么你可以这样写：

compile ('com.squareup.retrofit2:retrofit:2.1.0') {  
  // 移除 Retrofit 的 OkHttp 
  exclude module: 'okhttp'
}

// 添加自定义的依赖库
compile 'com.squareup.okhttp3:okhttp:3.3.1'
  1. Maven: Retrofit & OkHttp
<dependency>  
  <groupId>com.squareup.retrofit2</groupId>
  <artifactId>retrofit</artifactId>
  <version>2.1.0</version>
</dependency>  
<dependency>  
  <groupId>com.squareup.okhttp</groupId>
  <artifactId>okhttp</artifactId>
  <version>3.3.1</version>
</dependency>
  1. Retrofit 2默认不集成Gson和RxJava的。之前，你不需要担心任何集成转换器，现在你需要导入转换器，当然RxJava也需要手动导入，下文还会详细描述：
  • Converter
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
  • RxJava
compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'  
compile 'io.reactivex:rxandroid:1.0.1'

RestAdapter —> Retrofit

  • Retrofit 1.9
RestAdapter.Builder builder = new RestAdapter.Builder();
  • Retrofit 2.x
Retrofit.Builder builder = new Retrofit.Builder();

setEndpoint —> baseUrl

  • Retrofit 1.9
RestAdapter adapter = new RestAdapter.Builder()  
    .setEndpoint(API_BASE_URL);
    .build();

YourService service = adapter.create(YourService.class);

注: 在你调用Retrofit.Builder的build()方法之前, 你至少需要定义API_BASE_URL.

  • Retrofit 2.x
Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl(API_BASE_URL);
    .build();

YourService service = retrofit.create(YourService.class);

Base Url处理

  • Retrofit 1.x
public interface UserService {  
    @POST("me")
    User me();
}

RestAdapter adapter = RestAdapter.Builder()  
    .setEndpoint("https://your.api.url/v2/");
    .build();

UserService service = adapter.create(UserService.class);

// the request url for service.me() is: 
// https://your.api.url/v2/me
  • Retrofit 2.x

Retrofit 2.x 使用了全新的url处理方式，内部是通过HttpUrl.resolve()**方式创建的URL，类似于**的链接，这一点非常重要。我学习的时候看到有三种展示方式：

  1. url：https://your.api.url/me

public interface UserService {  
    @POST("/me")
    Call<User> me();
}

Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl("https://your.api.url/v2");
    .build();

UserService service = retrofit.create(UserService.class);

// the request url for service.me() is: 
// https://your.api.url/me
  1. url：https://your.api.url/me

public interface UserService {  
    @POST("me")
    Call<User> me();
}

Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl("https://your.api.url/v2");
    .build();

UserService service = retrofit.create(UserService.class);

// the request url for service.me() is: 
// https://your.api.url/me
  1. url：https://your.api.url/v2/me

public interface UserService {  
    @POST("me")
    Call<User>me();
}

Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl("https://your.api.url/v2/");
    .build();

UserService service = retrofit.create(UserService.class);

// the request url for service.me() is: 
// https://your.api.url/v2/me

经过我的测试（Retrofit 2.1.0），baseUrl必须是以 / 结尾（即@GET不以**/**开头），不然会报错：java.lang.IllegalArgumentException: baseUrl must end in /: https://your.api.url/v2/me ，所以，在2.1.0的版本，我们要注意这一点，如果这里有问题，还请留言反馈。

  1. 动态URL

在你的url无法立即获取或者使用的时候，你可以配置动态的url来使用，在Retrofit 2.x你可以将HTTP请求注解留空，然后将**@url**作为方法参数的注解，请看以下示例代码：


public interface UserService {  
    @GET
    public Call<File> getZipFile(@Url String url);
}

OkHttp集成

OkHttp 在Retrofit 1.x里是可选的。如果你想让Retrofit使用OkHttp作为HTTP连接接口，你需要手动包含OkHttp依赖。
但是在Retrofit 2.x中，OkHttp 是必须的，并且自动设置为了依赖。下面的代码来自Retrofit 2.0的pom文件：

<dependency>  
  <groupId>com.squareup.okhttp</groupId>
  <artifactId>okhttp</artifactId>
  <version>3.3.1</version>
</dependency>

OkHttp 使用Call 来封装响应，如果你想使用OkHttp特定的版本，不想使用内部的版本，你可以按照以下代码手动配置：

compile ('com.squareup.retrofit2:retrofit:2.1.0') {  
  // exclude Retrofit’s OkHttp peer-dependency module and define your own module import
  exclude module: 'okhttp'
}
compile 'com.squareup.okhttp3:okhttp:3.3.1'

OkHttp拦截器

在Retrofit 1.x中，你可以使用RequestInterceptor来拦截一个请求，但是它已经从Retrofit 2.x 移除了，因为HTTP连接层已经转为OkHttp。
结果就是，现在我们必须转而实用OkHttp里面的Interceptor。首先你需要实用Interceptor创建一个OkHttpClient对象，然后使用如下Retrofit.Builder()的client()方法设置你自定义的增强版OkHttp：


OkHttpClient.Builder httpClient = new OkHttpClient.Builder();  
httpClient.addInterceptor(new Interceptor() {  
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request original = chain.request();

        // Customize the request 
        Request request = original.newBuilder()
                .header("Accept", "application/json")
                .header("Authorization", "auth-token")
                .method(original.method(), original.body())
                .build();

        Response response = chain.proceed(request);

        // Customize or return the response 
        return response;
    }
});

OkHttpClient client = httpClient.build();  
Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl("https://your.api.url/v2/");
    .client(client)
    .build();

同步&异步 请求

在Retrofit 1.x中，通过在service接口中不同的方法声明来区分，同步方法需要一个返回类型，异步的方法需要一个统一的Callback作为最后一个参数。

接口声明

  • Retrofit 1.x

public interface UserService {  
    // Synchronous Request
    @POST("/login")
    User login();

    // Asynchronous Request
    @POST("/login")
    void getUser(@Query String id, Callback<User> cb);
}
  • Retrofit 2.x

在Retrofit 2.x中，service中方法的声明没有区别，返回类型都被统一封装到一个Call类型里面：


public interface UserService {  
    @POST("/login")
    Call<User> login();
}

请求执行

  • Retrofit 1.x

// synchronous
User user = userService.login();

// asynchronous
userService.login(new Callback<User>() {  
@Override
    public void success(User user, Response response) {
        // handle response
    }

    @Override
    public void failure(RetrofitError error) {
        // handle error
    }
});
  • Retrofit 2.x

对于Retrofit 2.x，返回类型都被统一封装到了Call类型里，所以使用了完全不同的执行方式：


// 同步
Call<User> call = userService.login();  
User user = call.execute().body();


// 异步
Call<User> call = userService.login();  
call.enqueue(new Callback<User>() {  
    @Override
    public void onResponse(Call<User> call, Response<User> response) {
        // response.isSuccessful() is true if the response code is 2xx
        if (response.isSuccessful()) {
            User user = response.body();
        } else {
            int statusCode = response.code();

            // handle request errors yourself
            ResponseBody errorBody = response.errorBody();
        }
    }

    @Override
    public void onFailure(Call<User> call, Throwable t) {
        // handle execution failures like no internet connectivity 
    }
}

注：在Retrofit 2.x中，即使请求不成功onResponse()**方法也会被执行，但是Response类提供了isSuccessful()方法用于检查请求结果（返回的状态码2xx），如果状态代码不是2xx，您需要自己处理错误。如果在失败的情况下，你希望自己解析错误响应信息，你可以通过使用ResponseBody类的errorBody()**方法自己解析对象。

取消请求

使用Retrofit 1.x，即使请求尚未执行，也无法取消。在Retrofit 2.x这一点已经得到了改善，即如果HTTP调度器没有执行该它，你最终可以取消任何请求。


Call<User> call = userService.login();  
User user = call.execute().body();

// changed your mind, cancel the request
call.cancel();

你不需要关心是同步还是异步请求，只要你足够的及时，OkHttp不会发送出任何的请求。

转换器

Retrofit 1.x对Gson集成并作为默认的JSON转换器，但是Retrofit 2.x没有集成任何转换器，需要你自定义转换器，如果你想使用Gson作为转换器，你可以按照以下方式使用兄弟库：

添加依赖

compile 'com.squareup.retrofit2:converter-gson:2.1.0'

还有其它很多可用的转换器，根据自己的喜欢手动添加即可：

  • Gson: com.squareup.retrofit2:converter-gson:2.1.0
  • Moshi: com.squareup.retrofit2:converter-moshi:2.1.0
  • Jackson: com.squareup.retrofit2:converter-jackson:2.1.0
  • SimpleXML: com.squareup.retrofit2:converter-simplexml:2.1.0
  • ProtoBuf: com.squareup.retrofit2:converter-protobuf:2.1.0
  • Wire: com.squareup.retrofit2:converter-wire:2.1.0

假如，没有你想使用的依赖库，你可以继承Converter.Factory抽象类，可以去这里参考编写：转换器实现示例

添加转换器


Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl("https://your.api.url/v2/");
    .addConverterFactory(ProtoConverterFactory.create())
    .addConverterFactory(GsonConverterFactory.create())
    .build();

上面代码中添加了两个转换器，你是不是要会选择哪个使用？这一点很重要：添加的顺序决定了使用的顺序，默认使用第一个转换器，如果第一个转换器不可用，会使用第二个转化器。所以，你可以多添加几个转换器，这是允许的，但是一定要注意顺序。

RxJava集成

Retrofit 1 已经集成了三个请求执行机制：同步，异步和RxJava。Retrofit 2 仅仅同步和异步默认是可用的，因此，Retrofit开发团队创建了一种将额外的执行机制插入Retrofit的方法。你可以为你的应用程序添加多个机制，如RxJava或Futures。为了使Retrofit恢复RxJava的支持，需要添加两个依赖：

  • 第一个依赖是 RxJava的 CallAdapter，这是为了告诉Reftrofit有新的方式来处理请求。这就意味着你可以通过定义CustomizedCall 来替换Call ，在 RxJava 的情况下，我们需要将返回值Call 修改为 Observable。
  • 第二个依赖是需要AndroidSchedulers类，这是需要在Android的主线程上订阅代码。
compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'  
compile 'io.reactivex:rxandroid:1.0.1'

接下来需要的是在创建service实例之前将新的 CallAdapter 添加到 Retrofit 对象。


Retrofit retrofit = new Retrofit.Builder()  
    .baseUrl(baseUrl);
    .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
    .addConverterFactory(GsonConverterFactory.create())
    .build();

首先，我们声明一个service接口。之后，我们假设有一个userService实例被创建，并且可以直接利用Observable来观察Android的主线程。我们还将一个新的Subscriber传递给subscribe方法，它将最终返回成功的响应或错误。


public interface UserService {  
    @POST("/me")
    Observable<User> me();
}

// this code is part of your activity/fragment
Observable<User> observable = userService.me();  
observable  
        .observeOn(AndroidSchedulers.mainThread())
        .subscribeOn(Schedulers.io())
        .subscribe(new Subscriber<User>() {
    @Override
    public void onCompleted() {
        // handle completed
    }

    @Override
    public void onError(Throwable e) {
        // handle error
    }

    @Override
    public void onNext(User user) {
        // handle response
    }
});

默认没有日志记录

这个内容相对独立，就单独拿出来说吧，请查看另外两篇文章：

总结

这些内容摘自官方和日常使用总结，基本上覆盖了日常开发使用，所以你还需要在使用中不断的探索。Retrofit真的是非常的简单、高效，给你填了很多坑，节省了你的开发时间，虽然你需要花些时间去了解它，但是一旦你可以熟练的使用它，那么他带给你的惊喜是你无法想象的，所以，你又有什么理由不去使用它呢？

其实你可以通过官方的Changelog来详细了解以下：

Changelog

赏

×

大吉大利，晚上吃鸡

扫码支持
扫码打赏，你说多少就多少

打开支付宝扫一扫，即可进行扫码打赏哦

本文标题:Retrofit 1.x和Retrofit 2.x的不同

文章作者:

发布时间:2016年12月07日 - 11时11分

最后更新:2021年01月26日 - 11时15分

原始链接:https://goghtsui.github.io/2016/12/07/Retrofit-1-x%E5%92%8CRetrofit-2-x%E7%9A%84%E4%B8%8D%E5%90%8C/undefined/

许可协议: "署名-非商用-相同方式共享 3.0" 转载请保留原文链接及作者。

文章目录
  1. 1. 序言
  2. 2. Retrofit 1.x -> Retrofit 2.x
    1. 2.1. Maven & Gradle 依赖
    2. 2.2. RestAdapter —> Retrofit
    3. 2.3. setEndpoint —> baseUrl
    4. 2.4. Base Url处理
    5. 2.5. OkHttp集成
    6. 2.6. OkHttp拦截器
    7. 2.7. 同步&异步 请求
      1. 2.7.1. 接口声明
      2. 2.7.2. 请求执行
      3. 2.7.3. 取消请求
    8. 2.8. 转换器
      1. 2.8.1. 添加依赖
      2. 2.8.2. 添加转换器
    9. 2.9. RxJava集成
    10. 2.10. 默认没有日志记录
  3. 3. 总结
| | 总字数统计：93.5k