Android知识梳理：Retrofit网络请求参数注解

最新推荐文章于 2026-04-23 07:32:59 发布

原创最新推荐文章于 2026-04-23 07:32:59 发布 · 959 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#Retrofit注解 #Android

知识梳理专栏收录该内容

14 篇文章

订阅专栏

本文介绍了Retrofit在Android中的使用，包括请求方式注解（如@GET、@POST等）、URL拼接方式、标记和参数（如@FormUrlEncoded、@Multipart等）、解析器和适配器（如GsonConverterFactory、RxJava2CallAdapterFactory），以及提供了应用实例。

前言

作为当下最流行的网络请求框架之一，Retrofit使用通俗简洁的注解就实现了网络请求url等一系列设置，下面就这些注解进行一次学习记录

大纲

1.请求方式注解

2.URL拼接方式

3.标记和参数

4.解析器和适配器

5.应用实例

正文

1.请求方式注解

一般请求方式有如下几种

@GET、@POST、@HEAD、@PUT、@HTTP...

以上注解之后一般带的是接口，url则用baseUrl设置

如
@GET（接口地址path）
在创建Retrofit对象设置服务器地址baseUrl(xxx)
那么完整url = xxx + path

2.URL拼接方式

大致有一下三种拼接方式

<1.path完整，不设置baseUrl

即每注解后直接跟的是完整的服务器接口url

<2.path绝对路径，baseUrl目录形式

path = /xxx
baseUrl = http://.../a/b
URL = http://.../a/xxx
<3.path相对路径，baseUrl目录(推荐使用)
path = xxx
baseUrl = http://.../a/b/
URL = http://.../a/b/xxx

3.标记和参数

大致罗列几种常见的

@FormUrlEncoded
请求体为表单

@Multipart
请求体为支持文件上传表单

@Streaming
返回以流形式（默认全载入内存）

@Headers
添加固定请求头

@Head
添加不固定请求头

@File、@FileMap
post表单键值对、数据体现在请求体上

@Query、@QueryMap
与上类似，区别是数据提现在Url上

4.解析器和适配器

addConverterFactory（）
解析器一般为Gson解析，传入GsonConverterFactory.create即可，有需要可以自行封装

addCallAdapterFactory（）
网络适配器一般使用Rxjava，传入RxJava2CallAdpaterFactory.create

5.应用实例

mRetrofit = new Retrofit.Builder()
        .client(client)
        .baseUrl(RetrofitConfig.BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
        .build();

mApiService = mRetrofit.create(IApiService.class);

参考

https://www.jianshu.com/p/f7026cbf1cc9