Retrofit：使用【Retrofit】优雅地对接第三方接口

一、前言

• 在实际开发当中，我们常常会对接一些第三方的接口来获取我们想要的数据。过去以往的对接技术比较繁琐，且不优雅。今天就来介绍一下如何使用：Retrofit 优雅地对接第三方接口。
• 今天介绍的这款：Retrofit 是由 github作者： LianjiaTech 发布的一个与 SpringBoot 整合的项目，使用起来比较简单，功能丰富，代码也比较优雅。
• 项目地址：github： https://github.com/LianjiaTech/retrofit-spring-boot-starter

二、Retrofit 的介绍

• Retrofit 是适用于 Android 和 Java 且类型安全的 HTTP 客户端，其最大的特性的是支持通过接口的方式发起 HTTP 请求。而 Spring-Boot 是使用最广泛的 Java 开发框架，但是 Retrofit 官方没有支持与 Spring-Boot 框架快速整合，因此 LianjiaTech：github 作者他们开发了 Retrofit-Spring-Boot-Starter。
• retrofit-spring-boot-starter 实现了 Retrofit 与 Spring-Boot 框架快速整合，并且支持了诸多功能增强，极大简化开发。

三、HTTP请求相关注解

• HTTP 请求相关注解，详细信息可参考官方文档：retrofit retrofit：官方文档，以下是一个简单的说明。
• 请求方式：@GET @HEAD @POST @PUT @DELETE @OPTIONS @HTTP
• 请求头：@Header @HeaderMap @Headers
• 查询参数：@Query @QueryMap @QueryName
• 路径参数：@Path
• 形式编码参数：@Field @FieldMap @FormUrlEncoded
• 请求体：@Body
• 上传文件：@Multipart @Part @PartMap
• 网址参数：@Url

四、具体使用

• 这里我就直接演示 Retrofit 是如何具体使用的，详细的具体参数可参考上方 github 项目，里面有具体的介绍。

• 由于我们这个项目会对接大量的第三方接口，所以我们都会归类起来针对一个具体的功能建一个 interface，然后去对接第三方不同的接口，最终哪里用到直接注入对应接口即可，通过Service调用具体方法嵌入到业务中。

• 接口的基本请求 IP直接用这个自定义注解，里面用这个 baseUrl 即可

• 这 baseUrl 我们直接写在配置里面会好一些，这样可以正对不同环境进行变换，而不是直接写死

• 关于上图中 @Sign 自定义注解的作用

@Retention(RetentionPolicy