服务调用Feign入门
前面我们使用的RestTemplate实现REST API调用,代码大致如下:
@GetMapping("/buy/{id}")
public Product order() {
Product product = restTemplate.getForObject("http://shop-serviceproduct/product/1", Product.class);
return product;
}
由代码可知,我们是使用拼接字符串的方式构造URL的,该URL只有一个参数。但是,在现实中,URL中往往含有多个参数。这时候我们如果还用这种方式构造URL,那么就会非常痛苦。那应该如何解决?
我们带着这样的问题进入到本章的学习。
1 Feign简介
Feign是Netflix开发的声明式,模板化的HTTP客户端,其灵感来自Retrofit,JAXRS-2.0以及WebSocket
- Feign可帮助我们更加便捷,优雅的调用HTTP API。 在SpringCloud中,使用Feign非常简单——创建一个接口,并在接口上添加一些注解,代码就完成了。
- Feign支持多种注解,例如Feign自带的注解或者JAX-RS注解等。
- SpringCloud对Feign进行了增强,使Feign支持了SpringMVC注解,并整合了Ribbon和Eureka,
- 从而让Feign的使用更加方便。
2 基于Feign的服务调用
(1)引入依赖(服务消费者)
服务消费者中引入feign依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
(2)启动类添加Feign的支持(服务消费者)
@SpringBootApplication
@EntityScan("cn.itcast.order.entity")
@EnableFeignClients //激活fiegn
public class OrderApplication {
public static void main(String[] args) {
SpringApplication.run(OrderApplication.class);
}
}
(3)创建Feign接口(服务消费者)
/**
* 声明需要调用的微服务名称
* @FeignClient(name = "服务提供者名称")
*/
@FeignClient(name = "service-product")
public interface ProductFeignClient {
@RequestMapping(value = "/product/{id}",method = RequestMethod.GET)
public Product findById(@PathVariable("id") Long id);
}
- 定义各参数绑定时,@PathVariable、@RequestParam、@RequestHeader等可以指定参数属性,在Feign中绑定参数必须通过value属性来指明具体的参数名,不然会抛出异常
- @FeignClient:注解通过name指定需要调用的微服务的名称,用于创建Ribbon的负载均衡器。所以Ribbon会把 shop-service-product 解析为注册中心的服务。
(4)修改服务消费者调用接口的方法(服务消费者)
修改 OrderController ,添加ProductFeginClient的自动注入,并在order方法中使用
ProductFeginClient 完成微服务调用
@RestController
@RequestMapping("/order")
public class OderController {
//注入ProductFeginClient
@Autowired
private ProductFeignClient productFeignClient;
@GetMapping("/buy/{id}")
public Product buyById(@PathVariable("id") Long id) {
Product product = null;
//调用feign接口方法
product = productFeignClient.findById(id);
return product;
}
}
(5)测试服务调用成功,并返回数据
3 Feign和Ribbon的联系
Ribbon是一个基于 HTTP 和 TCP 客户端 的负载均衡的工具。它可以 在客户端 配置
RibbonServerList(服务端列表),使用 HttpClient 或 RestTemplate 模拟http请求,步骤相当繁琐。
Feign 是在 Ribbon的基础上进行了一次改进,是一个使用起来更加方便的 HTTP 客户端。采用接口的方式, 只需要创建一个接口,然后在上面添加注解即可 ,将需要调用的其他服务的方法定义成抽象方法即可, 不需要自己构建http请求。然后就像是调用自身工程的方法调用,而感觉不到是调用远程方法,使得编写客户端变得非常容易
4 负载均衡
Feign中本身已经集成了Ribbon依赖和自动配置,因此我们不需要额外引入依赖,也不需要再注册RestTemplate 对象。另外,我们可以像上节课中讲的那样去配置Ribbon,可以通过 ribbon.xx 来进行全局配置。也可以通过 服务名.ribbon.xx 来对指定服务配置:
启动两个 shop_service_product ,重新测试可以发现使用Ribbon的轮询策略进行负载均衡