Hystrix 的执行模型设计上采用了命令模式,将对外部资源的调用逻辑和 fallback 逻辑封装成一个命令对象(HystrixCommand / HystrixObservableCommand),交由 Hystrix 执行。
引入需要的包
com.netflix.hystrix
hystrix-core
1.5.18
com.netflix.hystrix
hystrix-javanica
1.5.18
使用方式一:Java原生编码方式
我们可以通过Hystrix原生编码的方式来对访问的接口进行控制
步骤1:创建针对某个接口的命令对象
/**
* 定义某个接口调用的指令类
* */
public class IhrTokenRequestCommand extends HystrixCommand> {
public IhrTokenRequestCommand(){
//配置本接口配置参数
super(Setter.withGroupKey(HystrixCommandGroupKey.Factory.asKey("ThreadPoolTestGroup")) //服务分组
.andCommandKey(HystrixCommandKey.Factory.asKey("testCommandKey"))
.andThreadPoolKey(HystrixThreadPoolKey.Factory.asKey("ThreadPoolTest"))
.andCommandPropertiesDefaults(HystrixCommandProperties.Setter()
.withExecutionTimeoutInMilliseconds(5000)) //超时时长,默认1000
.andThreadPoolPropertiesDefaults( // 配置线程池
HystrixThreadPoolProperties.Setter()
.withCoreSize(50)) // 配置线程池里的线程数
.andCommandPropertiesDefaults( // 配置熔断器
HystrixCommandProperties.Setter()
.withCircuitBreakerEnabled(true) //是否开启熔断机制,默认为true。
.withCircuitBreakerRequestVolumeThreshold(20) //在熔断开关闭合情况下,在进行失败率判断之前,一个采样周期内必须进行至少N个请求才能进行采样统计,目的是有足够的采样使得失败率计算正确,默认为20。
.withCircuitBreakerSleepWindowInMilliseconds(3) // 熔断后的重试时间窗口,且在该时间窗口内只允许一次重试。即在熔断开关打开后,在该时间窗口允许有一次重试,如果重试成功,则将重置Health采样统计并闭合熔断开关实现快速恢复,否则熔断开关还是打开状态,执行快速失败。
.withCircuitBreakerErrorThresholdPercentage(50) //如果在一个采样时间窗口内,失败率超过该配置,则自动打开熔断开关实现降级处理,即快速失败。默认配置下采样周期为10s,失败率为50%。
)
);
}
//实际执行的代码,可主动抛出HystrixTimeoutException、HystrixRuntimeException等异常
@Override
protected MResult run() throws Exception {
return null;
}
//降级方法
@Override
protected MResult getFallback() {
MResult result = new MResult(ResponseCodeEnum.ERROR) ;
return result;
}
}
步骤2:创建实例并执行
MResult result = new IhrTokenRequestCommand().execute();
注意,每次调用都需要创建一个实例
使用方式二:使用Spring的AOP进行控制
通过Spring的AOP,我们可以用更加优雅的方式来控制对接口的访问
步骤1:添加所需切面的配置
在Spring的配置文件中添加以下配置
也可以通过JavaConfig的方式来配置
@Configuration
public class HystrixAspectConfiguration {
@Bean
public HystrixCommandAspect hystrixAspect() {
return new HystrixCommandAspect();
}
}
步骤2:在方法上添加注解
public class HystrixResourceApi {
@HystrixCommand(commandProperties = {
@HystrixProperty(name = "circuitBreaker.errorThresholdPercentage", value = "50")
},fallbackMethod = "fallbackForGetUser")
public String getUserById(String id) {
throw new RuntimeException("getUserById command failed");
}
/**
* fallback 方法,原方法被降级的时候调用
* */
String fallbackForGetUser(String id) {
return "unknown";
}
}
接着,在需要的地方通过依赖注入的方式来正常的使用该方法即可。
HystrixCommandProperties配置说明
参数
说明
withFallbackEnabled
是否启用降级处理,如果启用了,则在超时或异常时调用getFallback进行降级处理,默认开启。
withFallbackIsolationSemaphoreMaxConcurrentRequests
fallback方法的信号量配置,配置getFallback方法并发请求的信号量,如果请求超过了并发信号量限制,则不再尝试调用getFallback方法,而是快速失败,默认信号量为10。
withExecutionIsolationThreadInterruptOnFutureCancel
当隔离策略为THREAD时,当执行线程执行超时时,是否进行中断处理,即Future#cancel(true)处理,默认为false
withExecutionIsolationThreadInterruptOnTimeout
当隔离策略为THREAD时,当执行线程执行超时时,是否进行中断处理,默认为true。
withExecutionTimeoutEnabled
是否启用执行超时机制,默认为true
withExecutionTimeoutInMilliseconds
执行超时时间,默认为1000毫秒,如果命令是线程隔离,且配置了executionIsolationThreadInterruptOnTimeout=true,则执行线程将执行中断处理。如果命令是信号量隔离,则进行终止操作,因为信号量隔离与主线程是在一个线程中执行,其不会中断线程处理,所以要根据实际情况来决定是否采用信号量隔离,尤其涉及网络访问的情况。
withCircuitBreakerEnabled
是否开启熔断机制,默认为true。
withCircuitBreakerForceClosed
是否强制关闭熔断开关,如果强制关闭了熔断开关,则请求不会被降级,一些特殊场景可以动态配置该开关,默认为false。
withCircuitBreakerForceOpen
是否强制打开熔断开关,如果强制打开可熔断开关,则请求强制降级调用getFallback处理,可以通过动态配置来打开该开关实现一些特殊需求,默认为false。
withCircuitBreakerErrorThresholdPercentage
如果在一个采样时间窗口内,失败率超过该配置,则自动打开熔断开关实现降级处理,即快速失败。默认配置下采样周期为10s,失败率为50%。
withCircuitBreakerRequestVolumeThreshold
在熔断开关闭合情况下,在进行失败率判断之前,一个采样周期内必须进行至少N个请求才能进行采样统计,目的是有足够的采样使得失败率计算正确,默认为20。
withCircuitBreakerSleepWindowInMilliseconds
熔断后的重试时间窗口,且在该时间窗口内只允许一次重试。即在熔断开关打开后,在该时间窗口允许有一次重试,如果重试成功,则将重置Health采样统计并闭合熔断开关实现快速恢复,否则熔断开关还是打开状态,执行快速失败。熔断后将降级调用getFallback进行处理(fallbackEnabled=true),通过Command如下方法可以判断是否熔断了。
isCircuitBreakerOpen
熔断开关是否打开了,通过“circuitBreakerForceOpen().get()
(!circuitBreakerForceClosed().get() && circuitBreaker.isOpen())”判断。
isResponseShortCircuited
isCircuitBreakerOpen=true,且调用getFallback时返回true。