Spring Cloud中关于Feign的常见问题总结
一、FeignClient接口,不能使用@GettingMapping之类的组合注解
代码示例:
@FeignClient("microservice-provider-user") publicinterfaceUserFeignClient{ @RequestMapping(value="/simple/{id}",method=RequestMethod.GET) publicUserfindById(@PathVariable("id")Longid); ... }
这边的@RequestMapping(value="/simple/{id}",method=RequestMethod.GET)不能写成@GetMapping("/simple/{id}")。
二、FeignClient接口中,如果使用到@PathVariable,必须指定其value
代码示例:
@FeignClient("microservice-provider-user") publicinterfaceUserFeignClient{ @RequestMapping(value="/simple/{id}",method=RequestMethod.GET) publicUserfindById(@PathVariable("id")Longid); ... }
这边的@PathVariable("id")中的”id”,不能省略,必须指定。
三、FeignClient多参数的构造
如果想要请求microservice-provider-user服务,并且参数有多个例如:http://microservice-provider-user/query-by?id=1&username=张三要怎么办呢?
直接使用复杂对象:
@FeignClient("microservice-provider-user") publicinterfaceUserFeignClient{ @RequestMapping(value="/query-by",method=RequestMethod.GET) publicUserqueryBy(Useruser); ... }
该请求不会成功,只要参数是复杂对象,即使指定了是GET方法,feign依然会以POST方法进行发送请求。
正确的写法:
写法1:
@FeignClient("microservice-provider-user") publicinterfaceUserFeignClient{ @RequestMapping(value="/query-by",method=RequestMethod.GET) publicUserqueryBy(@RequestParam("id")Longid,@RequestParam("username")Stringusername); }
写法2:
@FeignClient(name="microservice-provider-user") publicinterfaceUserFeignClient{ @RequestMapping(value="/query-by",method=RequestMethod.GET) publicList<User>queryBy(@RequestParamMap<String,Object>param); }
四、Feign如果想要使用HystrixStream,需要做一些额外操作
我们知道Feign本身就是支持Hystrix的,可以直接使用@FeignClient(value="microservice-provider-user",fallback=XXX.class)来指定fallback的类,这个fallback类集成@FeignClient所标注的接口即可。
但是假设我们需要使用HystrixStream进行监控,默认情况下,访问http://IP:PORT/hystrix.stream是个404。如何为Feign增加HystrixStream支持呢?
需要以下两步:
第一步:添加依赖,示例:
<!--整合hystrix,其实feign中自带了hystrix,引入该依赖主要是为了使用其中的hystrix-metrics-event-stream,用于dashboard--> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-hystrix</artifactId> </dependency>
第二步:在启动类上添加@EnableCircuitBreaker注解,示例:
@SpringBootApplication @EnableFeignClients @EnableDiscoveryClient @EnableCircuitBreaker publicclassMovieFeignHystrixApplication{ publicstaticvoidmain(String[]args){ SpringApplication.run(MovieFeignHystrixApplication.class,args); } }
这样修改以后,访问任意的API后,再访问http://IP:PORT/hystrix.stream,就会展示出一大堆的API监控数据了。
五、如果需要自定义单个Feign配置,Feign的@Configuration注解的类不能与@ComponentScan的包重叠
如果包重叠,将会导致所有的FeignClient都会使用该配置。
六、首次请求失败
详见:解决SpringCloud中Feign/Ribbon第一次请求失败的方法
七、@FeignClient的属性注意点
(1)serviceId属性已经失效,尽量使用name属性。例如:
@FeignClient(serviceId="microservice-provider-user")
这么写是不推荐的,应写为:
@FeignClient(name="microservice-provider-user")
(2)在使用url属性时,在老版本的SpringCloud中,不需要提供name属性,但是在新版本(例如Brixton、Camden)@FeignClient必须提供name属性,并且name、url属性支持占位符。例如:
@FeignClient(name="${feign.name}",url="${feign.url}")
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如果有疑问大家可以留言交流,谢谢大家对毛票票的支持。