Spring Cloud之Feign入门

原文链接：http://www.dubby.cn/detail.html?id=9008

Spring Cloud Eureka,Spring Cloud Ribbon,Spring Cloud Hystrix和Spring Cloud Feign都是Spring Cloud对Netflix OSS的封装，为了简便，下文中把Spring Cloud Feign直接称呼为Feign，Hystrix,Ribbon和Eureka也是如此。

为什么需要Feign

服务熔断

之前已经介绍了如何使用Eureka和Ribbon建立骑一个基本的Spring Cloud项目了，那么为什么还需要Feign呢？

如果你对熔断有过了解，那么应该知道Hystrix吧，这是Netflix OSS家族中使用比较广泛的一个组件。目的就是为了容忍系统中可能出现问题的调用，常见的有RPC调用，第三方lib等。在分布式系统下下，服务熔断可以避免错误蔓延，甚至产生雪崩；而且还提供了一定程度的自我恢复的能力。

RPC和熔断的关系

在实践过程中，往往RPC调用的地方就一定要伴随着熔断（甚至降级），因为RPC的不稳定性很高。我们当然也可以单独的进行RPC和熔断降级，不过我们可以选择把他们放到一起来处理，这就是Feign的出现的意义之一。

RESTful调用和RPC

习惯了Dubbo（阿里开源的服务治理框架，而且最近阿里重新开始维护），Pigeon（美团点评的服务治理框架，内部在使用，而且也开源了）的人都会知道RPC的好处，通过框架的简单封装，再由Spring托管一下Bean，代码层面甚至不知道自己调用的是本地的代码，还是远程的服务，这不仅可以提高代码编写效率，还减小了开发的难度。

说实话，Ribbon使用的是RestTemplate，已经比HttpClient好用很多了，但是，还是需要自己拼参数，这和拼SQL是同样让人无法忍受的。所以，Feign的出现，是对Ribbon的更高一层的封装，有人称之为（伪）RPC。

尝试使用Fegin

如果你还没有看过《从最简单的Spring Cloud应用开始》，那么你需要先去看一看，并且在本地运行eureka-server和demo-service，这样接下来的示例你才可以正确运行。

搭建项目

先还是创建一个Spring Boot项目，然后添加需要的依赖：

<dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-test</artifactId>            <scope>test</scope>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-eureka-server</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-hystrix</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-ribbon</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-starter-feign</artifactId>        </dependency>    </dependencies>    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.springframework.cloud</groupId>                <artifactId>spring-cloud-dependencies</artifactId>                <version>Brixton.SR5</version>                <type>pom</type>                <scope>import</scope>            </dependency>        </dependencies>    </dependencyManagement>

在你的启动类上修改注解：

@EnableFeignClients@SpringCloudApplicationpublic class DemoApplication {    public static void main(String[] args) {        SpringApplication.run(DemoApplication.class, args);    }}

注：@SpringCloudApplication等价于：

@SpringBootApplication@EnableDiscoveryClient@EnableCircuitBreaker

新建DemoService.java：

@FeignClient(name = "demo-service")public interface DemoService {    @RequestMapping(value = "hello", method = RequestMethod.GET)    String hello();}

这个interface其实就是Feign实现的伪RPC了，你可以在你需要的地方注入就可以了。

比如，新建HelloController.java：

@RestControllerpublic class HelloController {    @Autowired    private DemoService demoService;    @RequestMapping(value = "hello")    public String hello() {        return demoService.hello();    }}

到现在，我们已经用Feign实现了简单的伪RPC调用了。

参数绑定

上面的例子没有使用参数，但是我们知道Restful请求是可以支持比较负责的参数传递的，那么使用Feign怎么做到这些呢？

@FeignClient(name = "demo-service")public interface DemoService {    @RequestMapping(value = "hello", method = RequestMethod.GET)    String hello();    @RequestMapping(value = "hello1", method = RequestMethod.GET)    String hello1(@HeaderParam("name") String name);    @RequestMapping(value = "hello2", method = RequestMethod.GET)    String hello2(@RequestParam("name") String name);    @RequestMapping(value = "hello3", method = RequestMethod.POST)    String hello3(@RequestBody("user") User user);}

当然，你需要响应的更改demo-service的服务实现。

集成Hystrix

还有，怎么自动集成Hystrix呢，这个也非常简单，需要新建一个DemoServiceFallback.java：

@Componentpublic class DemoServiceFallback implements DemoService {    @Override    public String hello() {        return "fallback";    }}

然后更改一下DemoService.java的注解配置：

@FeignClient(name = "demo-service", fallback = DemoServiceFallback.class)

为了测试，你可以启动两个demo-service，一个正常运行，一个在hello方法里sleep一段时间（模拟服务超时），然后在请求feign-consumer的接口，会有50%的概率走到DemoServiceFallback的逻辑里，这就完成了自动降级。