SpringCloudAliBaba之Feign介绍及使用:优雅的调用API

简介: SpringCloudAliBaba之Feign介绍及使用:优雅的调用API

1、什么是Feign

Feign是Netflix开发的声明式子,模板化的HTTP客户端,Feign可帮助我们更加便捷、优雅地调用HTTP API。

SpringCloud openfeign对Feign进行了增强,使其支持Spring MvC注解,另外还整合了Ribbon和Nacos,从而使得Feign的使用更加方便

优点

Feign可以做到使用HTTP请求远程服务时就像调用本地方法一样的体验,开发者完全感知不到这是远程方法,更感知不到这是一个HTTP请求。

2、SpringCloudAliBaba快速整合Feign

1、引入依赖

<!--添加openfeign的依赖-->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

2、编写调用接口

@FeignClient(value = "stock-server",path = "/stock")
public interface StockFeignService {
    @RequestMapping("/stockList")
    public String getStock();
}

3、启动类上添加@EnableFeignClients注解

@EnableFeignClients
@SpringBootApplication
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class,args);
    }
}

4、发起调用,像调用本地方法一样调用远程服务

@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    StockFeignService stockFeignService;
    @GetMapping("/orderList")
    public String getOrder() {
        return stockFeignService.getStock();
    }
}

3、SpringCloud Feign的自定义配置及使用

3.1、日志配置

遇到Bug,如果接口调用失败,参数没收到等问题,就需要配置Feign的日志了,以便于将请求日志进行输出

1、定义一个配置类,指定日志级别

/**
 * 注意此处如果配置@Configuration注解就会全局生效,如果想指定对应微服务,就不能配置
 */
public class FeignConfig {
    /**
     *  日志级别      
     **/
    @Bean
    public Logger.Level feignLoggerLevel(){
        return Logger.Level.FULL;
    }
}

通过源码可以看到日志等级有四种,分别是

  • NOHE【性能最佳,适用于生产】:不记录任何日志(默认值)
  • BASIC【适用于生产环境追踪问题】:仅记录请求方法,URL、响应状态码以及执行时间。
  • HEADERS:记录BASIC级别的基础上,记录请求和响应的header。
  • FULL:【比较适用于开发及测试环境定位问题】:记录请求和响应的header,body和元数据。

2、进行配置,让调用的微服务生效,在@FeignClient注解中指定使用的配置类

3、yml配置,由于springboot默认的日志级别是info,feign的debug日志级别不会输出

4、调用服务进行实验

先使用全局配置进行测试

编写好controller层

@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    StockFeignService stockFeignService;
    @Autowired
    ProductFeignService productFeignService;
    @GetMapping("/orderList")
    public String getOrder() {
        return stockFeignService.getStock()+productFeignService.getProduct();
    }
}

结果

局部配置:对单一服务进行配置

步骤一:去掉FeignConfig上面的@Configuration注解

步骤二:在其中一个服务上添加配置

结果:

特别补充:当然,与Ribbon一样,Feign也可以在yml进行局部日志配置

#feign日志局部配置     
feign:
  client:
    config:
      product-server: #对应微服务
        logger-level: FULL

3.2、契约配置

Spring Cloud 在Feign的基础上做了扩展,使用Spring MVC的注解来完成Feign的功能,原生的Feign是不支持Spring MVC注解的,如果你想在SpringCloud中使用原生的注解方式定义客户端也是可以的,通过配置契约来改变这个配置,Spring Cloud 中默认的是SpringMVCContract。

Spring Cloud 1早期版本就是用的原生Feign,随着netflix的停更换成了Open feign

1、修改契约配置,支持Feign原生的注解

@Bean
public Contract feignContract(){
    return new Contrat.Default();
}

2、OrderFeignService中配置使用Feign原生的注解

@FeignClient(value = "stock-server",path = "/stock")
public interface StockFeignService {
    @RequestLine("GET /stockList")
    public String getStock();
}

3、补充,也可以通过yml配置契约

feign:
  client:
    config:
      product-server: #对应微服务
        logger-level: FULL
        contract: feign.contract.Default #指定Feign原生注解契约配置

3.3、配置超时时间

通过Options可以配置连接超时时间和读取超时时间,Options的第一个参数是连接的超时时间(ms),默认值是2s;第二个请求处理的超时时间(ms),默认是5s

全局配置

@Bean
public Request.Options options(){
    return new Request.Options(5000,10000);
}

yml中配置

feign:
  client:
    config:
      product-server: #对应微服务
        # 连接超时时间(也可在配置类进行配置)
        connect-timeout: 5000
        # 请求处理超时时间
        read-timeout: 10000

3.4、自定义拦截器实现认证逻辑

在平常我们使用的拦截器,就是针对某个请求接口做出拦截,而这里的拦截器是针对服务与服务之见调用的拦截

1、自定义一个拦截器类

public class CustomerFeignInterceptor implements RequestInterceptor {
     Logger log = LoggerFactory.getLogger(this.getClass());
    @Override
    public void apply(RequestTemplate requestTemplate) {
        // 业务逻辑
        log.info("进入了拦截器");
        String token = UUID.randomUUID().toString();
        requestTemplate.header("Authorization",token);
    }
}

2、全局配置

@Bean
public CustomerFeignInterceptor customerFeignInterceptor() {
    return new CustomerFeignInterceptor();
}

3、yml方式配置(针对某一个服务做拦截)

feign:
  client:
    config:
      product-server: #对应微服务
        request-interceptors:
          - com.lili.cloud.interceptor.feign.CustomerFeignInterceptor

相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
目录
相关文章
|
7月前
|
Java API Spring
【异常】Feign 调用api模块直接进入fallback的问题解决办法
【异常】Feign 调用api模块直接进入fallback的问题解决办法
110 0
|
4天前
|
Java API 时序数据库
InfluxData【付诸实践 02】SpringBoot 集成时序数据库 InfluxDB 应用分享(InfluxDB实例+Feign接口调用InfluxDB API)源码分享
InfluxData【付诸实践 02】SpringBoot 集成时序数据库 InfluxDB 应用分享(InfluxDB实例+Feign接口调用InfluxDB API)源码分享
80 0
|
JSON 前端开发 Java
Spring Boot和Feign中使用Java 8时间日期API(LocalDate等)的序列化问题
Spring Boot和Feign中使用Java 8时间日期API(LocalDate等)的序列化问题
475 0
Spring Boot和Feign中使用Java 8时间日期API(LocalDate等)的序列化问题
|
2天前
|
监控 安全 数据挖掘
Email 接口API有哪些?具体分析一下阿里云和AOK的优点
本文介绍了常见的Email接口API,如阿里云邮件推送、AOKSend、SendGrid、Mailgun和Amazon SES。阿里云API以其高稳定性和数据分析功能脱颖而出,支持批量发送和多语言;而AOKSend API以易于集成、高安全性和优秀客户支持为亮点。企业在选择时应考虑自身需求和预算,以优化邮件营销效果。
|
2天前
|
定位技术 API
Angular 调用导入百度地图API接口,2024春招BAT面试真题详解
Angular 调用导入百度地图API接口,2024春招BAT面试真题详解
|
3天前
|
JSON 安全 API
解锁淘宝商品评论API接口:电商数据分析的新视角
淘宝商品评论API接口是淘宝开放平台提供的一组API接口,允许开发者通过编程方式获取淘宝商品评论数据。这些接口可以获取到商品的详细信息、用户评论、评分等数据,为电商数据分析提供了丰富的素材。
|
3天前
|
缓存 负载均衡 安全
探索API接口开发(定制与开发接口)
在当今数字化、互联互通的时代,API(应用程序编程接口)已经成为连接不同软件、服务和应用的关键桥梁。API接口开发,作为软件架构和系统设计的重要组成部分,不仅影响着数据交换的效率,更决定了整个系统的灵活性和可扩展性。本文将深入探讨API接口开发的各个方面,包括其重要性、开发流程、最佳实践以及面临的挑战。
|
3天前
|
文字识别 API 开发工具
印刷文字识别产品使用合集之API接口无法调用如何解决
印刷文字识别(Optical Character Recognition, OCR)技术能够将图片、扫描文档或 PDF 中的印刷文字转化为可编辑和可搜索的数据。这项技术广泛应用于多个领域,以提高工作效率、促进信息数字化。以下是一些印刷文字识别产品使用的典型场景合集。
25 6
|
4天前
|
监控 供应链 数据挖掘
抖音电商新篇章:douyin.item_get API接口的深度应用
douyin.item_get接口最基本的应用就是获取商品的详细信息。商家可以通过输入商品的ID或链接,获取商品的标题、价格、图片、描述、规格等关键信息。这些信息对于商家来说至关重要,可以帮助他们了解商品的销售情况、竞争态势以及市场需求。
|
4天前
|
安全 API 开发者
智能体-Agent能力升级!新增Assistant API & Tools API服务接口
ModelScope-Agent是一个交互式创作空间,它支持LLM(Language Model)的扩展能力,例如工具调用(function calling)和知识检索(knowledge retrieval)。它已经对相关接口进行了开源,以提供更原子化的应用LLM能力。用户可以通过Modelscope-Agent上的不同代理(agent),结合自定义的LLM配置和消息,调用这些能力。

热门文章

最新文章