公众号「架构成长指南」，专注于生产实践、云原生、分布式系统、大数据技术分享。

前言

在前几个教程中我们已经看到：

使用 RestTemplate 的 Spring Boot 微服务通信示例

使用 WebClient 的 Spring Boot 微服务通信示例

在本教程中，我们将学习如何使用 Spring Cloud Open Feign库在多个微服务之间进行 REST API 调用（同步通信）。

Spring Cloud Open Feign 概述

Feign通过可插拔的注解支持（包括Feign注解和JAX-RS注解）使编写Web服务客户端变得更加容易。此外，Spring Cloud还添加了对Spring MVC注解的支持，并使用与Spring Web中使用的相同的HttpMessageConverters。

使用Feign的一个很大的优点是，我们除了接口定义之外，不需要编写任何调用服务的代码。

例如

package io.wz.userservice.service;

import io.wz.userservice.dto.DepartmentDto;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

@FeignClient(value = "DEPARTMENT-SERVICE", url = "http://localhost:8080")
public interface APIClient {
    @GetMapping(value = "/api/departments/{id}")
    DepartmentDto getDepartmentById(@PathVariable("id") String departmentId);
}

我们将构建什么？

下面将创建两个微服务，例如部门服务 和 用户服务，并且我们将使用 Spring Cloud Open Feign从用户服务到部门服务 进行 REST API 调用，以获取特定的用户部门。

基础配置

参考以下教程创建部门服务和用户服务微服务：
使用 RestTemplate 的 Spring Boot 微服务通信示例。

第一步：将Spring cloud open feign Maven依赖添加到User-Service中

打开 user-service项目的 pom.xml文件并添加以下依赖项：

	
		
			
				org.springframework.cloud
				spring-cloud-dependencies
				${spring-cloud.version}
				pom
				import
			
		
	



			org.springframework.cloud
			spring-cloud-starter-openfeign

这是添加Spring cloud open feign依赖后的完整pom.xml文件：



	4.0.0
	
		org.springframework.boot
		spring-boot-starter-parent
		2.7.17
		 
	
	io.wz
	user-service
	0.0.1-SNAPSHOT
	user-service
	user-service
	
		1.8
		2021.0.4
	
	
		
			
				org.springframework.cloud
				spring-cloud-dependencies
				${spring-cloud.version}
				pom
				import
			
		
	
	
		
			org.springframework.boot
			spri服务器托管网ng-boot-starter-data-jpa
		
		
			org.springframework.boot
			spring-boot-starter-web
		
		
			org.springframework.cloud
			spring-cloud-starter-openfeign
		
		
			com.mysql
			mysql-connector-j
			runtime
		
		
			org.projectlombok
			lombok
			true
		
		
			org.springframework.boot
			spring-boot-starter-test
			test
		
	
	
		
			
				org.springframework.boot
				spring-boot-maven-plugin
				
					
						
							org.projectlombok
							lombok

第2步：使用@EnableFeignClients启用Feign Client

package io.wz.userservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableFeignClients
public class UserServiceApplication {

	public static void main(String[] args) {
		SpringApplication.run(UserServiceApplication.class, args);
	}
}

请注意，@EnableFeignClients 注解启用组件扫描声明它们是 Feign 客户端的接口。

第3步：创建feign API客户端

让我们创建一个名为 APIClient的接口并添加以下代码：

package io.wz.userservice.service;

import io.wz.userservice.dto.DepartmentDto;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

@FeignClient(value = "DEPARTMENT-SERVICE", url = "http://localhost:8080")
public interface APIClient {
    @GetMapping(value = "/api/departments/{id}")
    DepartmentDto getDepartm服务器托管网entById(@PathVariable("id") String departmentId);
}

我们使用@FeignClient注解声明一个Feign客户端

@FeignClient(value = "DEPARTMENT-SERVICE")

@FeignClient注解中传递的 value 参数是强制的，而使用 URL 参数时，我们指定了 API的URL。

@FeignClient(value = "DEPARTMENT-SERVICE", url = "http://localhost:8080")

此外，由于该接口是 Feign 客户端，因此我们可以使用 Spring Web注解来声明我们想要访问的 API。

第4步：更改getUser方法以调用APIClient

首先注入 APIClient 然后使用它：

  DepartmentDto departmentDto = apiClient.getDepartmentById(user.getDepartmentId());

下面是使用Feign客户端的UserServiceImpl的完整代码，供大家参考：

package io.wz.userservice.service.impl;

import lombok.AllArgsConstructor;
import io.wz.userservice.dto.DepartmentDto;
 import io.wz.userservice.dto.ResponseDto;
 import io.wz.userservice.dto.UserDto;
 import io.wz.userservice.entity.User;
 import io.wz.userservice.repository.UserRepository;
 import io.wz.userservice.service.APIClient;
 import io.wz.userservice.service.UserService;
import org.springframework.stereotype.Service;

@Service
@AllArgsConstructor
public class UserServiceImpl implements UserService {

    private UserRepository userRepository;

    private APIClient apiClient;

    @Override
    public User saveUser(User user) {
        return userRepository.save(user);
    }

    @Override
    public ResponseDto getUser(Long userId) {

        ResponseDto responseDto = new ResponseDto();
        User user = userRepository.findById(userId).get();
        UserDto userDto = mapToUser(user);

        DepartmentDto departmentDto = apiClient.getDepartmentById(user.getDepartmentId());
        responseDto.setUser(userDto);
        responseDto.setDepartment(departmentDto);

        return responseDto;
    }

    private UserDto mapToUser(User user){
        UserDto userDto = new UserDto();
        userDto.setId(user.getId());
        userDto.setFirstName(user.getFirstName());
        userDto.setLastName(user.getLastName());
        userDto.setEmail(user.getEmail());
        return userDto;
    }
}

现在运行两个微服务并进行测试。

测试：启动两个微服务

首先启动部门服务项目，然后启动用户服务项目。
一旦两个项目都启动并在不同的端口上运行。接下来，我们调用 Get User REST API 来测试 user-service REST API 对Department-service 的调用。

获取用户 REST API：

请注意，响应结果包含用户的部门。这表明我们已成功使用APIClient从用户服务到部门服务进行 REST API 调用。

结论

在本教程中，我们学习了如何使用 Spring Cloud Open Feign在多个微服务之间进行 REST API 调用（同步通信）。

源码下载：github gitee

服务器托管，北京服务器托管，服务器租用 http://www.fwqtg.net
机房租用，北京机房租用，IDC机房托管， http://www.fwqtg.net

微服务系列-Spring Boot使用Open Feign 微服务通信示例

前言