上一篇文章,讲述了如何通过 RestTemplate+Ribbon 去消费服务,这篇文章主要讲述如何通过Feign去消费服务。
1.Feign简介
Feign是一个声明式的伪Http客户端,它使得写Http客户端变得更简单。使用Feign,只需要创建一个接口并注解。它具有可插拔的注解特性,可使用Feign 注解和JAX-RS注解。Feign支持可插拔的编码器和解码器。Feign默认集成了Ribbon,并和Eureka结合,默认实现了负载均衡的效果。
简而言之:
- Feign 采用的是基于接口的注解
- Feign 整合了ribbon
2.准备工作
继续用上一节的工程, 启动eureka-server,端口为8761。启动 service-hi 两次,端口分别为 8762 、8763。
3.建一个feign的服务
新建一个spring-boot工程,取名为 serice-feign,在它的pom文件引入Feign的起步依赖spring-cloud-starter-feign、Eureka的起步依赖spring-cloud-starter-eureka、Web的起步依赖spring-boot-starter-web,代码如下:
4.0.0
org.springframework.boot
spring-boot-starter-parent
1.5.3.RELEASE
com.example
service-feign
0.0.1-SNAPSHOT
service-feign
Demo project for Spring Boot
1.8
Dalston.SR1
org.springframework.cloud
spring-cloud-starter-eureka
org.springframework.cloud
spring-cloud-starter-feign
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
org.springframework.cloud
spring-cloud-dependencies
${spring-cloud.version}
pom
import
org.springframework.boot
spring-boot-maven-plugin
在工程的配置文件 application.yml 文件,指定程序名为 service-feign,端口号为8765,服务注册地址为http://localhost:8761/eureka/ ,代码如下:
eureka:
client:
serviceUrl:
defaultZone: http://localhost:8761/eureka/
server:
port: 8765
spring:
application:
name: service-feign
在程序的启动类 ServiceFeignApplication,加上 @EnableFeignClients 注解开启Feign的功能.
@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class ServiceFeignApplication {
public static void main(String[] args) {
SpringApplication.run(ServiceFeignApplication.class, args);
}
}
定义一个 feign 接口,通过 @FeignClient(“服务名”),来指定调用哪个服务。比如在代码中调用了 service-hi 服务的“/hi”接口,代码如下:
@FeignClient(value = "service-hi")
public interface SchedualServiceHi {
@RequestMapping(value = "/hi",method = RequestMethod.GET)
String sayHiFromClientOne(@RequestParam(value = "name") String name);//@RequestParam注解必须写
}
在Web层的controller层,对外暴露一个”/hi”的API接口,通过上面定义的Feign客户端SchedualServiceHi 来消费服务。代码如下:
@RestController
public class HiController {
@Autowired
SchedualServiceHi schedualServiceHi;
@RequestMapping(value = "/hi",method = RequestMethod.GET)
public String sayHi(@RequestParam String name){
return schedualServiceHi.sayHiFromClientOne(name);
}
}
启动程序,多次访问http://localhost:8765/hi?name=forezp,浏览器交替显示:
hi forezp,i am from port:8762
hi forezp,i am from port:8763
4.Feign的源码实现过程
总的来说,Feign 的源码实现过程如下。
- 首先通过 @EnableFeignClients 注解开启 FeignClient 的功能。只有这个注解存在,才会在程序启动时开启 @FeignClient 注解的包扫描。
- 根据Feign的规则实现接口,并在接口上面加上 @FeignClient 注解。
- 程序启动后,会进行包扫描,扫描所有的@FeignClient 的注解的类,并将这些信息注入 IOC容器中。
- 当接口的方法被调用时,通过JDK的代理来生成具体的 RequestTemplate 模板对象。
- 根据 RequestTemplate 再生成 Http 请求的 Request 对象。
- Request 对象交给 Client 去处理,其中 Client 的网络请求框架可以是 HTTPURLConnection、HttpClient 和 OkHttp。
- 最后Client被封装到LoadBalanceClient类,这个类结合类 Ribbon 做到了负载均衡。
关于@FeignClient注解参考 FeignClient注解及性能优化注意事项
参考方志朋《深入理解Spring Cloud与微服务构建》