Feign简介

Feign 是一个声明web服务客户端,这使得编写web服务客户端更容易,使用Feign 创建一个接口并对它进行注解,它具有可插拔的注解支持包括Feign注解与JAX-RS注解,Feign还支持可插拔的编码器与解码器,Spring Cloud 增加了对 Spring MVC的注解,Spring Web 默认使用了HttpMessageConverters, Spring Cloud集成了Ribbon 和 Eureka使Feign支持http client负载均衡。

上面其实是对Spring Cloud官方文档Declarative REST Client: Feign一节的翻译。

Feign基本使用

添加spring-cloud-starter-openfeign依赖

1
2
3
4
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

应用启动类上加入@EnableFeignClients

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
public class App
{
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
return new RestTemplate();
}
public static void main( String[] args )
{
SpringApplication.run(App.class,args);
}
}

定义一个接口类并加入@FeignClient

1
2
3
4
5
6
7
@FeignClient("microservice-springcloud-user")
public interface UserFeignClient {
@RequestMapping(value = "/sample/{userId}", method = RequestMethod.GET)
User findUserById(@PathVariable("userId") Long userId);
@RequestMapping(value = "/user/{userId}", method = RequestMethod.POST)
User updateUser(@PathVariable("userId") Long userId, @RequestParam("name") String name,@RequestParam("balance") BigDecimal balance);
}

上面的例子代码中提供了2个get请求和一个post请求。@FeignClient中value为服务id。

在Controller中注入上面创建的接口

1
2
3
4
5
6
7
8
9
10
11
12
13
@RestController
public class MovieController {
@Autowired
private UserFeignClient userFeignClient;
@GetMapping("/findUser/{userId}")
public User findUserById(@PathVariable Long userId) {
return this.userFeignClient.findUserById(userId);
}
@PostMapping("/user/{userId}")
public User updateUserById(@PathVariable Long userId, User user) {
return this.userFeignClient.updateUser(userId,user.getName(),user.getBalance());
}
}

测试

  • 1.启动Eureka Server;
  • 2.启动microservice-springcloud-user服务;
  • 3.启动microservice-springcloud-movie(本例);

1.GET请求测试

浏览器输入http://localhost:7901/findUser/1

可以看到,请求成功。

2.POST请求测试

使用ARC(一个Chrome浏览器的http插件)测试POST请求,请求也是成功的

问题

  • 1.在UserFeignClient中不能使用GetMapping,要使用RequestMapping注解;
  • 2.url路径中的参数,在@PathVariable注解中必须指定value,如@PathVariable("userId") Long userId,使用@RequestParam也需要指定value;
  • 3.不支持复杂对象,需要结合@RequestParam实现复杂对象。如果使用复杂对象,比如:
    1
    2
    @RequestMapping(value = "/user/{userId}", method = RequestMethod.POST)
    User updateUser(@PathVariable("userId") Long userId, User user);

比如上面方法中的User为复杂对象,在使用ARC(一个Chrome浏览器的http插件)测试时,后台Controller接收是正常的,但UserFeignClient调用microservice-springcloud-user时User里面属性都是null,如下图。
后台Controller

UserFeignClient

参考:Spring Cloud官方文档