那天晚上和@FeignClient注解的深度交流

那晚，我和@FeignClient注解的深度交流了一次，爽！

主要还是在技术群里看到有同学在问相关问题，比如: contextId是干嘛的？name相同的多个Client会报错？

然后觉得有必要写篇文章聊聊@FeignClient的使用，百忙之中抽时间，写篇文章不容易啊，记得点赞。

正式篇 Feign基本介绍

首先来个基本的普及，怕有些同学还没接触过Spring Cloud。Feign是Netflix开源的一个REST客户端，通过定义接口，使用注解的方式描述接口的信息，就可以发起接口调用。

GitHub地址：https://github.com/OpenFeign/feign

下面是GitHub主页上给的一个最基本的使用示列，示列中采用Feign调用GitHub的接口。

interface GitHub { @RequestLine("GET /repos/{owner}/{repo}/contributors") List<Contributor> contributors(@Param("owner") String owner, @Param("repo") String repo); @RequestLine("POST /repos/{owner}/{repo}/issues") void createIssue(Issue issue, @Param("owner") String owner, @Param("repo") String repo); } public static class Contributor { String login; int contributions; } public static class Issue { String title; String body; List<String> assignees; int milestone; List<String> labels; } public class MyApp { public static void main(String... args) { GitHub github = Feign.builder() .decoder(new GsonDecoder()) .target(GitHub.class, "https://api.github.com"); // Fetch and print a list of the contributors to this library. List<Contributor> contributors = github.contributors("OpenFeign", "feign"); for (Contributor contributor : contributors) { System.out.println(contributor.login + " (" + contributor.contributions + ")"); } } } Spring Cloud OpenFeign介绍

Spring Cloud OpenFeign是Spring Cloud团队将原生的Feign结合到Spring Cloud中的产物。从上面原生Feign的使用示列来看，用的注解都是Feign中自带的，但我们在开发中基本上都是基于Spring MVC的注解，不是很方便调用。所以Spring Cloud OpenFeign扩展了对Spring MVC注解的支持，同时还整合了Ribbon和Eureka来提供均衡负载的HTTP客户端实现。

GitHub地址：https://github.com/spring-cloud/spring-cloud-openfeign

官方提供的使用示列：

@FeignClient("stores") public interface StoreClient { @RequestMapping(method = RequestMethod.GET, value = "/stores") List<Store> getStores(); @RequestMapping(method = RequestMethod.POST, value = "/stores/{storeId}", consumes = "application/json") Store update(@PathVariable("storeId") Long storeId, Store store); } FeignClient注解的使用介绍 value, name

value和name的作用一样，如果没有配置url那么配置的值将作为服务名称，用于服务发现。反之只是一个名称。

serviceId

serviceId已经废弃了，直接使用name即可。

contextId

比如我们有个user服务，但user服务中有很多个接口，我们不想将所有的调用接口都定义在一个类中，比如：

Client 1

@FeignClient(name = "optimization-user") public interface UserRemoteClient { @GetMapping("/user/get") public User getUser(@RequestParam("id") int id); }

Client 2

@FeignClient(name = "optimization-user") public interface UserRemoteClient2 { @GetMapping("/user2/get") public User getUser(@RequestParam("id") int id); }

这种情况下启动就会报错了，因为Bean的名称冲突了，具体错误如下：

Description: The bean 'optimization-user.FeignClientSpecification', defined in null, could not be registered. A bean with that name has already been defined in null and overriding is disabled. Action: Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true

解决方案可以增加下面的配置，作用是允许出现beanName一样的BeanDefinition。

spring.main.allow-bean-definition-overriding=true

另一种解决方案就是为每个Client手动指定不同的contextId，这样就不会冲突了。

上面给出了Bean名称冲突后的解决方案，下面来分析下contextId在Feign Client的作用，在注册Feign Client Configuration的时候需要一个名称，名称是通过getClientName方法获取的：

String name = getClientName(attributes); registerClientConfiguration(registry, name, attributes.get("configuration")); private String getClientName(Map<String, Object> client) {     if (client == null) {       return null;     }     String value = (String) client.get("contextId");     if (!StringUtils.hasText(value)) {       value = (String) client.get("value");     }     if (!StringUtils.hasText(value)) {       value = (String) client.get("name");     }     if (!StringUtils.hasText(value)) {       value = (String) client.get("serviceId");     }     if (StringUtils.hasText(value)) {       return value;     }     throw new IllegalStateException("Either 'name' or 'value' must be provided in @"         + FeignClient.class.getSimpleName());   }