Retrofit
A type-safe HTTP client for Android and Java 适用于Java和Android的安全的HTTP客户端
Retrofit是一个RESTful的可用于Android和Java的HTTP网络请求框架的封装,使用它可以简化我们的网络操作,提高效率和正确率。它将请求过程和底层代码封装起来只暴露我们业务中的请求和返回数据模型。
值得注意的是,Retrofit并不是完成了网络请求,而是对网络请求框架Okhttp的封装,在Retrofit 2.0开始内置了Okhttp.
开始使用Retrofit,引入依赖:
|
|
定义一个Service接口并定义listRepos()
请求。
|
|
这是一个Retrofit将Rest API(服务端post或get请求)转换为Java接口的例子
每一个由接口返回的Call对象都可以与远程web服务端进行同步或者异步的HTTP请求通信。例如:
|
|
Service接口有了,接下来就是初始化(构造)Retrofit:
|
|
为什么选择Retrofit
AsyncTask ,Volley和Retrofit的对比
One Discussion | Dashboard( 7 request ) | 25 Discussions | |
---|---|---|---|
AsyncTask | 941ms | 4539ms | 13957ms |
Volley | 560ms | 2202ms | 4275ms |
Retrofit | 312ms | 889ms | 1059ms |
Retrofit中的注解
Retrofit使用注解来描述HTTP请求
请求方式
每一个请求必须指定http请求相对应的url注解和请求方式(内置5种请求方式注解:GET、POST、PUT 、DELETE、HEAD)
|
|
也可以将参数跟在后面
|
|
URL操作
一个请求的URL的参数可以通过{}包裹快来动态替换,然后在相应的@Path参数中进行赋值。
|
|
例如这个{id}在groupList请求中的@Path(“id”) int groupId来对应赋值。
也可以使用@Query给groupList请求方法动态添加其他请求参数
|
|
如果是比较多的请求参数,我们可以使用Map来构建
|
|
请求的Body
能够通过@Body注解来指定一个方法作为HTTP请求主体
|
|
这个参数对象会被Retrofit实例中的converter进行转化。如果没有给Retrofit实例添加任何converter的话则只有RequestBody可以作为参数使用。
form encode 和 multipart
方法也可以通过声明来发送form-encoded和multipart类型的数据。 可以通过@FormUrlEncoded注解方法来发送form-encoded的数据。每个键值对需要用@Filed来注解键名,随后的对象需要提供值。
|
|
也可以通过@Multipart注解方法来发送Mutipart请求。每个部分需要使用@Part来注解。
|
|
多个请求部分需要使用Retrofit的converter或者是自己实现 RequestBody来处理自己内部的数据序列化
头部操作
可以通过使用@Headers注解来设置请求静态头。
|
|
|
|
注意的是头部参数并不会相互覆盖,同一个名称的所有头参数都会被包含进请求里面。 当然你可以通过 @Header 注解来动态更新请求头。一个相应的参数必须提供给 @Header 注解。如果这个值是空(null)的话,那么这个头部参数就会被忽略。否则的话, 值的 toString 方法将会被调用,并且使用调用结果。
|
|