Spring cloud alibaba--Feign微服务调用组件
目录
1.1Feign优势
2.spring cloud alibaba整合Feign
3.Spring Cloud Feign日志配置
4.Feign契约配置
5.Feign超时时间配置
6.Open Feign自定义拦截器
7.Feign远程调用原理
1.什么是Feign
Feign是Netflix开发的声明式、模板化的HTTP客户端，Feign支持多种注解，例如JAX-RS注解。
spring cloud openfeign对feign进行了增强，使其支持spring mvc注解，另外还整合了Ribbon和Nacos，从而使得feign的使用更加方便。
1.1Feign优势
Feign可以做到使用http请求远程服务时就像调用本地方法一样的体验，开发者完全感知不到这是远程调用，更感知不到这是http请求。它像dubbo一样，consumer直接调用接口调用provider，而不需要通过常规的Http client构造请求再解析返回数据。它解决了让开发者调用远程接口跟调用本地方法一样，无需关注与远程的交互细节，更无需关注分布式环境开发。
2.spring cloud alibaba整合Feign
（1）pom.xml中引入依赖
org.springframework.cloud
spring-cloud-starter-openfeign
org.springframework
spring-web
org.springframework.cloud
spring-cloud-commons
（2）application.properties中配置链接nacos的信息
server.port=8084
#应用名称，nacos会将该名称当做服务名称
spring.application.name=order-service
#nacos服务连接地址
spring.cloud.nacos.server-addr=127.0.0.1:8848
#nacos discovery连接用户名
spring.cloud.nacos.discovery.username=nacos
#nacos discovery连接密码
spring.cloud.nacos.discovery.password=nacos
#nacos discovery工作空间
spring.cloud.nacos.discovery.workspace=public（3）编写Feign调用接口
使用@FeignClient来定义feign的调用方式，value为调用的服务名，path对应被调用服务处理的controller层，按相同的写法把提供者的方法在此接口中实现，使用spring mvc注解请求的方式定义。/**
* 使用@FeignClient来定义feign的调用方式，value为调用的服务名，path对应被调用服务处理的controller层
*/
@FeignClient(value = "stock-service",path ="/stock" )
public interface StockOpenFeign {
@RequestMapping("/reduct")
String reduct();
}
/**
* @RequestMapping("/stock")
* public class StockController {
*
* @Value("${server.port}")
* String port;
*
* @RequestMapping("/reduct")
* public String reduct(){
* System.out.println("扣减库存");
* return "扣减库存成功，端口号为："+port+"的服务提供调用";
* }
* }
*/（4）调用类在启动类代码中添加@EnableFeignClients注解
/**
* 程序启动类
*/
@SpringBootApplication
@EnableFeignClients
public class OrderApplication {
public static void main(String[] args) {
SpringApplication.run(OrderApplication.class,args);
}
}
（5）像调用本地一样发起远程调用，使用接口调用
之前使用spring boot 的RestTemplate调用方式：
①先创建RestTemplate
//程序启动时创建RestTemplate
//使用注解LoadBalanced标识负载均衡，默认轮询的方式
@Bean
@LoadBalanced
public RestTemplate restTemplate(RestTemplateBuilder builder){
RestTemplate build = builder.build();
return build;
}②程序中使用RestTemplate调用
//注入RestTemplate
@Autowired
RestTemplate restTemplate;
@RequestMapping("/add")
public String add(){
System.out.println("下单成功");
// String forObject = restTemplate.getForObject("http://localhost:8083/stock/reduct", String.class);
String forObject = restTemplate.getForObject("http://stock-service/stock/reduct", String.class);
return "add order "+forObject;
}现在使用OpenFeign调用：直接使用刚才创建的接口定义的方法
@Autowired
StockOpenFeign stockOpenFeign;
@RequestMapping("/add")
public String add(){
System.out.println("下单成功");
String reduct = stockOpenFeign.reduct();
return "add order "+reduct;
}3.Spring Cloud Feign日志配置
当我们遇到Bug，比如接口调用失败，参数没收到等问题，或者想看看调用性能问题，就需要配置Feign的性能日志，以此让Feign把请求信息输出来。
（1）Feign的日志级别有四种
①NONE【性能最佳，适用于生产】：不记录任何日志（默认）
②BASIC【适用于生产环境追踪问题】：仅记录请求方法，URL，响应状态代码及执行时间
③HEADERS：记录BASIC的基础上，记录请求和响应的header、
④FULL【比较适用于开发和测试环境定位问题】：记录请求和响应的header、body和元数据
（2）定义一个配置类，指定日志级别
/**
* Feign配置类
*/
public class FeignConfig {
//指定日志级别
@Bean
public Logger.Level feignLoggerLever(){
return Logger.Level.FULL;
}
}（3）application中配置日志级别
spring boot默认级别是info，feign需要配置为debug,所以默认级别情况下不输出feign日志，debug模式，日志太多，可以指定某个包下的日志配置成dubug。
（4）系统中再创建一个项目ProductNacos（商品管理系统），提供一个带参数@PathVariable 方式的访问服务。为了后面配置整体日志、指定某个日志方式做准备。
（5）使用Feign访问订单OrderNacos和商品ProductNacos项目的配置接口
/**
* 使用@FeignClient来定义feign的调用方式，value为调用的服务名，path对应被调用服务处理的controller层
*/
@FeignClient(value = "stock-service",path ="/stock" )
public interface StockOpenFeign {
@RequestMapping("/reduct")
String reduct();
}/**
* 使用feign方式访问ProductNacos项目
*/
@FeignClient(value = "product-service",path = "product")
public interface ProductOpenFeign {
@RequestMapping("/{id}")
String get(@PathVariable("id") Integer id);
}
******当我们有参数时，使用@PathVariable时，需要把具体的参数名带上@PathVariable("id")，否则feign会报错，spring mvc请求时可以不带上具体的参数名。
（6）配置Feign的日志级别为全局方式，所有的服务都使用这个日志级别，在Feign日志配置类中加注解@Configuration
（7）我们的订单控制层，使用Feign的方式，调用库存Stock和商品Product的方式
@RestController
@RequestMapping("/order")
public class OrderController {
@Autowired
StockOpenFeign stockOpenFeign;
@Autowired
ProductOpenFeign productOpenFeign;
@RequestMapping("/add")
public String add(){
System.out.println("下单成功");
String reduct = stockOpenFeign.reduct();
String s = productOpenFeign.get(1);
return "add order "+reduct+s;
}
}
（8）访问服务，查看使用@Configuration全局配置日志的方式，控制台的输出情况：两个服务的feign调用日志都输出来了。
（9）feign日志指定某个服务调用时使用配置方式
需要先去除@Configuration配置
方式一：在Feign的配置接口中添加configuration指定
只有商品的日志信息打印出来了
方式二：在application.properties配置文件中指定
#feign日志局部配置:feign.client.config.服务名.logger-level=日志级别
feign.client.config.stock-service.logger-level=BASIC此时只有stock服务调用有日志
4.Feign契约配置
Spring cloud在Feign的基础上做了扩展，使用Spring MVC注解的方式来完成Feign的功能。原生的Feign是不支持Spring mvc的，如果想在spring cloud客户端中使用原生的注解方式定义客户端也是可以的，通过配置契约来改变这个配置。
（1）修改契约配置，支持Feign原生的注解
//修改契约配置，支持Feign原生的注解
@Bean
public Contract feignContract(){
return new Contract.Default();
}注意：修改Feign的契约后，使用Feign连接的接口不在支持spring mvc的注解，需要使用Feign原生的注解
（2）Feign连接的接口使用原生的注解
RequestMapping需要改成RequestLine；@PathVariable需要改成@Param@FeignClient(value = "product-service",path = "/product")
public interface ProductOpenFeign {
@RequestLine("GET /{id}")
String get(@Param("id") Integer id);
}
（3）可以在application.properties配置文件中配置，局部指定某个服务使用原生feign配置
#feign契约局部配置:feign.client.config.服务名.contract=feign.Contract.Default
feign.client.config.product-service.contract=feign.Contract.Default此时只是product-service这个配置了原生的feign，stock-service还是使用spring mvc的注解
5.Feign超时时间配置
通过Options可以设置连接超时时间和读取超时时间，Options的第一个参数是连接的超时时间（ms），模式2s；第二个参数是请求处理的超时时间（ms），默认5s。
（1）全局配置
@Bean
public Request.Options options(){
return new Request.Options(5000,10000);
}（2）application.properties配置文件中进行局部配置
#feign连接超时时间局部配置:feign.client.config.服务名.connect-timeout=
feign.client.config.product-service.connect-timeout=5000
#feign请求处理超时时间局部配置:feign.client.config.服务名.connect-timeout=
feign.client.config.product-service.read-timeout=100006.Open Feign自定义拦截器
（1）定义一个拦截器来，实现RequestInterceptor接口
/**
* 自定义feign拦截器
*/
public class FeignAuthRequestInterceptor implements RequestInterceptor {
//重写拦截方法
@Override
public void apply(RequestTemplate requestTemplate) {
System.out.println("Feign拦截器拦截到信息");
requestTemplate.uri("/8"); //改变请求的结尾链接
}
}
（2）在配置类中使用@Configuration全局配置
//配置自定义拦截器
@Bean
public FeignAuthRequestInterceptor feignAuthRequestInterceptor(){
return new FeignAuthRequestInterceptor();
}（3）可以在application.properties配置文件中配置，局部配置
#feign请求处理超时时间局部配置:feign.client.config.服务名.request-interceptors[数组长度，支持多个拦截器]=自定义拦截器目录
feign.client.config.product-service.request-interceptors[0]=com.qingyun.inter.FeignAuthRequestInterceptor（4）Feign发送请求前拦截控制台打印数据，修改uri的参数成功
7.Feign远程调用原理
Feign远程调用流程图
(1) 基于面向接口的动态代理方式生成实现类
在使用feign 时，会定义对应的接口类，在接口类上使用Http相关的注解，@FeignClient，标识HTTP请求参数信息，在Feign 底层，通过基于面向接口的动态代理方式生成实现类，将请求调用委托到动态代理实现类。
(2) 根据Contract协议规则，解析接口类的注解信息，解析分为默认的契约方式或者spring mvc的方式。
(3) 基于 RequestBean，动态生成Request
根据传入的Bean对象和注解信息，从中提取出相应的值，来构造Http Request 对象。
(4) 使用Encoder 将Bean转换成 Http报文正文（消息解析和转码逻辑）
Feign 最终会将请求转换成Http 消息发送出去，传入的请求对象最终会解析成消息体。
(5) 拦截器负责对请求和返回进行装饰处理
在请求转换的过程中，Feign 抽象出来了拦截器接口，用于用户自定义对请求的操作，比如，如果希望Http消息传递过程中被压缩，可以定义一个请求拦截器。
(6) 日志记录
(7) 基于重试器发送HTTP请求
Feign 内置了一个重试器，当HTTP请求出现IO异常时，Feign会有一个最大尝试次数发送请求
(8) 发送Http请求
Feign 真正发送HTTP请求是委托给 feign.Client 来做的。
Feign 默认底层通过JDK 的 java.net.HttpURLConnection 实现了feign.Client接口类,在每次发送请求的时候，都会创建新的HttpURLConnection 链接
（9）Feign优化
①GZIP压缩：当Gzip压缩到一个纯文本数据时，可以减少70％以上的数据大小。
②替换为HttpClient客户端（使用HTTP连接池提供性能）
Feign的HTTP客户端支持3种框架，分别是；HttpURLConnection、HttpClient、OKHttp。Feign中默认使用HttpURLConnection。
- HttpURLConnection是JDK自带的HTTP客户端技术，并不支持连接池，如果要实现连接池的机制，还需要自己来管理连接对象。对于网络请求这种底层相对复杂的操作，如果有可用的其他方案，也没有必要自己去管理连接对象。
- Apache提供的HttpClient框架相比传统JDK自带的HttpURLConnection，它封装了访问http的请求头，参数，内容体，响应等等；它不仅使客户端发送HTTP请求变得容易，而且也方便了开发人员测试接口（基于Http协议的），即提高了开发的效率，也方便提高代码的健壮性；另外高并发大量的请求网络的时候，还是用“HTTP连接池”提升吞吐量。
- OKHttp是一个处理网络请求的开源项目,是安卓端最火热的轻量级框架。OKHttp拥有共享Socket,减少对服务器的请求次数，通过连接池,减少了请求延迟等技术特点。
-
feign.httpclient.enabled=true
