首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Android中Retrofit的简要介绍

Android中Retrofit的简要介绍

作者头像
砸漏
发布2020-11-05 10:26:27
6980
发布2020-11-05 10:26:27
举报
文章被收录于专栏:恩蓝脚本恩蓝脚本

Retrofit

A type-safe HTTP client for Android and Java 适用于Java和Android的安全的HTTP客户端

Retrofit是一个可用于Android和Java的网络库,使用它可以简化我们的网络操作,提高效率和正确率。它将请求过程和底层代码封装起来只暴露我们业务中的请求和返回数据模型。

public interface GitHubService {
 @GET("users/{user}/repos")
 Call<List<Repo   listRepos(@Path("user") String user);
}

@这是一个Retrofit将Rest API(服务端post或get请求)转换为Java接口的例子

每一个由接口返回的Call对象都可以与远程web服务端进行同步或者异步的HTTP请求通信。例如:

Call<List<Repo   repos = service.listRepos("octocat");

为什么选择Retrofit

AsyncHttp ,Volley和Retrofit的对比

Retrofit中的注解

Retrofit使用注解来描述HTTP请求

请求方式

每一个请求必须指定http请求相对应的url注解和请求方式(内置5种请求方式注解:GET、POST、PUT 、DELETE、HEAD)

@GET("users/list")

也可以将参数跟在后面

@GET("users/list?sort=desc")

URL操作

一个请求的URL的参数可以通过{}包裹快来动态替换,然后在相应的@Path参数中进行赋值。

@GET("group/{id}/users")
Call<List<User   groupList(@Path("id") int groupId);

例如这个{id}在groupList请求中的@Path(“id”) int groupId来对应赋值。

也可以使用@Query给groupList请求方法动态添加其他请求参数

@GET("group/{id}/users")
Call<List<User   groupList(@Path("id") int groupId, @Query("sort") String sort);

如果是比较多的请求参数,我们可以使用Map来构建

@GET("group/{id}/users")
Call<List<User   groupList(@Path("id") int groupId, @QueryMap Map<String, String  options);

请求的Body

能够通过@Body注解来指定一个方法作为HTTP请求主体

@POST("users/new")
Call<User  createUser(@Body User user);

这个参数对象会被Retrofit实例中的converter进行转化。如果没有给Retrofit实例添加任何converter的话则只有RequestBody可以作为参数使用。

form encode 和 multipart

方法也可以通过声明来发送form-encoded和multipart类型的数据。

可以通过@FormUrlEncoded注解方法来发送form-encoded的数据。每个键值对需要用@Filed来注解键名,随后的对象需要提供值。

@FormUrlEncoded
@POST("user/edit")
Call<User  updateUser(@Field("first_name") String first, @Field("last_name") String last);

也可以通过@Multipart注解方法来发送Mutipart请求。每个部分需要使用@Part来注解。

@Multipart@PUT("user/photo")
Call<User  updateUser(@Part("photo") RequestBody photo, @Part("description") RequestBody description);

多个请求部分需要使用Retrofit的converter或者是自己实现 RequestBody来处理自己内部的数据序列化

头部操作

可以通过使用@Headers注解来设置请求静态头。

@Headers("Cache-Control: max-age=640000")
@GET("widget/list")
Call<List<Widget   widgetList();
@Headers({
  "Accept: application/vnd.github.v3.full+json",
  "User-Agent: Retrofit-Sample-App"
})
@GET("users/{username}")
Call<User  getUser(@Path("username") String username);

注意的是头部参数并不会相互覆盖,同一个名称的所有头参数都会被包含进请求里面。

当然你可以通过 @Header 注解来动态更新请求头。一个相应的参数必须提供给 @Header 注解。如果这个值是空(null)的话,那么这个头部参数就会被忽略。否则的话, 值的 toString 方法将会被调用,并且使用调用结果。

@GET("user")
Call<User  getUser(@Header("Authorization") String authorization)

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对ZaLou.Cn的支持。

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2020-09-11 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档