远程调用 - [spring-cloud]-Feign扩展点 Contract 介绍 - 《Spring Framework》

一、Feign Contract 作用
- 1.1、基于 spring boot 如何编写 Feign 调用
- 1.2、Feign contract 作用
二、关于 Contract 的实现

Spring Boot 2.1.x Spring Cloud Greenwich.SRx

一、Feign Contract 作用

1.1、基于 spring boot 如何编写 Feign 调用

Spring Boot + Feign 是远程 RPC 的一种实现方案，通常在代码中，定义一个远程API会采用接口的方式，使用 Spring MVC的方式定义一个远程调用，如：使用对应的 annotation ，@RequestParam、@RequestBody等。
学习成本低，编写风格也和编写 Spring Mvc 接口一致，很简单就定义了相关的远程 RPC 调用接口。

参考代码如下：

1.2、Feign contract 作用

《Feign如何进行服务间请求调用#Feign Clietn 调用流程》中讨论 Feign 进行服务间调用的本质就是拼接 RequestTemplate 对象，发起 HTTP 请求。

拼接 HTTP 请求通常会涉及到几个问题点：

1、常见的 POST 还是 GET ，或者 DELETE 等请求方法
2、参数存放到表单，还是使用 JSON 字符串
3、请求 URL 定义

再来对照一下平时写代码时关于 Feign 接口的定义：

通过代码，能够想象得到，通过解析接口（标记了 @FeignClient 标识的接口）方法上的相关注解定义就能够得到拼接 HTTP 请求所需的参数

如：@RequestMapping 定义的 POST 方法
如：@RequestMapping定义的资源访问路径
如：方法参数上 @RequestBody定义了传输方式使用的 JSON 字符串格式

在 Feign 代码中完成该项工作的是 feign.Contract

二、关于 Contract 的实现

Spring Boot 集成 Feign + Hystrix 后相关实现

2.1、Contract 接口定义

根据 Contract源码及注释能够得到

Contract 定义了Contract#parseAndValidatateMetadata方法用来解析 Feign 接口从而得到 Http 请求所需相关参数
通过 Contract 能够定义不同Feign 接口解析方案

2.2、BaseContract 模板抽象类
BaseContract是 Contract模板抽象实现，BaseContract定义了关于 Feign接口的基础模板流程
接口格式校验
解析 Feign 接口标注的 Annotation ，然后构建 MethodMetadata对象存储相关数据。