Resilience4j 主要api介绍

春风可化雨，润物细无声

于 2024-09-12 16:46:46 发布

阅读量875

点赞数 6

分类专栏： JAVA开发总结文章标签： java java-ee spring cloud spring boot

本文链接：https://blog.youkuaiyun.com/qq_40551070/article/details/142180202

版权

resilience4j是github推出的一款弹性架构工具，其中有一项很好用的功能：熔断。

一、服务安装

服务要求JDK版本为JDK 1.8及以上。maven应用安装resilience4j-circuitBreaker服务：

<dependency>
<groupId>io.github.resilience4j</groupId>
<artifactId>resilience4j-circuitbreaker</artifactId>
<version>0.15.0</version>
</dependency>
需要注意的是，release版本和snapshot版本是通过仓库的配置来区分的。

release版本的仓库：

<repositories>
<repository>
<snapshots>
<enabled>false</enabled>
</snapshots>
<id>jcenter-releases</id>
<name>jcenter</name>
<url>http://jcenter.bintray.com</url>
</repository>
</repositories>
snapshot版本的仓库：

<repositories>
<repository>
<id>jcenter-snapshots</id>
<name>jcenter</name>
<url>http://oss.jfrog.org/artifactory/oss-snapshot-local/</url>
</repository>
</repositories>

二、获取熔断器实例：CircuitBreakerRegistry

熔断的核心是熔断器CircuitBreaker，想要使用熔断服务，需要先获取熔断器的实例。resilience4j提供了两种方式来获取熔断器：通过注册工具获取，以及通过熔断器的静态方法直接获取。这里推荐使用注册工具获取，优点有两个，一方面可以避免重复定制熔断器配置；另一方面便于熔断器实例的管理，避免出现重复创建的情况。

1、通过注册工具获取

resilience4j提供了一个注册工具CircuitBreakerRegistry，用来注册和管理熔断器的实例。CircuitBreakerRegistry的存储是基于ConcurrentHashMap来实现的，可以保证并发情况下的线程安全。

1、生成熔断器配置：

熔断器配置CircuitBreakerConfig相关的内容可以参考文章：CircuitBreakerConfig。这里提供一个定制化熔断器配置的例子：

CircuitBreakerConfig circuitBreakerConfig = CircuitBreakerConfig.custom()
.failureRateThreshold(50)
.waitDurationInOpenState(Duration.ofMillis(1000))
.ringBufferSizeInHalfOpenState(2)
.ringBufferSizeInClosedState(2)
.recordExceptions(IOException.class, TimeoutException.class)
.ignoreExceptions(BusinessException.class, OtherBusinessException.class)
.enableAutomaticTransitionFromOpenToHalfOpen()
.build();
当然，也可以使用默认的熔断器配置，这样就不需要定制化熔断器了。

2、获取熔断器注册工具：

可以通过CircuitBreakerRegistry的静态方法获取CircuitBreakerRegistry的实例。

这里有两种方式获取注册工具实例。一种是获取默认的CircuitBreakerRegistry实例，默认实例使用默认的熔断器配置；另一种是根据定制化的熔断器配置获取CircuitBreakerRegistry实例，这种实例将会默认使用定制化的熔断器配置。

// 获取默认的熔断器注册工具的实例
CircuitBreakerRegistry circuitBreakerRegistry = CircuitBreakerRegistry.ofDefaults();

// 根据定制化熔断器配置生成注册工具的实例
CircuitBreakerRegistry circuitBreakerRegistry = CircuitBreakerRegistry.of(circuitBreakerConfig);
3、生成熔断器实例：

因为在上一步有两种情况：定制熔断器配置和使用默认配置，所以这一步也有不同的操作，来获取熔断器：

// 根据注册工具的默认配置创建名称为"otherName"的熔断器实例
CircuitBreaker circuitBreaker2 = circuitBreakerRegistry.circuitBreaker("otherName");

// 根据指定的熔断器配置，创建名称为"