二、

核心注册方法 位于 FeignClientsRegistrar 类中，主要通过以下几个方法完成 Feign 客户端的注册。

实现

privatevoidregisterFeignClient(BeanDefinitionRegistryregistry,AnnotationMetadataannotationMetadata,Map<String,Object>attributes){StringclassName =annotationMetadata.getClassName();BeanDefinitionBuilderdefinition =BeanDefinitionBuilder.genericBeanDefinition(FeignClientFactoryBean.class);validate(attributes);definition.addPropertyValue("name",name);// 依次设置章节1提到的@FeignClient的10个属性…… 		AbstractBeanDefinitionbeanDefinition =definition.getBeanDefinition();beanDefinition.setAttribute(FactoryBean.OBJECT_TYPE_ATTRIBUTE,className);BeanDefinitionHolderholder =newBeanDefinitionHolder(beanDefinition,className,newString[]{alias });BeanDefinitionReaderUtils.registerBeanDefinition(holder,registry);}

4. registerBeanDefinition(holder, registry) 方法

• 作用：将 Bean和创建它的Factory绑定到一起，方便后续生成代理类），在注册过程中，它会进行一系列的检查和处理，比如验证 Bean 定义的有效性、

6. configuration属性:

• 类型: Class<?>[]
• 默认值: { }
• 描述: 自定义配置类，可以覆盖默认的 Feign 配置，例如 Decoder, Encoder, Contract 等。超时等）时，Feign 就会调用 “MyFallback” 这个容错类中的对应方法来返回一个预设的结果，而不是直接抛出异常给调用者，这样就能保证系统的部分功能依然能够正常运行啦，大大提高了系统的容错。
  这种自动化的机制，大大简化了微服务之间的通信，使开发者能够专注于业务逻辑，而无需关心底层的调用细节。如@FeignClient(decode404 = true)，那么当遇到 404 错误时，Feign 就会尝试去解码这个错误，而不是像默认情况那样直接抛出异常给调用者。如@FeignClient(fallbackFactory = MyFallbackFactory.class)，当目标服务出现故障时，“MyFallbackFactory” 这个容错工厂类就会被用来创建合适的容错对象并处理请求，而且通过这个工厂类还能在容错逻辑中获取到导致服务降级的原因（比如异常信息等），以便进行更精细的处理

9. path属性:

• 类型: String
• 默认值: “”
• 描述: 所有方法级别映射的路径前缀，可以与 @RibbonClient 一起使用。举个例子，@FeignClient(qualifier = “myQualifier”)，“myQualifier” 就是我们为这个 Feign 客户端设置的@Qualifier值啦，在一些需要通过@Qualifier来区分不同 Bean 的场景下就会用到它。@EnableFeignClients

@EnableFeignClients 也是 Spring Cloud Feign 的一个注解，用于启用 Feign 客户端。设置自动装配模式等等，以便后续能够正确生成客户端代理类。

publicvoidregisterFeignClients(AnnotationMetadatametadata,BeanDefinitionRegistryregistry){// 存储所有的BeanLinkedHashSet<BeanDefinition>candidateComponents =newLinkedHashSet<>();// EnableFeignClients注解的5Map<String,Object>attrs =metadata				.getAnnotationAttributes(EnableFeignClients.class.getName());// 过滤带有@FeignClient标记的接口AnnotationTypeFilterannotationTypeFilter =newAnnotationTypeFilter(FeignClient.class);finalClass<?>[]clients =attrs ==null?null:(Class<?>[])attrs.get("clients");if(clients ==null||clients.length ==0){ClassPathScanningCandidateComponentProviderscanner =getScanner();scanner.setResourceLoader(this.resourceLoader);scanner.addIncludeFilter(newAnnotationTypeFilter(FeignClient.class));Set<String>basePackages =getBasePackages(metadata);for(StringbasePackage :basePackages){// scanner.findCandidateComponent会获取到所有@FeignClient标准的接口candidateComponents.addAll(scanner.findCandidateComponents(basePackage));}}……		for(BeanDefinitioncandidateComponent :candidateComponents){if(candidateComponent instanceofAnnotatedBeanDefinition){AnnotatedBeanDefinitionbeanDefinition =(AnnotatedBeanDefinition)candidateComponent;AnnotationMetadataannotationMetadata =beanDefinition.getMetadata();// 过滤接口，因为@FeignClient只标准在接口上Assert.isTrue(annotationMetadata.isInterface(),"@FeignClient can only be specified on an interface");Map<String,Object>attributes =annotationMetadata						.getAnnotationAttributes(FeignClient.class.getCanonicalName());Stringname =getClientName(attributes);// 配置绑定registerClientConfiguration(registry,name,attributes.get("configuration"));// 实际的注册方法registerFeignClient(registry,annotationMetadata,attributes);}}}

3. registerFeignClient(BeanDefinitionRegistry registry,
   AnnotationMetadata annotationMetadata, Map<String, Object> attributes)方法

• 作用：这个方法的主要任务就是根据传入的参数信息，将一个标注了@FeignClient注解的接口注册为一个具体的 Bean 定义，包括设置各种属性值、
• 实现

privatevoidregisterDefaultConfiguration(AnnotationMetadatametadata,BeanDefinitionRegistryregistry){Map<String,Object>defaultAttrs =metadata				.getAnnotationAttributes(EnableFeignClients.class.getName(),true);// 键defaultConfiguration不为空的时候，会调用registerClientConfiguration方法把从defaultAttrs中获取到的默认配置信息注册到registryif(defaultAttrs !=null&&defaultAttrs.containsKey("defaultConfiguration")){Stringname;if(metadata.hasEnclosingClass()){name ="default."+metadata.getEnclosingClassName();}else{name ="default."+metadata.getClassName();}registerClientConfiguration(registry,name,defaultAttrs.get("defaultConfiguration"));}}

2. registerFeignClients(AnnotationMetadata metadata, BeanDefinitionRegistry registry)方法

• 作用: 扫描并注册所有标注了 @FeignClient 的接口，生成相应的 Feign 客户端代理类。如@FeignClient(primary = false)，那么这个 Feign 代理就不会被当作主 Bean 来处理，在一些需要区分不同优先级的 Bean 的场景下会用到这个属性。
  1. registerDefaultConfiguration(AnnotationMetadata metadata, BeanDefinitionRegistry registry)方法
  • 作用：注册默认的 Feign 配置，如果在 @EnableFeignClients 注解中指定了 defaultConfiguration 属性，则将其作为默认配置应用于所有 Feign 客户端。

    一、

  3. qualifier属性:
  • 类型: String
  • 默认值: “”
  • 描述: 用来指定 Feign 客户端的@Qualifier值。处理已有相同名称 Bean 定义的情况、
  2. contextId属性:
  • 类型: String
  • 默认值: “”
  • 描述: 用作 Bean 名称，但不会作为服务ID使用，如@FeignClient(contextId = “myContextId”)，“myContextId” 就是我们给这个Bean 起的一个特定名称。
  • 实现

  publicvoidregisterBeanDefinition(StringbeanName,BeanDefinitionbeanDefinition)throwsBeanDefinitionStoreException{Assert.hasText(beanName,"Bean name must not be empty");Assert.notNull(beanDefinition,"BeanDefinition must not be null");……        BeanDefinitionexistingDefinition =(BeanDefinition)this.beanDefinitionMap.get(beanName);// 重复bean处理if(existingDefinition !=null){if(!this.isAllowBeanDefinitionOverriding()){thrownewBeanDefinitionOverrideException(beanName,beanDefinition,existingDefinition);}if(existingDefinition.getRole()<beanDefinition.getRole()){if(this.logger.isInfoEnabled()){this.logger.info("Overriding user-defined bean definition for bean '"+beanName +"' with a framework-generated bean definition: replacing ["+existingDefinition +"] with ["+beanDefinition +"]");}}elseif(!beanDefinition.equals(existingDefinition)){if(this.logger.isDebugEnabled()){this.logger.debug("Overriding bean definition for bean '"+beanName +"' with a different definition: replacing ["+existingDefinition +"] with ["+beanDefinition +"]");}}elseif(this.logger.isTraceEnabled()){this.logger.trace("Overriding bean definition for bean '"+beanName +"' with an equivalent definition: replacing ["+existingDefinition +"] with ["+beanDefinition +"]");}this.beanDefinitionMap.put(beanName,beanDefinition);}else{// 新增bean处理if(this.hasBeanCreationStarted()){synchronized(this.beanDefinitionMap){this.beanDefinitionMap.put(beanName,beanDefinition);List<String>updatedDefinitions =newArrayList(this.beanDefinitionNames.size()+1);updatedDefinitions.addAll(this.beanDefinitionNames);updatedDefinitions.add(beanName);this.beanDefinitionNames =updatedDefinitions;this.removeManualSingletonName(beanName);}}else{this.beanDefinitionMap.put(beanName,beanDefinition);this.beanDefinitionNames.add(beanName);this.removeManualSingletonName(beanName);}this.frozenBeanDefinitionNames =null;}// 缓存清理if(existingDefinition ==null&&!this.containsSingleton(beanName)){if(this.isConfigurationFrozen()){this.clearByTypeCache();}}else{this.resetBeanDefinition(beanName);}}

  三、

4. url属性:

• 类型: String
• 默认值: “”
• 描述: 绝对URL或可解析的主机名（协议可选）。

  前两篇文章揭秘 Feign 调用机制：微服务通信的无缝集成和微服务通信背后的秘密：Ribbon 如何选择最佳服务实例？，我们已经了解到 Feign 调用机制的一大优势 —— 在不需要指定域名的情况下，能够借助 Ribbon 精准地找到并调用微服务。 @FeignClient

  @FeignClient 是 Spring Cloud Feign 提供的一个注解，用于声明一个 REST 客户端接口。本文我们继续来分享Feign调用机制中两个最核心的注解。必填。完成注册操作。这个注解通常放在配置类或启动类上，Spring 会扫描标注了 @FeignClient 注解的接口，并生成对应的客户端代理类，以便在应用中通过这些接口调用远程服务。

10. primary属性:

• 类型: boolean
• 默认值: true
• 描述: 是否将 Feign 代理标记为主 Bean。