SpringCloud-Feign组件小坑

SpringCloud-Feign组件小坑

1. FeignClient接口如使用@PathVariable ，必须指定value属性
   代码示例：

@FeignClient("login-server")
public interface UserFeignClient {
    @GetMapping(value = "/getInfo/{id}")
    public User getInfo(@PathVariable("id") Long id);
}

在一些早期版本中， @PathVariable(“id”) 中的 “id” ，也就是value属性，必须指定，不能省略。

2. Java代码自定义Feign Client的注意点与坑
   代码示例：

@FeignClient(name = "login-server", configuration = UserFeignConfig.class)
public interface UserFeignClient {
  @GetMapping("/users/{id}")
  User findById(@PathVariable("id") Long id);
}

/**

• 该Feign Client的配置类，注意：

• 1. 该类可以独立出去；
• 2. 该类上也可添加@Configuration声明是一个配置类；

• 配置类上也可添加@Configuration注解，声明这是一个配置类；

• 但此时千万别将该放置在主应用程序上下文@ComponentScan所扫描的包中，

• 否则，该配置将会被所有Feign Client共享，无法实现细粒度配置！

• 个人建议：像我一样，不加@Configuration注解
  *
  */

  class UserFeignConfig {
  @Bean
  public Logger.Level logger() {
  return Logger.Level.FULL;
   }
  }
  

  配置类上也可添加@Configuraiton 注解，声明这是一个配置类；但此时千万别将该放置在主应用程序上下文@ComponentScan 所扫描的包中，否则，该配置将会被所有Feign Client共享（相当于变成了通用配置，其实本质还是Spring父子上下文扫描包重叠导致的问题），无法实现细粒度配置！

个人建议：像我一样，不加@Configuration注解，省得进坑，直接再。

最佳实践：尽量用配置属性自定义Feign的配置！！

3. @FeignClient 注解属性
   @FeignClient(name = “login-server”)
   在早期的Spring Cloud版本中，无需提供name属性，从Brixton版开始，@FeignClient必须提供name属性，否则应用将无法正常启动！

name属性：可以用value属性代替，因为name别名就是value（下面有@FeignClient注解源码）

url属性：若生产者项目没有配置context-path，消费者写Feign时可不加url属性

/**
	 * @return The service id with optional protocol prefix. Synonym for {@link #value()
	 * value}.
	 */
	@AliasFor("value")
	String name() default "";

另外，name、url等属性支持占位符。例如：

@FeignClient(name = “$feign.name",url="${feign.url}”)

4. 类级别的@RequestMapping会被Spring MVC加载

   @RequestMapping("/users")
   @FeignClient(name = "microservice-user")
   public class TestFeignClient {
    // ...
   }
   

   类上的@RequestMapping 注解也会被Spring MVC加载。该问题现已经被解决，早期的版本有两种解决方案：

方案1：不在类上加@RequestMapping 注解；

方案2：添加如下代码：

@Configuration
@ConditionalOnClass({ Feign.class })
public class FeignMappingDefaultConfiguration {
@Bean
public WebMvcRegistrations feignWebRegistrations() {
return new WebMvcRegistrationsAdapter() {
@Override
public RequestMappingHandlerMapping getRequestMappingHandlerMapping() {
return new FeignFilterRequestMappingHandlerMapping();
}
};
}

private static class FeignFilterRequestMappingHandlerMapping extends RequestMappingHandlerMapping {
    @Override
    protected boolean isHandler(Class<?> beanType) {
        return super.isHandler(beanType) && !beanType.isInterface();
   }

}
}

5. 如需产生Hystrix Stream监控信息，需要做一些额外操作
   Feign本身已经整合了Hystrix，可直接使用@FeignClient(value = “login-server”, fallback = XXX.class) 来指定fallback类，fallback类继承@FeignClient所标注的接口即可。

但是假设如需使用Hystrix Stream进行监控，默认情况下，访问http://IP:PORT/actuator/hystrix.stream 是会返回404，这是因为Feign虽然整合了Hystrix，但并没有整合Hystrix的监控。如何添加监控支持呢？需要以下几步：

第一步：添加依赖，示例：

org.springframework.cloud spring-cloud-starter-hystrix 第二步：在启动类上添加@EnableCircuitBreaker 注解，示例：

@SpringBootApplication
@EnableFeignClients
@EnableDiscoveryClient
@EnableCircuitBreaker
public class MovieFeignHystrixApplication {
public static void main(String[] args) {
SpringApplication.run(MovieFeignHystrixApplication.class, args);
}
}
第三步：在application.yml中添加如下内容，暴露hystrix.stream端点：

management:
endpoints:
web:
exposure:
include: ‘hystrix.stream’
这样，访问任意Feign Client接口的API后，再访问http://IP:PORT/actuator/hystrix.stream ，就会展示一大堆Hystrix监控数据了。

===============================================

个人github：https://github.com/zhangqian0710?tab=repositories

个人csdn:https://mp.youkuaiyun.com/mdeditor/96853700#