0°

优雅的构建Android项目之RxAndroid+Retrofit网络请求

文章内容大纲 (右击展开→→)

内容预览:
  • Retrofit的网络请求全部交给okhttp来处理,因此我们可以通过OkHttpClien...~
  • Application拦截器工作区域为应用发出请求到okhttp核心之间,远端响应经...~
  • 拦截器工作示意简图 上图是okhttp拦截器工作原理简图,重点在右边部分~

始发于微信公众号: 程序员小乐

优雅的构建Android项目之RxAndroid+Retrofit网络请求


分享互联网、技术、情感等干货平台。您还可以向公众号投稿,将自己总结的技术、心得、经验分享给大家。学无止境,不求尽如人意,但求问心无愧。让学习成为一种美、一种习惯。值得爱学习的你去关注,感觉有帮助转发分享让更多的人去关注!点击上方蓝字关注!


作者:PandaQ404

链接:http://www.jianshu.com/p/a7635e39c5ac

注意

Retrofit 2.0+和Retrofit 2.0之前的版本语法上有差别,本文基于Retrofit2.1.0

什么是Retrofit?

retrofit是一款针对Android网络请求的开源框架,它与okhttp一样出自Square公司。Rotrofit2.0的网络框架全部交给了okhttp来实现,Android N之后Apache的httpclient已经被Google从SDK中移除,Okhttp则成功上位。Retrofit的网络请求实现风格与URLconnection和httpClient有较大的差别。创建请求的时候需要先创建基于注解的服务接口(不了解的可以先了解一下注解),进行网络请求的时候再通过retrofit.creat()方法创建请求。

Retrofit中http POST/GET请求

Retrofit中的网络请求都是通过注解方式的接口方法来表示的,此处只对常用的post和get请求进行说明,Retrofit还提供有put,delete等请求方式可自己研究文档使用

post请求

  • Body对象作为post参数

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • Field方式

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • FieldMap方式

  • 优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 参数较多时建议用Body方式和FieldMap方式

    get请求

  • 直接请求某一地址获取列表

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • url拼接固定查询条件

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • url中拼接地址信息

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 通过Query注解添加其他查询条件

  • 优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 查询条件较多时同样有QueryMap注解方法供使用

  • 优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 通过上面的API方法会发现都是在进行请求条件的配置,假如我要给请求加请求头怎么办?放心,retrofit也有相应的注解。除了注解之外还有一个万用的处理方法。

    Header请求头设置

  • 为请求添加固定请求头

  • 优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 动态添加请求头

  • 优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 上面的两种添加请求头的方法作用范围只是添加注解的单个方法,如果想为每个请求都添加请求头还按这种方式来做的话就很不程序猿了。Retrofit的网络请求全部交给okhttp来处理,因此我们可以通过OkHttpClient来做文章,自己重写okhttp的拦截器在拦截器内再进行需要的操作

    Okhttp interceptor

    拦截器顾名思义,所有通过okhttp进行的请求都会过一遍okhttpClient的拦截器,发出去的请求,收到的响应都会经过他,就像一个双向的安检通道。
    okhttp拦截器的原理如下:

优雅的构建Android项目之RxAndroid+Retrofit网络请求

okhttp拦截器,图片来自okhttp官网


如图所示拦截器分为Application Interceptors和NetWork Interceptors。Application拦截器工作区域为应用发出请求到okhttp核心之间,远端响应经过okhttp核心后到达应用处理之前。而NetWork拦截器的作用域为okhtt核心到远端服务器之间的部分。明显区别就是当一次请求中会有一个重定向的时候Application拦截器只会响应一次,因为对于应用来说就进行了一次请求。而NetWork拦截器会在重定向时也响应即响应两次,也不难理解,毕竟重定向也会经过一次okhttp核心嘛。

优雅的构建Android项目之RxAndroid+Retrofit网络请求

拦截器工作示意简图


上图是okhttp拦截器工作原理简图,重点在右边部分。当多个拦截器配合使用时,不用担心请求拦截和响应拦截顺序会错乱,okhttp已经给你排好了。

优雅的构建Android项目之RxAndroid+Retrofit网络请求


上传个需要压缩和编码的东东的时候,你可以选择先写个拦截器请求时压缩响应时解压,再写个拦截器请求时编码响应时解码。加起来就是压缩->编码->okhttClient与服务器的Py交易->解码->解压跟栈先进后出类似。

原理扯了一大堆,代码才是干货,看了代码才知道怎么用。

优雅的构建Android项目之RxAndroid+Retrofit网络请求

通过Request request = chain.request();拿到请求实例,想怎么装扮就怎么装扮,什么加请求头,设置编码格式soeasy。前面说到的为每个请求设置请求头就是在这完成设置工作的。但是真正要加到请求里跟retrofit的ApiService接口一起用还需要将Okhttp注册拦截器后与Retrofit绑定才行。

优雅的构建Android项目之RxAndroid+Retrofit网络请求

该如何使用Retrofit?

基本也说得差不多了,那么怎么使用Retrofit进行一次完整的网络请求呢
需要注意一下Retrofit的Url拼接规则

优雅的构建Android项目之RxAndroid+Retrofit网络请求

enter description here

优雅的构建Android项目之RxAndroid+Retrofit网络请求

enter description here

优雅的构建Android项目之RxAndroid+Retrofit网络请求

enter description here


个人建议以第一幅图的方式,baseUrl总是以/结尾,接口rul总是不以/开头

  • 1、当然是引入retrofit的库啦

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 2、创建一个ServiceApi接口

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 3、我建议是维护一个统一的api管理类。当然你要直接拿接口用也行,但可维护性会降低很多

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 4、调用接口方法进行网络请求

    优雅的构建Android项目之RxAndroid+Retrofit网络请求

  • 使用Retrofit的好处

  • 可以少写不少的代码

  • 接口方便维护需要改什么直接到ApiService中进行配置即可

  • 异步请求不再需要自己来newThread再handler,也不需要自己再来写请求结果回调。异步请求只需要使用call.enqueue()即可。

  • 支持RxAndroid,这个我觉得很重要

  • 降低工程的耦合度,网络请求跟逻辑代码完全剥离开。需要的仅仅是传递参数有的请求甚至参数都不需要传递。直接在接口中配置就好。

Retrofit的好基友——RxAndroid

RxAndroid是RxJava在Android上的变种。那么RxJava到底是什么呢?
“a library for composing asynchronous and event-based programs using observable sequences for the Java VM”(一个在 Java VM 上使用可观测的序列来组成异步的、基于事件的程序的库)。这是github项目主页的自我概括,我觉得其实就两个关键词,
异步基于事件。这里我只说一下RxAndroid怎么跟Retrofit搭配使用,要进一步了解可以异步扔物线大神的文章给 Android 开发者的 RxJava 详解。讲的肯定比我好,我就是看这个入门的。

Retrofit+RxAndroid使用

因为用到Retrofit所以定义接口,创建ApiManager这些跟上面单纯用Retrofit是一毛一样的,唯一的不同是接口的返回类型从Retrofit的Call对象变成了Observable对象,即被观察者对象。然后就是调用进行网络请求部分变成如下形式

优雅的构建Android项目之RxAndroid+Retrofit网络请求

优雅的构建Android项目之RxAndroid+Retrofit网络请求

网络请求得到的是一个Obserable对象,该对象再通过subscrible()绑定一个观察者对象,观察者对象中有onCompleted(),onError(),onNext()三个回调方法。事件过程中出错onError()触发并停止后续事件,一个Obserable对象一次发出多个事件每次都会触发onNext(),当不再有事件发出的时候onCompleted()方法触发并结束。异步在RxAndroid中变得很简单subscribeOn指定事件发生线程,如上面的网络请求被指定在io线程中,observeOn指定事件的消费线程,如上面的知乎故事数据结果被交给主线程显示。

RxAndroid的优点

看完上面单独使用retrofit和使用retrofit+rxandroid两种方式之后你也许会吐槽,尼玛脑子有坑?明明代码变多了。
但是你也会发现代码中都是.XX()的形式如果需求变化更多一些会更明显。比如说就上面的例子我要在每一条信息中修改某一个值。并且又要对结果进行一些筛选。只用retrofit的话是不是应该向这样:

优雅的构建Android项目之RxAndroid+Retrofit网络请求

如果需要设置和条件赛选层次越多会发现for套if,if再if会越嵌套越多。隔一段时间之后就真的成了“当初写下这段代码的时候只有我跟上帝知道他是干嘛的,现在只有上帝知道他是干嘛的”。而使用RxAndroid的话整个变换过程都是线性的哪一步做了什么都会很清楚不会出现各种蜜汁缩进:

优雅的构建Android项目之RxAndroid+Retrofit网络请求

优雅的构建Android项目之RxAndroid+Retrofit网络请求

越复杂的逻辑,Rx的优势也就越明显。Rx的操作符各种组合起来几乎能够满足所有的变换需求。开始写可能会觉得很不适应,但熟练使用之后会默念Rx大法好的。
对于RxJava操作符鼠标悬停都会有文字和示意图的,另外发现一个不错的博客里面也有较详细的解析
RxJava/RxAndroid操作符(http://blog.csdn.net/u010163442/article/category/6270573)

Demo地址

在之前的那个MVPDemo的基础上写的,okhttp请求方式,单纯retrofit方式,retrofit+rxAndroid方式的请求都有保留,可以对比着感受一下。
demo仓库地(https://github.com/PandaQAQ/MvpDemo)

如果您觉得不错,请别忘了分享到您的朋友圈让更多的人看到!! 您的举手之劳,就是对我最好的支持,非常感谢!

推荐文章(关注公众号查看往期文章):
学习资料(干货汇集)不断更新【更新于2017-2-25】
2017 年初、阿里、腾讯、百度、华为、京东、搜狗和滴滴面试题汇集(更新篇)
如果你喜欢上了一个程序员小伙,献给所有的程序员女友
【QQ技术群】279126311 [满]
【QQ技术群】484572225 [未]

大家可以加群和大牛们一起学习,由于“大牛聚集之地”已满
可以进大牛聚集之地2群,群二维码如下:

优雅的构建Android项目之RxAndroid+Retrofit网络请求

如果人满了,可以加我的微信,我拉你进二群,我的微信:1733563441(请备注)
看完本文有收获?请转发分享给更多人
关注「杨守乐」,提升编程技能

优雅的构建Android项目之RxAndroid+Retrofit网络请求

如何关注:

① 长按二维码,选择“识别图中二维码”进行关注。

 点击微信右上角的“+”,会出现“添加朋友”,进入“公众号”,输入公众号的ysle_0313(杨守乐)名字,即可找到。

如果你有好的文章想和大家分享,欢迎投稿,直接向我投递文章链接即可。投稿邮箱:[email protected]/[email protected]
欢迎扫描关注我们的微信公众号ysle_0313,不要错过每一篇干货~

赞助方式如下链接:

http://blog.csdn.net/xiaole0313/article/details/52333666

版权声明:【我们尊重原创。此篇干货,版权属于原作者。部分文章推送时因种种原因未能与原作者联系上,若涉及版权问题,敬请原作者联系我们,立即处理。】

以上就是:优雅的构建Android项目之RxAndroid+Retrofit网络请求 的全部内容。

本站部分内容来源于互联网和用户投稿,如有侵权请联系我们删除,谢谢。
Email:[email protected]


0 条回复 A 作者 M 管理员
    所有的伟大,都源于一个勇敢的开始!
欢迎您,新朋友,感谢参与互动!欢迎您 {{author}},您在本站有{{commentsCount}}条评论