springboot中如何使用openfeign进行接口调用

更新时间：2023年07月14日 16:41:56 作者：唱跑雨淋淋

这篇文章主要介绍了springboot中如何使用openfeign进行接口调用问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教

在项目开发过程中，我们开发的项目或多或少都会与其他交互的系统进行对接集成，或者是微服务项目之间进行调用，双方相互调用接口来获取或者传递数据，以往我们使用的方式可能有 httpClient、okhttp、httpUrlConnection 等等，来学习一下如何使用 openfeign 来进行调用。

一、feign 和 openfeign ?

Feign 是 Springcloud 组件中的一个轻量级 Restful 的 HTTP 服务客户端，Feign 内置了 Ribbon，用来做客户端负载均衡，去调用服务注册中心的服务。

Feign 的使用方式是：使用Feign的注解定义接口，调用这个接口，就可以调用服务注册中心的服务。

OpenFeign 是 springcloud 在Feign的基础上支持了 SpringMVC 的注解，如 @RequestMapping 等等。

OpenFeign 的 @FeignClient 可以解析 SpringMVC 的 @RequestMapping 注解下的接口，并通过动态代理的方式产生实现类，实现类中做负载均衡并调用其他服务。

二、为什么要使用 openfeign ?

1、Feign 本身不支持 Spring MVC 的注解，它有一套自己的注解

2、Fegin 是 Netflix 公司产品，停止更新了。

3、使用 OpenFeign 可以简化项目之间接口的调用，我们不需要关心 http 调用的代码

三、创建一个简单的服务提供方

创建一个基本的 springboot 项目

1、引入基础依赖

<dependencies>
		<dependency>
			<groupId> org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

2、application.yml 配置文件

server:
  port: 8081

3、创建一个 controller

@RestController
@RequestMapping("/demo")
public class FeignDemoController {
    @GetMapping("/test")
    public String test(){
        return "hello openfegin";
    }
}

4、启动服务

四、服务调用方 openfeign 调用服务提供方

创建一个基本的 springboot 项目

1、引入相关依赖

这里要注意springboot 和 springCloud 版本

当前 springboot 版本 2.3.4.RELEASE

springcloud 版本 Hoxton.SR4

<properties>
		<java.version>1.8</java.version>
		<spring.cloud-version>Hoxton.SR4</spring.cloud-version>
	</properties>
	<dependencies>
		<dependency>
			<groupId> org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-openfeign</artifactId>
		</dependency>
	</dependencies>
	<dependencyManagement>
		<dependencies>
			<dependency>
				<groupId>org.springframework.cloud</groupId>
				<artifactId>spring-cloud-dependencies</artifactId>
				<version>${spring.cloud-version}</version>
				<type>pom</type>
				<scope>import</scope>
			</dependency>
		</dependencies>
	</dependencyManagement>

2、启动类中增加注解

开启 feign 功能

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

3、编写客户端调用接口

@FeignClient 标注该类是一个feign接口

name：因为这里并未进行服务注册，所以就随便命名一个
url：被调用的服务提供方的接口地址

@FeignClient(name = "demo",url = "http://localhost:8081/demo")
public interface FeginDemo {
    @GetMapping("test") //被调用接口的请求类型
    String test();
}

4、测试调用服务端提供端接口

@RestController
@RequestMapping("/feginDemo")
public class FeginDemoController {
    @Autowired
    FeginDemo feginDemo;
    @GetMapping("/test")
    public String test(){
        String test = feginDemo.test();
        return test;
    }
}

5、测试

启动项目，访问 http://localhost:8080/feginDemo/test

接口调用成功！

那么这里呢，我们就实现了通过 openfeign 完成一次简单的接口调用，如果没有使用 openfeign 这里的调用我们就只能通过 httpclient、okhttp 等方式来调用了，使用了 openfeign 之后，你会发现，调用别人的接口竟是如此简单。

五、openfeign 服务熔断

在调用接口过程中，由于是调用别人接口，肯定会存在一些意外因素，比如被调用的服务提供方系统宕机了，访问不到了等情况，如下比如我停止被调用的服务提供方，再去进行调用

那么这个时候我们就需要用到服务熔断了，在对方服务异常的时候，返回这个信息肯定不太友好，我们来让它稍微友好一些

openfeign 中默认集成了 Hystrix

1、在 application.yml 配置文件中开启

feign:
  hystrix:
    enabled: true

2、配置 fallback 的处理类

创建一个类，实现我们的 FeginDemo ，然后实现接口中的方法，进行重写

@Component
public class ErrorMessage implements FeginDemo {
    @Override
    public String test() {
        return "服务器开小差了哦，请稍后再试";
    }
}

3、改造 feignClient

fallback：配置刚才的实现类 ErrorMessage

@FeignClient(name = "demo",url = "http://localhost:8081/demo",fallback = ErrorMessage.class)
public interface FeginDemo {
    @GetMapping("test")
    String test();
}

4、测试熔断效果

重新启动一下服务再进行访问

对于用户来说，这样是不是更加友好一点了呢？总比你一连串的英文往人家脸上呼来的好吧

六、配置日志

1、配置项目日志级别

logging:  level:    com.wxw.openfeign: debuglogging:
  level:
    com.wxw.openfeign: debug

2、配置 openfeign 日志级别

@Configuration
public class FeignLogConfiguration {
//    NONE：不记录任何日志信息，这是默认值。
//    BASIC：仅记录请求的方法，URL以及响应状态码和执行时间
//    HEADERS：在BASIC的基础上，额外记录了请求和响应的头信息
//    FULL：记录所有请求和响应的明细，包括头信息、请求体、元数据
    @Bean
    Logger.Level feignLoggerLevel(){
        return Logger.Level.FULL;
    }
}

3、配置日志类

@FeignClient(name = "demo",url = "http://localhost:8081/demo",
fallback = ErrorMessage.class,configuration = FeignLogConfiguration.class)
public interface FeginDemo {
    @GetMapping("test")
    String test();
}

4、调用之后查看日志

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

SpringBoot整合EasyExcel实现批量导入导出
这篇文章主要为大家详细介绍了SpringBoot整合EasyExcel实现批量导入导出功能的相关知识,文中的示例代码讲解详细,需要的小伙伴可以参考下
2024-03-03
Spring Boot整合mybatis并自动生成mapper和实体实例解析
本文是小编给大家总结的关于Spring Boot整合mybatis并自动生成mapper和实体的内容，非常不错，具有一定的参考借鉴价值，需要的朋友参考下吧
2018-05-05
idea全局设置Maven配置的实现步骤
本文主要介绍了idea全局设置Maven配置，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07
手把手教学Win10同时安装两个版本的JDK并随时切换(JDK8和JDK11)
最近在学习JDK11的一些新特性,但是日常使用基本上都是基于JDK8,因此,需要在win环境下安装多个版本的JDK,下面这篇文章主要给大家介绍了手把手教学Win10同时安装两个版本的JDK(JDK8和JDK11)并随时切换的相关资料,需要的朋友可以参考下
2023-03-03
Java 定时器（Timer,TimerTask）详解及实例代码
这篇文章主要介绍了 Java 定时器（Timer,TimerTask）详解及实例代码的相关资料,需要的朋友可以参考下
2017-01-01
对Java ArrayList的自动扩容机制示例讲解
今天小编就为大家分享一篇对Java ArrayList的自动扩容机制示例讲解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-10-10
2022最新Java泛型详解(360度无死角介绍)
Java泛型（generics）是JDK5中引入的一个新特性，泛型提供了编译时类型安全监测机制，该机制允许我们在编译时检测到非法的类型数据结构,这篇文章主要介绍了java泛型的基本概念及使用详解，感兴趣的朋友跟随小编一起看看吧
2022-10-10
企业级Kubernetes管理平台Wayne功能特性介绍
这篇文章主要为大家介绍了企业级Kubernetes管理平台Wayne的功能特性及架构设计，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步
2022-02-02
SpringBoot2.0整合tk.mybatis异常解决
本文主要介绍了SpringBoot2.0整合tk.mybatis异常，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-12-12
Spring Cloud oauth2 认证服务搭建过程示例
这篇文章主要为大家介绍了Spring Cloud oauth2 认证服务搭建过程示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06