微服务之feign组件

feign

服务调用Feign入门

背景

以前使用RestTemplate调用接口很麻烦,所以有了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,那么就会非常痛苦。所以就有了feign,feign可以简单快速的进行远程接口调用。

1.1 Feign简介

Feign是Netflix开发的声明式,模板化的HTTP客户端,其灵感来自Retrofit,JAXRS-2.0以及WebSocket.

1.Feign可帮助我们更加便捷,优雅的调用HTTP API。
2.在SpringCloud中,使用Feign非常简单——创建一个接口,并在接口上添加一些注解,代码就完成了。
3.Feign支持多种注解,例如Feign自带的注解或者JAX-RS注解等。
4.SpringCloud对Feign进行了增强,使Feign支持了SpringMVC注解,并整合了Ribbon和Eureka,从而让Feign的使用更加方便。

1.2 基于Feign的服务调用

(1)引入依赖

​ 在服务消费者 shop_service_order 添加Fegin依赖

<dependency>
 <groupId>org.springframework.cloudgroupId>
 <artifactId>spring-cloud-starter-openfeignartifactId>
dependency>
(2)启动类添加Feign的支持

通过@EnableFeignClients注解开启Spring Cloud Feign的支持功能

@SpringBootApplication(scanBasePackages="cn.itcast.order")
@EntityScan("cn.itcast.entity")
@EnableFeignClients
public class OrderApplication {
 public static void main(String[] args) {
 	SpringApplication.run(OrderApplication.class, args);
 }
}
(3)配置调用接口

​ 创建一个Feign接口,此接口是在Feign中调用微服务的核心接口
​ 在服务消费者 shop_service_order 添加一个 ProductFeginClient 接口

//指定需要调用的微服务名称
@FeignClient(name="shop-service-product")
public interface ProductFeginClient {
//调用的请求路径
@RequestMapping(value = "/product/{id}",method = RequestMethod.GET)
	public Product findById(@PathVariable("id") Long id);
}

在Feign中绑定参数必须通过value属性来指明具体的参数名,不然会抛出异常。@FeignClient:注解通过name指定需要调用的微服务的名称,用于创建Ribbon的负载均衡器。所以Ribbon会把 shop-service-product 解析为注册中心的服务。即name后面的值就是配置的服务名,如下:

spring: 
  application:
    # 应用名称
    name: app-app-managerment
(4)通过接口调用远程微服务

​ 修改 OrderController ,添加ProductFeginClient的自动注入,并在order方法中使用ProductFeginClient 完成微服务调用。

@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    private ProductFeginClient productFeginClient;
    
    @GetMapping("/buy/{id}")
    public Product order(@PathVariable Long id) {
        return productFeginClient.findById(id);
    }
}
(5)测试效果

微服务之feign组件_第1张图片

如上通过调用order/buy接口就调用到了远程服务shop-service-product的product接口,一个简单的基于feign的远程接口调用就完成了。

1.3 Feign和Ribbon的联系

Ribbon是一个基于 HTTP 和 TCP 客户端 的负载均衡的工具。它可以 在客户端 配置RibbonServerList(服务端列表),使用 HttpClient 或RestTemplate 模拟http请求,步骤相当繁琐。

Feign 是在 Ribbon的基础上进行了一次改进,是一个使用起来更加方便的 HTTP 客户端。采用接口的方式, 只需要创建一个接口,然后在上面添加注解即可 ,将需要调用的其他服务的方法定义成抽象方法即可, 不需要自己构建http请求。然后就像是调用自身工程的方法调用,而感觉不到是调用远程方法,使得编写客户端变得非常容易

1.4 负载均衡

Feign中本身已经集成了Ribbon依赖和自动配置,因此我们不需要额外引入依赖,也不需要再注册RestTemplate 对象。另外,我们也可以配置Ribbon,可以通过 ribbon.xx 来进行全局配置。也可以通过 服名.ribbon.xx 来对指定服务配置。

启动两个 shop_service_product ,重新调用测试可以发现使用Ribbon的轮询策略进行负载均衡。

1.5@FeignClient注解的属性

1.value, name:
	value和name的作用一样,如果没有配置url那么配置的值将作为服务名称,用于服务发现。反之只是一个名称。

2.serviceId
	serviceId已经废弃了,直接使用name即可;进入FeignClient注解可以看到在serviceId上有@Deprecated注解,即废弃。

3.contextId
	比如我们有个user服务,但user服务中有很多个接口,我们不想将所有的调用接口都定义在一个类中,比如:

client1:

@FeignClient(name = "optimization-user")
public interface UserRemoteClient {
	@GetMapping("/user/get")
	public User getUser(@RequestParam("id") int id);
}

Client2

@FeignClient(name = "optimization-user")
public interface UserRemoteClient2 {
	@GetMapping("/user2/get")
	public User getUser(@RequestParam("id") int id);
}

这种情况下启动就会报错了,因为Bean的名称冲突了。

解决方案可以增加下面的配置,作用是允许出现beanName一样的BeanDefinition。

spring.main.allow-bean-definition-overriding=true

另一种解决方案就是为每个Client手动指定不同的contextId,这样就不会冲突了。

4.fallback
	定义容错的处理类,也就是回退逻辑,fallback的类必须实现FeignClient的接口,无法知道熔断的异常信息。

5.fallbackFactory
	也是容错的处理,可以知道熔断的异常信息。

如上属性是一些常见常用的,没有用过的属性就不写了。

服务调用Feign高级

2.1 Feign的配置

​ 从Spring Cloud Edgware开始,Feign支持使用属性自定义Feign。对于一个指定名称的FeignClient(例如该Feign Client的名称为 feignName ),Feign支持如下配置项:

feign:
 client:
  config:
   feignName: ##定义FeginClient的名称
    connectTimeout: 5000 # 相当于Request.Options
    readTimeout: 5000 # 相当于Request.Options
    # 配置Feign的日志级别,相当于代码配置方式中的Logger
    loggerLevel: full
    # Feign的错误解码器,相当于代码配置方式中的ErrorDecoder
    errorDecoder: com.example.SimpleErrorDecoder
    # 配置重试,相当于代码配置方式中的Retryer
    retryer: com.example.SimpleRetryer
    # 配置拦截器,相当于代码配置方式中的RequestInterceptor
    requestInterceptors:
      - com.example.FooRequestInterceptor
      - com.example.BarRequestInterceptor
    decode404: false
feignName:FeginClient的名称
connectTimeout : 建立链接的超时时长
readTimeout : 读取超时时长
loggerLevel: Fegin的日志级别
errorDecoder :Feign的错误解码器
retryer : 配置重试
requestInterceptors : 添加请求拦截器
decode404 : 配置熔断不处理404异常

2.2 请求压缩

Spring Cloud Feign 支持对请求和响应进行GZIP压缩,以减少通信过程中的性能损耗。通过下面的参数即可开启请求与响应的压缩功能:

feign:
 compression:
  request:
    enabled: true # 开启请求压缩
  response:
    enabled: true # 开启响应压缩

同时,我们也可以对请求的数据类型,以及触发压缩的大小下限进行设置:

feign:
 compression:
  request:
    enabled: true # 开启请求压缩
    mime-types: text/html,application/xml,application/json # 设置压缩的数据类型
    min-request-size: 2048 # 设置触发压缩的大小下限

注:上面的数据类型、压缩大小下限均为默认值。

2.3 日志级别

在开发或者运行阶段往往希望看到Feign请求过程的日志记录,默认情况下Feign的日志是没有开启的。
要想用属性配置方式来达到日志效果,只需在 application.yml 中添加如下内容即可:

feign:
 client:
  config:
    shop-service-product:
    loggerLevel: FULL

logging:
 level:
  cn.itcast.order.fegin.ProductFeginClient: debug

logging.level.xx : debug : Feign日志只会对日志级别为debug的做出响应cn.itcast.order.fegin.ProductFeginClient是配置的feign的全路径名称

feign.client.config.shop-service-product.loggerLevel : 配置Feign的日志Feign有四种日志级别:

1.NONE【性能最佳,适用于生产】:不记录任何日志(默认值)
2.BASIC【适用于生产环境追踪问题】:仅记录请求方法、URL、响应状态代码以及执行时间
3.HEADERS:记录BASIC级别的基础上,记录请求和响应的header。
4.FULL【比较适用于开发及测试环境定位问题】:记录请求和响应的header、body和元数据。

微服务之feign组件_第2张图片

你可能感兴趣的:(restful,java,http)