先声明,这篇博客是我从Github官网上copy上的,在加上google翻译。算是做一个笔记。
第一步是构造一个HystrixCommand
或HystrixObservableCommand
对象,以表示您对依赖项提出的请求。向构造函数传递发出请求时所需的任何参数。
HystrixCommand
如果期望依赖项返回单个响应,则构造一个对象。例如:
HystrixCommand
命令= 新的 HystrixCommand(arg1,arg2);
HystrixObservableCommand
如果期望依赖项返回一个发出响应的Observable,则构造一个对象。例如:
HystrixObservableCommand
命令= 新的 HystrixObservableCommand(arg1,arg2);
使用Hystrix命令对象的以下四种方法之一可以执行命令的方式有四种(前两种仅适用于简单HystrixCommand
对象,不适用于HystrixObservableCommand
):
execute() —阻止,然后返回从依赖项接收的单个响应(或在发生错误的情况下引发异常)
queue()—返回一个Future,您可以从中获得依赖项的单个响应
observe()—订阅,该Observable代表表示从依赖项返回的响应,并返回Observable复制该源的。Observable
toObservable()—返回一个Observable,当您订阅它时,将执行Hystrix命令并发出其响应
K 值 =命令。执行();
Future < K > fValue =命令。队列();
Observable < K > ohValue =命令。观察(); // hot observable
Observable < K > ocValue =命令。toObservable(); //冷可观察
同步调用execute()调用queue().get()。queue()依次调用toObservable().toBlocking().toFuture()。这就是说,最终每个实现HystrixCommand
都由Observable实现来支持,即使是那些旨在返回单个简单值的命令也是如此。
如果为此命令启用了请求缓存,并且如果对请求的响应在缓存中可用,则该缓存的响应将立即以的形式返回Observable。(请参见下面的“请求缓存”。)
当您执行该命令时,Hystrix会检查断路器,以查看电路是否断开。
如果电路开路(或“跳闸”),则Hystrix将不执行命令,而是将流路由到(8)获取回退。
如果电路是闭合的,则流程进行到(5),以检查是否有足够的容量来运行该命令。
如果与该命令关联的线程池和队列(或信号量,如果未在线程中运行)已满,则Hystrix将不会执行该命令,但会立即将流路由到(8)获取回退。
在这里,Hystrix通过为此目的编写的方法(以下之一)调用对依赖项的请求:
HystrixCommand.run()
—返回单个响应或引发异常
HystrixObservableCommand.construct()
—返回一个Observable,它发出响应或发送onError通知
如果run()or construct()方法超出命令的超时值,则该线程将抛出TimeoutException(如果命令本身未在其自己的线程中运行,则该线程将抛出单独的计时器线程)。在那种情况下,Hystrix将响应路由到8。获取回退,如果该方法没有取消/中断,它将丢弃最终的返回值run()或construct()方法。
请注意,没有办法强制潜在线程停止工作-Hystrix在JVM上能做的最好的事情就是将其抛出InterruptedException。如果Hystrix封装的工作不遵守InterruptedExceptions,尽管客户端已收到TimeoutException,Hystrix线程池中的线程仍将继续其工作。这种行为可能会使Hystrix线程池饱和,尽管负载已“正确释放”。大多数Java HTTP客户端库不解释InterruptedExceptions。因此,请确保在HTTP客户端上正确配置连接和读取/写入超时。
如果命令没有引发任何异常并且返回了响应,则Hystrix在执行一些日志记录和度量标准报告后将返回此响应。在的情况下run(),Hystrix返回Observable,发出单个响应,然后发出onCompleted通知。在的情况下construct()猬返回相同Observable的返回construct()。
Hystrix向断路器报告成功,失败,拒绝和超时,断路器保持滚动的一组计算统计信息的计数器。
它使用这些统计信息来确定电路何时应“跳闸”,在该时间点它会将随后的所有请求短路,直到经过恢复期为止,在此之后,在首先检查某些运行状况检查之后,电路再次闭合。
Hystrix尝试在命令执行失败时恢复到您的后备状态:当construct()或引发异常run()(6.),由于电路断开而使命令短路(4.),命令的线程池和队列或信号量为最大容量(5.),或者命令已超过其超时长度。
编写后备,以从内存中缓存或通过其他静态逻辑提供通用响应,而无需任何网络依赖性。如果必须在回退中使用网络呼叫,则应通过另一个HystrixCommand
或进行HystrixObservableCommand
。
对于HystrixCommand
,要提供回退逻辑,您可以实现HystrixCommand.getFallback()
,该逻辑返回单个回退值。
对于HystrixObservableCommand
,要提供后备逻辑,您可以实现HystrixObservableCommand.resumeWithFallback()
该逻辑,该逻辑返回一个Observable,它可能会发出一个或多个后备值。
如果fallback方法返回响应,则Hystrix将把此响应返回给调用方。对于a HystrixCommand.getFallback()
,它将返回一个Observable,它发出从方法返回的值。在这种情况下,HystrixObservableCommand.resumeWithFallback()
它将返回从方法返回的相同Observable。
如果尚未为Hystrix命令实现后备方法,或者后备本身引发异常,则Hystrix仍会返回Observable,但它不会发出任何内容并立即以onError通知终止。通过该onError通知,将导致命令失败的异常发送回调用方。(实施回退实现可能会失败,这是一个糟糕的做法。您应该实施回退,以使其不执行任何可能失败的逻辑。)
后备失败或不存在的后备结果将因调用Hystrix命令的方式而异:
execute() -引发异常
queue()—成功返回Future,但是Future如果get()调用其方法,则会抛出异常
observe()—返回一个Observable,当您订阅它时,将通过调用订阅者的onError方法立即终止
toObservable()—返回一个Observable,当您订阅时,它将通过调用订阅者的onError方法终止
如果Hystrix命令成功执行,它将以的形式将一个或多个响应返回给调用方Observable。根据上面步骤2中调用命令的方式,在Observable返回给您之前,可能会对其进行转换:
execute()-获得Future的相同方式一样.queue(),然后调用get()在此Future以获得由所发射的单个值Observable
queue()—将转换Observable为,BlockingObservable以便可以将其转换为Future,然后返回Future
observe()— Observable立即订阅并开始执行命令的流程;返回一个Observable,当您subscribe重播时,它会排放和通知
toObservable()—返回Observable不变;您必须先subscribe执行此命令才能真正开始导致执行命令的流程
不过这些具体的代码步骤是很繁琐,但是文档上也给了我们目录信息:
用“人话”来讲解这一过程就是,首先我们可以选用两个对象来使用Hystrix的功能。有HystrixCommand
or HystrixObservableCommand
,这里我们选用的是前者。因为文档上给的比较老了,我们现在一般使用Hystrix都是基于注解来进行实现。
第二步执行command命令,然后先查看缓存中是否有调用的结果,如果有就直接返回,没有的话就接着往下走。
检查熔断器是否开启,如果开启,则根据预设的降级方案降级,如果未开启,接着往下走。
检查信号量/线程池是否打满。如果打满,同理,根据预设的降级方案降级。如果未满接着往下走。
如果选用的是HystrixCommand
则执行内部的run()
方法。如果是HystrixObservableCommand
则执行内部的construct()
方法。接着判断执行过程中是否出错(程序出错,超时,宕机等等)。如果有问题,则进入降级逻辑。否则继续。
熔断器健康记录,这一步记录什么呢?就是每一次远程调用的情况,比如成功或者失败。都会记录起来。方便观看和熔断后恢复链路。
最后,如果主逻辑(原本请求的逻辑)成功就返回给消费者,或者进入降级逻辑时,也会把降级后的处理结果返回给消费者。