【Spring Cloud】Feign 服务调用

前言

Feign是一个声明式Web Service客户端，使得编写Web服务客户端变得非常容易，只需要创建一个接口，然后在接口上面添加注解即可。基于上一篇文章【Spring Cloud】Ribbon 客户端的负载均衡继续延伸。

（Web Service是建立可互操作的分布式应用程序的新平台，基于HTTP协议，暴露一个可以通过Web调用的API）

Feign能做什么

1.Ribbon+RestTemplate的进一步封装

Feign使编写Java Http客户端变得更加容易，前面的文章，我们在使用Ribbon+RestTemplate时，利用RestTemplate对http请求的封装处理，形成了一套模板化的调用方法。

由于对服务依赖的调用不止一处，往往一个接口会被多处调用，所以通常会针对每个微服务自行封装一些客户端类来包装这些依赖服务的调用。

所以Feign在此基础上做了进一步封装，由Feign来定义和实现依赖服务接口的定义。

2.具体实现

创建一个接口并使用注解的方式配置它（以前是Dao接口上标注Mapper注解，现在是一个微服务接口上标注一个Feign注解即可），即可完成对服务提供方的接口绑定，简化了使用Spring Cloud Ribbon时，自动封装服务调用客户端的开发量。

构建Feign工程

一、API层创建服务接口 microservicecloud-api---DeptClientService

microservicecloud-api模块是之前在写Eureka Provider和Eureka Consumer 模块服务时，添加的一个模块，主要是存放公共的Entity实体，现在将再添加一个service接口层，存放Eureka Provider对外暴露的接口。

1.api模块的pom.xml引入依赖

    <dependencies><!-- 当前Module需要用到的jar包，按自己需求添加，如果父类已经包含了，可以不用写版本号 -->
		<dependency> <!--entity层用到的注解-->
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
		</dependency>
		<dependency> <!--Feign组件的注解-->
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-feign</artifactId>
		</dependency>
	</dependencies>

2. 创建service层的接口DeptClientService

添加注解@FeignClient（value属性值是Eureka Server注册表上服务提供者的applicationName）

@FeignClient(value = "MICROSERVICECLOUD-DEPT")
public interface DeptClientService
{
	@RequestMapping(value = "/dept/get/{id}", method = RequestMethod.GET)
	public Dept get(@PathVariable("id") long id);

	@RequestMapping(value = "/dept/list", method = RequestMethod.GET)
	public List<Dept> list();

	@RequestMapping(value = "/dept/add", method = RequestMethod.POST)
	public boolean add(Dept dept);
}

二、创建消费者模块--microservicecloud-consumer-dept-feign

这个模块与之前的消费者模块配置基本类似，Eureka、Ribbon组件依旧保留之前的配置
1.引入依赖

<dependency><!-- 自己定义的api -->
	<groupId>com.atguigu.springcloud</groupId>
	<artifactId>microservicecloud-api</artifactId>
	<version>${project.version}</version>
</dependency>
<dependency>
	<groupId>org.springframework.cloud</groupId>
	<artifactId>spring-cloud-starter-feign</artifactId>
</dependency>

2. controller层添加API层的service--DeptClientService

@RestController
public class DeptController_Consumer
{
	@Autowired
	private DeptClientService service;

	@RequestMapping(value = "/consumer/dept/get/{id}")
	public Dept get(@PathVariable("id") Long id)
	{
		return this.service.get(id);
	}

	@RequestMapping(value = "/consumer/dept/list")
	public List<Dept> list()
	{
		return this.service.list();
	}

	@RequestMapping(value = "/consumer/dept/add")
	public Object add(Dept dept)
	{
		return this.service.add(dept);
	}
}

3.启动类添加注解

@EnableFeignClients

@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
@ComponentScan("com.atguigu.springcloud")
public class DeptConsumer80_Feign_App
{
	public static void main(String[] args)
	{
		SpringApplication.run(DeptConsumer80_Feign_App.class, args);
	}
}

小结

Feign通过接口的方法调用Rest服务（之前是Ribbon+RestTemplate），该请求发送给Eureka服务器（http://MICROSERVICECLOUD-DEPT/dept/list），通过Feign直接找到服务接口，由于在进行服务调用的时候融合了Ribbon技术，所以也支持负载均衡。

感谢您的访问！