上篇讲了如何使用Ribbon+RestTemplate服务消费者,现在来谈下如何通过Feign
去消费服务。
Feign
是一个声明式的伪Http
客户端,它使得写Http
客户端变得更简单。
使用Feign
,只需要创建一个接口并注解,它具有可插拔的注解特性,可使用Feign
注解和JAX-RS
注解,Feign
支持可插拔的编码器和解码器,Feign
默认集成了Ribbon
,并和Eureka
结合,默认实现了负载均衡的效果。
Feign
具有如下特性:
- 可插拔的注解支持,包括
Feign
注解和JAX-RS
注解 - 支持可插拔的
HTTP
编码器和解码器 - 支持
Hystrix
和它的Fallback
- 支持
Ribbon
的负载均衡 - 支持
HTTP
请求和响应的压缩Feign
是一个声明式的Web Service
客户端,它的目的就是让Web Service
调用更加简单。它整合了Ribbon
和Hystrix
,从而不再需要显式地使用这两个组件。Feign
还提供了HTTP
请求的模板,通过编写简单的接口和注解,就可以定义好HTTP
请求的参数、格式、地址等信息。接下来,Feign
会完全代理HTTP
的请求,我们只需要像调用方法一样调用它就可以完成服务请求。
简而言之:Feign
能干Ribbon
和Hystrix
的事情,但是要用Ribbon
和Hystrix
自带的注解必须要引入相应的jar
包才可以。
简单搭建步骤如下:
1.修改spring-cloud-eureka-provider-a,spring-cloud-eureka-provider-b,spring-cloud-eureka-provider-c服务名统一为eureka-provider,注意:1、2步骤是为了模拟负载均衡部署多节点
2.修改三个服务提供者的请求统一为"/"
3.新建spring-cloud-feign-consumer项目,pom必须引入spring-cloud-starter-openfeign依赖
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>spring-cloud-feign-consumer</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>spring-cloud-feign-consumer</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.0.3.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<spring-cloud.version>Finchley.RELEASE</spring-cloud.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</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>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
4.在工程的启动类中使用@EnableFeignClients开启Feign服务
package com.example.eureka.feign.consumer;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;
/**
* @EnableFeignClients:开启Feign的功能
*
* @author fangxc
* @data 2018年7月31日 上午9:19:37
* @version 1.0.0
*
*/
@EnableFeignClients
@EnableDiscoveryClient
@SpringBootApplication
public class SpringCloudFeignConsumerApplication {
public static void main(String[] args) {
SpringApplication.run(SpringCloudFeignConsumerApplication.class, args);
System.out.println("feign-consumer service has started!");
}
}
5.定义调用服务的接口,通过@FeignClient("服务名")
,来指定调用哪个服务。
比如在代码中调用了eureka-provider
服务的 "/"
接口,"/" 就是调用服务提供者项目:spring-cloud-eureka-provider-a
的 serverA()
方法,spring-cloud-eureka-provider-b
的 serverB()
方法,spring-cloud-eureka-provider-c
的 serverC()
方法,代码如下:
package com.example.eureka.feign.consumer;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
/**
* 指定这个接口所要调用的 提供者服务名称 "eureka-provider"
* @author fangxc
*
*/
@FeignClient("eureka-provider")
public interface HomeClient {
@GetMapping("/")
String consumer();
}
6.消费方法
package com.example.eureka.feign.consumer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ConsumerController {
@Autowired
private HomeClient homeClient;
@GetMapping(value = "/hello")
public String hello() {
return homeClient.consumer();
}
}
7.添加配置
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8761/eureka/
spring:
application:
name: feign-consumer
server:
port: 9000
8.依次开启spring-cloud-eureka-service,spring-cloud-eureka-provider-a,spring-cloud-eureka-provider-b,spring-cloud-eureka-provider-c,spring-cloud-feign-consumer
9.浏览器输入http://localhost:9000/hello,返回结果在spring-cloud-eureka-provider-a:10001,spring-cloud-eureka-provider-b:10002,spring-cloud-eureka-provider-c:10003之中选择,说明每次请求会按照feign规则进行分发给三个同服务名应用达到负载均衡功能