更新到Retrofit2的一些技巧

作者 小武站台 关注

2016.02.22 22:13* 字数 1348 阅读 1621评论 0喜欢 5赞赏 1

原文链接:Tips on updating to Retrofit 2
ps:其实我老早就更新到Retrofit2了 但是不同的beta版目前改变还是挺大的,如果你在用的话 ,要时刻跟进并查看它的changelog.该文章还是比较倾向于1.9升级2.0 但是就像前面说的 beta2到beta4改变也是非常大的 所以同样可以参考用于备忘

Retrofit2.0已经公开发布几个月了,但是现在依然是beta版,一些开发者已经开始从之前的版本进行升级,虽然官方已经提供了文档,文章或博客让你了解最新版的相关信息,但是在StackOverflow还是可以看到一些提问关于在升级版本的过程中怎么处理常见功能像logging打印日志,添加request parameter或者使用JSON对象等,所以在这篇文章中,我会告诉你关于这些问题的一些技巧。

写文章时,Retrofit的版本是v2.0.0-beta4.

新的group id

第一个你会注意到的改变是新的group id,变成了com.squareup.retrofit2,所以新的依赖声明是:

compile 'com.squareup.retrofit2:retrofit:2.0.0-beta4'

新的包名

主包名已经改成了

package retrofit2;

这意味的你需要更改所有关于Retrofit的import,此外,如果你还有其他涉及到包名的代码或任务,记得也要更新他们。

proguard 配置

因为新包名,如果你开启了混淆代码,第一件要做的事就是更新配置文件的规则,它们可以在官方网站找到:

-dontwarn retrofit2.**
-keep class retrofit2.** { *; }
-keepattributes Signature
-keepattributes Exceptions

okhttp

okhttp现在Retrofit2内置的默认依赖,实际上,查看Retrofit2的pom文件(maven的依赖配置文件),会发现下面的依赖:

<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
</dependency>

如果你不需要用一个特殊版本的okhttp或者其他http client,你不用做任何事情。

生成服务接口实现

service interface implementation generation

你会立即注意到的另外一件事是你的生成服务接口实现的代码没法编译了。

下面是Retrofit的典型代码:

RestAdapter restAdapter = new RestAdapter.Builder()
.setEndpoint("https://api.github.com")
.build();
GitHubService service = restAdapter.create(GitHubService.class);

在Retrofit2,会变成:

Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.github.com")
.build();
GitHubService service = retrofit.create(GitHubService.class);

你可以看到,依然是build模式,但是涉及的方法和类已经变了。

logging

在开发中打印网络请求和返回结果是非常重要的,如果你在Retrofit中启用了这个功能,你会发现实现该功能的方法已经不可用了。

setLogLevel(RestAdapter.LogLevel.FULL)

那是因为你现在必须依靠okhttp提供的日志系统,HttpLoggingInterceptor.

首先声明一个新的依赖,因为它不是okhttp的一部分所以要另外添加依赖:

compile 'com.squareup.okhttp3:logging-interceptor:3.1.2'

然后,创建一个interceptor实例:

HttpLoggingInterceptor httpLoggingInterceptor = new HttpLoggingInterceptor();
httpLoggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);

再然后,添加到OkHttp client实例中:

OkHttpClient okHttpClient = new OkHttpClient.Builder().addInterceptor(httpLoggingInterceptor).build();

最后,把client设置到service interface实现中:

Retrofit retrofit = new Retrofit.Builder()
.client(okHttpClient)
.baseUrl(MovieDbApi.END_POINT)
.build();
movieDbApi = retrofit.create(MovieDbApi.class);

ps:其实这个log并不是很好用,最好自己参考源码自己自定义一个,分分钟就搞定了。

gson converter

By default, Retrofit can only deserialize HTTP bodies into OkHttp’s ResponseBody type and it can only accept its RequestBodytype for @Body.

这意味得用来支持其他types的converter必须在创建服务接口时进行设置

为了让JSON和Java对象相互转换,我们需要设置一个GSON转换器

首先,需要一个新的依赖:

compile 'com.squareup.retrofit2:converter-gson:2.0.0-beta4'

然后设置converter factory:

Retrofit retrofit = new Retrofit.Builder()
.client(okHttpClient)
.baseUrl(MovieDbApi.END_POINT)
.addConverterFactory(GsonConverterFactory.create())
.build();
movieDbApi = retrofit.create(MovieDbApi.class);

完整的可用converters可以查看官方文档

interceptor

Retrofit另外一个有用的功能是可以拦截http请求进行监控,重写或重试

一个典型应用场景是所有http请求需要加上api key,在Retrofit2之前,可以通过RequestInterceptor实现:

final RequestInterceptor authorizationInterceptor = new RequestInterceptor() {
@Override
public void intercept(RequestInterceptor.RequestFacade request) {
request.addQueryParam(MovieDbApi.PARAM_API_KEY, "YOUR_API_KEY");
}
};

然后

RestAdapter restAdapter = new RestAdapter.Builder()
.setEndpoint(MovieDbApi.END_POINT)
.setRequestInterceptor(authorizationInterceptor)
.build();
movieDbApi = restAdapter.create(MovieDbApi.class);

在Retrofit2中已经不再有效了,因为你现在必须依靠OKHttp interceptors.

你可以直接在OKHttp client实例化时进行设置:

OkHttpClient okHttpClient = new OkHttpClient.Builder().addInterceptor(new Interceptor() {
@Override
public Response intercept(Chain chain) throws IOException {
Request request = chain.request();
HttpUrl url = request.url().newBuilder().addQueryParameter(
MovieDbApi.PARAM_API_KEY, BuildConfig.MOVIE_DB_API_KEY).build();
request = request.newBuilder().url(url).build();
return chain.proceed(request);
}
}).build();

然后像前面那样设置client:

Retrofit retrofit = new Retrofit.Builder()
.client(okHttpClient)
.baseUrl(MovieDbApi.END_POINT)
.build();
movieDbApi = retrofit.create(MovieDbApi.class);

RxJava observable

如果你正在使用RxJava,你会注意到Retrofit2 interfaces已经不支持Observable了,实际上,Call模式被用于标准的http请求。

当然你可以用你自己的类型,提供你自己的CallAdapter实现,但是幸运的是已经有可用的了,RxJavaCallAdapterFactory.简单说,它把Call转换成Observable.

首先,添加依赖:

com.squareup.retrofit2:adapter-rxjava:2.0.0-beta4

然后,用addCallAdapterFactory进行设置:

Retrofit retrofit = new Retrofit.Builder()
.client(okHttpClient)
.baseUrl(MovieDbApi.END_POINT)
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.build();
movieDbApi = retrofit.create(MovieDbApi.class);

 

(转载)更新到Retrofit2的一些技巧的更多相关文章

  1. ( 译、持续更新 ) JavaScript 上分小技巧(四)

    后续如有内容,本篇将会照常更新并排满15个知识点,以下是其他几篇译文的地址: 第一篇地址:( 译.持续更新 ) JavaScript 上分小技巧(一) 第二篇地址:( 译.持续更新 ) JavaScr ...

  2. ( 译、持续更新 ) JavaScript 上分小技巧(三)

    最近家里杂事较多,自学时间实在少的可怜,所以都在空闲时间看看老外写的内容,学习之外顺便翻译分享~等学习的时间充足些再写写自己的一些学习内容和知识点分析(最近有在接触的:复习(C#,SQL).(学习)T ...

  3. ( 译、持续更新 ) JavaScript 上分小技巧(二)

    考虑到文章过长,不便于阅读,这里分出第二篇,如有后续,每15个知识点分为一篇... 第一篇地址:( 译.持续更新 ) JavaScript 上分小技巧(一) 第三篇地址:( 译.持续更新 ) Java ...

  4. ( 译、持续更新 ) JavaScript 上分小技巧(一)

    感谢好友破狼提供的这篇好文章,也感谢写这些知识点的作者们和将他们整理到一起的作者.这是github上的一篇文章,在这里本兽也就只做翻译,由于本兽英语水平和编程能力都不咋地,如有不好的地方也请多理解体谅 ...

  5. 在生产环境中安全执行更新删除SQL脚本的技巧

    今天在生产环境上解决问题,由于广发银行的管理制度是开发公司是不允许确生产环境的,所以我们只能把要更新的语句发给运营中心,由运营中心的投产人员执行,我们则在旁边看着:在他执行的时候发现了一个很有趣的技巧 ...

  6. 一些有意思的面试题(持续更新) .C语言编程技巧札记

    一些有意思的面试题(持续更新) http://blog.csdn.net/wangyuling1234567890/article/details/38565239 C语言编程技巧札记 http:// ...

  7. (转载) Android Studio你不知道的调试技巧

    Android Studio你不知道的调试技巧 标签: android studio 2015-12-29 16:05 2514人阅读 评论(0) 收藏 举报  分类: android(74)    ...

  8. (转载) TextView使用一些小技巧

    TextView使用一些小技巧 标签: textviewandroid开发 2015-10-09 16:13 810人阅读 评论(0) 收藏 举报  分类: Android(20)  本文主要讲一些T ...

  9. Datagrip 快捷键和常用插件持续更新一集一些使用技巧

    快捷键 Ctrl+Enter:执行选中的SQL语句 Ctrl+Shift+左右箭头:调整列宽度(选中行,可以调整所有列的宽度) Ctrl+N / 双击Shift :全局搜索,点击可直接进入表 Ctrl ...

随机推荐

  1. MATLAB图形界面设计(下)

    文章参考Blue Mountain https://www.cnblogs.com/BlueMountain-HaggenDazs/p/4307777.html 一.菜单设计 1.建立菜单项 (1)建 ...

  2. 切换原生appium里面H5页面

    #coding = utf-8from appium import webdriverimport time'''1.手机类型2.版本3.手机的唯一标识 deviceName4.app 包名appPa ...

  3. 【剑指Offer】19、顺时针打印矩阵

      题目描述:   输入一个矩阵,按照从外向里以顺时针的顺序依次打印出每一个数字,例如,如果输入如下4 X 4矩阵: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 则依 ...

  4. USACO 4.1 Fence Rails

    Fence RailsBurch, Kolstad, and Schrijvers Farmer John is trying to erect a fence around part of his ...

  5. mongodb分片集群开启安全认证

    原文地址:https://blog.csdn.net/uncle_david/article/details/78713551 对于搭建好的mongodb副本集加分片集群,为了安全,启动安全认证,使用 ...

  6. Dell R720修改远程管理口的密码

    今天有个客户需要通过远程管理口来查看系统事件日志,但是他们把初始密码改过并且还给忘记了.后来我决定进操作系统(cent os)进行修改.整个过程很简单,进入系统后只需要三个步骤就解决问题了 1.安装软 ...

  7. 渗透实战(周一):VMmare Fusion安装Kali Linux和win7虚拟机

    高配笔记本电脑i5/8G/265G .VMware Fusion .Kali Linux镜像 .Win7镜像  第一:下载软件 1.如果你是苹果系统,建议下载最新VMware Fusion 11.0. ...

  8. Git 基础教程 之 分支管理及策略

    创建一个属于自己的分支,别人看不到,你在你自己的分支上干活, 想提交就提交,直至开发完毕后,再一次性合并到原来分支上.这样,既安全,又不影响他人工作.          在实际的开发过程中,应照几个基 ...

  9. string.Format 格式化日期格式

    DateTime dt = DateTime.Now;//2010年10月4日 17点05分            string str = "";            //st ...

  10. UOJ #131 BZOJ 4199 luogu P2178【NOI2015】品酒大会 (后缀自动机、树形DP)

    水是水,但是写出了不少问题,因此写一发博客. https://www.luogu.org/problemnew/show/P2178 https://www.lydsy.com/JudgeOnline ...