SpringCloud教程 | 第三篇: 服务消费者(Feign)(Finchley版本)
上一篇文章,讲述了如何通过resttemplate+ribbon去消费服务,这篇文章主要讲述如何通过feign去消费服务。
一、feign简介
feign是一个声明式的伪http客户端,它使得写http客户端变得更简单。使用feign,只需要创建一个接口并注解。它具有可插拔的注解特性,可使用feign 注解和jax-rs注解。feign支持可插拔的编码器和解码器。feign默认集成了ribbon,并和eureka结合,默认实现了负载均衡的效果。
简而言之:
- feign 采用的是基于接口的注解
- feign 整合了ribbon,具有负载均衡的能力
- 整合了hystrix,具有熔断的能力
二、准备工作
继续用上一节的工程, 启动eureka-server,端口为8761; 启动service-hi 两次,端口分别为8762 、8773.
三、创建一个feign的服务
新建一个spring-boot工程,取名为serice-feign,在它的pom文件引入feign的起步依赖spring-cloud-starter-feign、eureka的起步依赖spring-cloud-starter-netflix-eureka-client、web的起步依赖spring-boot-starter-web,代码如下:
<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.forezp</groupid> <artifactid>service-feign</artifactid> <version>0.0.1-snapshot</version> <packaging>jar</packaging> <name>service-feign</name> <description>demo project for spring boot</description> <parent> <groupid>com.forezp</groupid> <artifactid>sc-f-chapter3</artifactid> <version>0.0.1-snapshot</version> </parent> <dependencies> <dependency> <groupid>org.springframework.cloud</groupid> <artifactid>spring-cloud-starter-netflix-eureka-client</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-openfeign</artifactid> </dependency> </dependencies> </project>
在工程的配置文件application.yml文件,指定程序名为service-feign,端口号为8765,服务注册地址为 ,代码如下:
eureka: client: serviceurl: defaultzone: http://localhost:8761/eureka/ server: port: 8765 spring: application: name: service-feign
在程序的启动类servicefeignapplication ,加上@enablefeignclients注解开启feign的功能:
@springbootapplication @enableeurekaclient @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); }
在web层的controller层,对外暴露一个”/hi”的api接口,通过上面定义的feign客户端schedualservicehi 来消费服务。代码如下:
@restcontroller public class hicontroller { //编译器报错,无视。 因为这个bean是在程序启动的时候注入的,编译器感知不到,所以报错。 @autowired schedualservicehi schedualservicehi; @getmapping(value = "/hi") public string sayhi(@requestparam string name) { return schedualservicehi.sayhifromclientone( name ); } }
启动程序,多次访问,浏览器交替显示:
hi forezp,i am from port:8762
hi forezp,i am from port:8763
feign源码解析:
本文源码下载:
https://github.com/forezp/springcloudlearning/tree/master/sc-f-chapter3
五、参考资料
本文参考了以下:
http://cloud.spring.io/spring-cloud-static/finchley.release/single/spring-cloud.html