目录

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中引入依赖

<!-- 添加springcloud 的openfeign-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
           <!-- 排除冲突的jar包文件-->
            <exclusions>
                <exclusion>
                    <groupId>org.springframework</groupId>
                    <artifactId>spring-web</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-commons</artifactId>
                </exclusion>
            </exclusions>

        </dependency>

(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。

微服务调用失败 微服务调用组件_open feign

 (4)系统中再创建一个项目ProductNacos(商品管理系统),提供一个带参数@PathVariable 方式的访问服务。为了后面配置整体日志、指定某个日志方式做准备。

微服务调用失败 微服务调用组件_Feign_02

(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请求时可以不带上具体的参数名。

微服务调用失败 微服务调用组件_spring cloud_03

(6)配置Feign的日志级别为全局方式,所有的服务都使用这个日志级别,在Feign日志配置类中加注解@Configuration

微服务调用失败 微服务调用组件_open feign_04

 (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调用日志都输出来了。

微服务调用失败 微服务调用组件_open feign_05

(9)feign日志指定某个服务调用时使用配置方式

需要先去除@Configuration配置

微服务调用失败 微服务调用组件_spring cloud_06

 方式一:在Feign的配置接口中添加configuration指定

微服务调用失败 微服务调用组件_微服务调用失败_07

只有商品的日志信息打印出来了

微服务调用失败 微服务调用组件_open feign_08

方式二:在application.properties配置文件中指定

#feign日志局部配置:feign.client.config.服务名.logger-level=日志级别
feign.client.config.stock-service.logger-level=BASIC

此时只有stock服务调用有日志

微服务调用失败 微服务调用组件_微服务调用失败_09

 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的注解

微服务调用失败 微服务调用组件_Feign超时_10

 

微服务调用失败 微服务调用组件_Feign_11

 

微服务调用失败 微服务调用组件_微服务调用失败_12

 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=10000

6.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的参数成功

微服务调用失败 微服务调用组件_spring cloud_13

微服务调用失败 微服务调用组件_Feign超时_14

7.Feign远程调用原理

微服务调用失败 微服务调用组件_open feign_15

 Feign远程调用流程图

微服务调用失败 微服务调用组件_Feign_16

 

(1) 基于面向接口的动态代理方式生成实现类

在使用feign 时,会定义对应的接口类,在接口类上使用Http相关的注解,@FeignClient,标识HTTP请求参数信息,在Feign 底层,通过基于面向接口的动态代理方式生成实现类,将请求调用委托到动态代理实现类。

(2) 根据Contract协议规则,解析接口类的注解信息,解析分为默认的契约方式或者spring mvc的方式。

微服务调用失败 微服务调用组件_open feign_17

 

(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

微服务调用失败 微服务调用组件_Feign超时_18