本文节选自《疯狂Spring Cloud微服务架构实战》

Spring Cloud教学视频：https://my.oschina.net/JavaLaw/blog/1552993

Hystrix属性配置与回退

属性配置

        使用Hystrix时，可以为命令设置属性，以下的代码片断，为一个命令设置了执行的超时时间：

		public MyCommand(boolean isTimeout) { 		    super( 		    		Setter.withGroupKey(HystrixCommandGroupKey.Factory.asKey("ExampleGroup")) 		            .andCommandPropertiesDefaults(HystrixCommandProperties.Setter() 		            		.withExecutionTimeoutInMilliseconds(500)) 		    	 ); 		} 

        以上的配置仅对该命令生效，设置了命令的超时时间为500毫秒，该配置项的默认值为1秒，如果想对全局生效，可以使用以下的代码片断：

		ConfigurationManager 				.getConfigInstance() 				.setProperty( 				"hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds",  				500); 

        以上的代码片断，同样设置了命令超时时间为500毫秒，但对全局有效。除了超时的配置外，还需要了解一下命令的相关名称，可以为命令设置以下名称：

• 命令组名称（GroupKey）：必须提供命令组名称，默认情况下，全局维护的线程池Map以该值作为key，该Map的value为执行命令的线程池。
• 命令名称（CommandKey）：可选参数。
• 线程池名称（ThreadPoolKey）：指定了线程的key后，全局维护的线程池Map将以该值作为key。

        以下的代码片断，分别设置以上的3个Key：

		public RunCommand(String msg) { 			super( 					Setter.withGroupKey( 							HystrixCommandGroupKey.Factory.asKey("group-key")) 							.andCommandKey(HystrixCommandKey.Factory.asKey("command-key")) 							.andThreadPoolKey(HystrixThreadPoolKey.Factory.asKey("pool-key")) 					 					); 		} 

        Hystrix的配置众多，后面章节的案例会涉及部分的配置，读者如果想了解更多的配置，可到以下的地址查看：https://github.com/Netflix/Hystrix/wiki/Configuration

回退

        根据前面章节的流程图可知，至少会有3种情况触发回退（fallback）：

• 断路器被打开。
•  线程池、队列、信号量满载。
• 实际执行命令失败。

        在命令中，实现父类（HystrixCommand）的getFallback()方法，即可实现回退，当以上的情况发生时，将会执行回退方法。前面的例子中，已经展示了“执行命令失败”的回退，下面测试一下断路器被打开时的回退，详细请见代码清单6-7。

        代码清单6-7：

        06\6.2\first-hnystrix-client\src\main\java\org\crazyit\cloud\fallback\FallbackTest.java

public class FallbackTest {  	public static void main(String[] args) { 		// 断路器被强制打开 		ConfigurationManager.getConfigInstance().setProperty( 				"hystrix.command.default.circuitBreaker.forceOpen", "true"); 		FallbackCommand c = new FallbackCommand(); 		c.execute(); 		// 创建第二个命令，断路器关闭 		ConfigurationManager.getConfigInstance().setProperty( 				"hystrix.command.default.circuitBreaker.forceOpen", "false"); 		FallbackCommand c2 = new FallbackCommand(); 		c2.execute(); 	}  	static class FallbackCommand extends HystrixCommand<String> { 		public FallbackCommand() { 			super(HystrixCommandGroupKey.Factory.asKey("ExampleGroup")); 		}  		/** 		 * 断路器被强制打开，该方法不会执行 		 */ 		protected String run() throws Exception { 			System.out.println("命令执行"); 			return ""; 		}  		/** 		 * 回退方法，断路器打开后会执行回退 		 */ 		protected String getFallback() { 			System.out.println("执行回退方法"); 			return "fallback"; 		} 	} } 

        如果让断路器打开，需要符合一定的条件，本例为了简单起见，在代码清单中，使用了配置管理类（ConfigurationManager）将断路器强制打开与关闭，在打开断路器后，FallbackCommand总会执行回退（getFallback）方法，将断路器关闭，命令执行正常。如果断路器被打开，而命令中没有提供回退方法，将抛出以下异常：

com.netflix.hystrix.exception.HystrixRuntimeException:  FallbackCommand short-circuited and no fallback available.

        另外，需要注意的是，命令执行后，不管是否会触发回退，都会去计算整个链路的健康状况，根据健康状况来判断是否要打开断路器，如果命令仅仅失败了一次，是不足以打开断路器的，关于断路器的逻辑将在后面章节讲述。

回退的模式

        Hystrix的回退机制比较灵活，你可以在A命令的回退方法中执行B命令，如果B命令也执行失败，同样也会触发B命令的回退，这样就形成一种链式的命令执行，例如以下代码片断：

	static class CommandA extends HystrixCommand<String> { 		…省略其他代码 		protected String run() throws Exception { 			throw new RuntimeException(); 		}  		protected String getFallback() { 			return new CommandB().execute(); 		}	 	} 

        还有其他较为复杂的例子，例如银行转账，假设一个转账命令包含调用A银行扣款、B银行加款两个命令，其中一个命令失败后，再执行转账命令的回退，如图6-4所示。

图6-4 多命令回退

        要做到图6-4的多命令只执行一次回退的效果，CommandA与CommandB，不能有回退方法，如果CommandA命令执行失败，并且该命令有回退方法，此时将不会执行“MainCommand”的回退方法。除了上面所提到的链式的回退以及多命令回退，读者还可以根据实际情况来设计回退。

本文节选自《疯狂Spring Cloud微服务架构实战》

Spring Cloud教学视频：https://my.oschina.net/JavaLaw/blog/1552993

本书代码共享地址：https://gitee.com/yangenxiong/SpringCloud