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
@SpringCloudApplication
public 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：

@RestController
public 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：

@Component
public 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的逻辑里，这就完成了自动降级。