目录
一、OpenFeign的基本使用
1、配置依赖
2、编写接口
3、服务调用者添加启用注解
4、在服务调用者里调用
二、踩坑一:401 认证错误
三、踩坑二:403 请求方式错误
四、踩坑三:List不能正常传参
一、OpenFeign的基本使用
1、配置依赖
<!--OpenFeign-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!--web服务器依赖 可选-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2、编写接口
一般OpenFeign的调用逻辑是:服务提供者编写好restful访问接口,如:
@GetMapping("/pub/x")
public String test() {
return "OK";
}
@GetMapping("/publicList")
public R<List<SysUser>> queryPublicList(@RequestParam List<String> ids,
@RequestHeader("Authorization") String token) {
return R.ok(sysUserService.queryPublicList(ids));
}
注:服务提供者不需要引入OpenFeign
服务调用者了书写Feign的接口, 如:
@FeignClient(name = ServerNameConstants.SYSTEM_SERVER, path = "/sysUsers")
public interface SysUserFeign {
@GetMapping("/publicList")
R<List<SysUserDto>> queryPublicList(@RequestParam("ids") List<String> ids, @RequestHeader("Authorization") String token);
@GetMapping("/pub/x")
String test();
}
只得注意的是:feign接口应与提供者的controller接口完全对应。
3、服务调用者添加启用注解
在服务调用者的启动类上添加注解:
@EnableFeignClients
4、在服务调用者里调用
在组件里引用:
@Autowired
private SysUserFeign sysUserFeign;
R<List<SysUserDto>> res = sysUserFeign.queryPublicList(Collections.singletonList(String.valueOf(ids)), token);
sysUserFeign.test()
这样调用就可以在服务器通过restful http请求的方式ribbon负载均衡访问到对应接口了。
二、踩坑一:401 认证错误
由于我的微服务配置了Oauth2来进行权限访问,直接访问认证后才能访问的接口会报401未授权。
最终,我的解决方法是通过在接口上加上@RequestHeader("Authorization") String token来解决问题:每次调用feign接口时我都将访问携带的请求头给他加上,这样成功解决了认证问题。
三、踩坑二:403 请求方式错误
在我刚解决401后,服务器又报403请求方式错误,这不搞心态吗。解决方案:Feign接口会将接口转换成http形式,这就要我们注意接口上的@RequestParam、@RequestBody这些参数不能少,准确使用。
四、踩坑三:List<Long>不能正常传参
原本的服务提供者需要的参数为 @RequestParam List<Long> ids,但在服务调用者调用此feign接口时出现情况如下:
传入的List数据将接口参数变为这样:
http://my-server/xxxx?ids=100&ids=101&ids=102
这个问题就很离谱,理论上应该是这个格式:
http://my-server/xxxx?ids=100,101,102
最终,我的解决方案是将List<Long>直接改为List<String>
feign传参时也只传长度为1的List参数合并参数:
for (MGPltTenderComment comment : comments) {
if (ids.toString().equals("")) {
ids = new StringBuilder(myId);
} else {
ids.append(",").append(myId);
}
}
R<List<SysUserDto>> res = sysUserFeign.queryPublicList(Collections.singletonList(String.valueOf(ids)), token);
关键:Collections.singletonList(String.valueOf(ids))
至此,总结完毕,问题也全部解决!