hystrix基本介绍和使用(1)

一、hystrix基本介绍

Hystrix（https://github.com/Netflix/Hystrix）是Netflix（https://www.netflix.com/global）的一个开源项目，主要作用是通过控制那些访问远程系统、服务和第三方库的节点，从而对延迟和故障提供更强大的容错能力。 其可以看做是Netflix团队对分布式系统运维的各种理念和实践的总结。

二、基本用法

①pom.xml加上以下依赖

<dependency>
  <groupId>com.netflix.hystrix</groupId>
  <artifactId>hystrix-core</artifactId>
  <version>1.5.8</version>
</dependency>

②基本使用

如果某程序或class要使用Hystrix，只需简单继承HystrixCommand/HystrixObservableCommand并重写run()/construct()

然后调用程序实例化此class并执行execute()/queue()/observe()/toObservable()

例如：

public class HelloWorldHystrixCommand extends HystrixCommand<String>{
	private final String name;
	public HelloWorldHystrixCommand(String name) {
		super(HystrixCommandGroupKey.Factory.asKey("ExampleGroup"));
		this.name = name;
	}

	@Override
	protected String run() throws Exception {
		//Thread.sleep(100);
		return "hello"+name;
	}
}

public static void main(String[] args){
    String result = new HelloWorldHystrixCommand("test").execute();
    System.out.println(result);
}

或者

public class HelloWorldHystrixObservableCommand extends HystrixObservableCommand<String>{

	private final String name;

	protected HelloWorldHystrixObservableCommand(String  name) {
		super(HystrixCommandGroupKey.Factory.asKey("ExampleGroup"));
		this.name = name;
	}

	@Override
	protected Observable<String> construct() {
		System.out.println("in construct! thread:" + Thread.currentThread().getName());
        　　　　 return (Observable<String>) Observable.create(new Observable.OnSubscribe<String>() {
//            @Override
            public void call(Subscriber<? super String> observer) {
                try {
                	System.out.println("in call of construct! thread:" + Thread.currentThread().getName());
                    if (!observer.isUnsubscribed()) {
//                      observer.onError(getExecutionException());	// 直接抛异常退出，不会往下执行
                        observer.onNext("Hello1" + " thread:" + Thread.currentThread().getName());
                        observer.onNext("Hello2" + " thread:" + Thread.currentThread().getName());
                        observer.onNext(name + " thread:" + Thread.currentThread().getName());
                        System.out.println("complete before------" + " thread:" + Thread.currentThread().getName());
                        observer.onCompleted();	// 不会往下执行observer的任何方法
                        System.out.println("complete after------" + " thread:" + Thread.currentThread().getName());
                        observer.onCompleted();	// 不会执行到
                        observer.onNext("abc");	// 不会执行到
                    }
                } catch (Exception e) {
                    observer.onError(e);
                }
            }
         });
	}
}

public static void main(String[] args) {
　　　　Observable<String> observable = new HelloWorldHystrixObservableCommand("test").observe();
　　　　observable.subscribe(new Subscriber<String>() {
          public void onCompleted() {
	　　    System.out.println("completed");
	  }
	  public void onError(Throwable throwable) {
	        System.out.println("error-----------"+throwable);
	  }
	  public void onNext(String v) {
		System.out.println("next------------" + v);
       	  }
　　});
}

③HystrixCommand 与 HystrixObservableCommand对比

要想使用hystrix，只需要继承HystrixCommand或HystrixObservableCommand，简单用法见上面例子。

两者主要区别是：

（1）前者的命令逻辑写在run()；后者的命令逻辑写在construct()

（2）前者的run()是由新创建的线程执行；后者的construct()是由调用程序线程执行

（3）前者一个实例只能向调用程序发送（emit）单条数据，比如上面例子中run()只能返回一个String结果；后者一个实例可以顺序发送多条数据，比如demo中顺序调用多个onNext()，便实现了向调用程序发送多条数据;

④4个命令的执行方法对比

execute()、queue()、observe()、toObservable()这4个方法用来触发执行run()/construct()，一个实例只能执行一次这4个方法，特别说明的是HystrixObservableCommand没有execute()和queue()。

4个方法的主要区别是：

（1）execute()：以同步堵塞方式执行run()。调用execute()后，hystrix先创建一个新线程运行run()，接着调用程序要在execute()调用处一直堵塞着，直到run()运行完成（2）queue()：以异步非堵塞方式执行run()。一调用queue()就直接返回一个Future对象，同时hystrix创建一个新线程运行run()，调用程序通过Future.get()拿到run()的返回结果，而Future.get()是堵塞执行的。

测试代码如下：

@Test
    public void testQueue() throws Exception {
        // queue()是异步非堵塞性执行：直接返回，同时创建一个线程运行HelloWorldHystrixCommand.run()
        // 一个对象只能queue()一次
        // queue()事实上是toObservable().toBlocking().toFuture()
        Future<String> future = new HelloWorldHystrixCommand("Hlx").queue();

        // 使用future时会堵塞，必须等待HelloWorldHystrixCommand.run()执行完返回
        String queueResult = future.get(10000, TimeUnit.MILLISECONDS);
        // String queueResult = future.get();
        System.out.println("queue异步结果：" + queueResult);
        assertEquals("hello", queueResult.substring(0, 5));
}

（3）observe()：事件注册前执行run()/construct()。第一步是事件注册前，先调用observe()自动触发执行run()/construct()（如果继承的是HystrixCommand，hystrix将创建新线程非堵塞执行run()；如果继承的是HystrixObservableCommand，将以调用程序线程堵塞执行construct()），第二步是从observe()返回后调用程序调用subscribe()完成事件注册，如果run()/construct()执行成功则触发onNext()和onCompleted()，如果执行异常则触发onError()

测试代码如下：

@Test
	public void testObservable() throws Exception {

		// observe()是异步非堵塞性执行，同queue
		Observable<String> hotObservable = new HelloWorldHystrixCommand("Hlx").observe();

		// single()是堵塞的
		//System.out.println("hotObservable single结果：" + hotObservable.toBlocking().single());
	    //System.out.println("------------------single");
		// 注册观察者事件
		// subscribe()是非堵塞的
		hotObservable.subscribe(new Observer<String>() {

			// 先执行onNext再执行onCompleted
			// @Override
			public void onCompleted() {
				System.out.println("hotObservable completed");
			}
			// @Override
			public void onError(Throwable e) {
				e.printStackTrace();
			}
			// @Override
			public void onNext(String v) {
				System.out.println("hotObservable onNext: " + v);
			}
		});
		// 非堵塞
		// - also verbose anonymous inner-class
		// - ignore errors and onCompleted signal
		hotObservable.subscribe(new Action1<String>() {

			// 相当于上面的onNext()
			// @Override
			public void call(String v) {
				System.out.println("hotObservable call: " + v);
			}
		});
		// 主线程不直接退出，在此一直等待其他线程执行
		System.in.read();
	}

（4）toObservable()：事件注册后执行run()/construct()。第一步是事件注册前，一调用toObservable()就直接返回一个Observable<String>对象，第二步调用subscribe()完成事件注册后自动触发执行run()/construct()（如果继承的是HystrixCommand，hystrix将创建新线程非堵塞执行run()，调用程序不必等待run()；如果继承的是HystrixObservableCommand，将以调用程序线程堵塞执行construct()，调用程序等待construct()执行完才能继续往下走），如果run()/construct()执行成功则触发onNext()和onCompleted()，如果执行异常则触发onError()

测试代码如下：

@Test
	public void testToObservable() throws Exception {

		// toObservable()是异步非堵塞性执行，同queue
		Observable<String> coldObservable = new HelloWorldHystrixCommand("Hlx").toObservable();

		// single()是堵塞的
		//System.out.println("coldObservable single结果：" + coldObservable.toBlocking().single());

		// 注册观察者事件
		// subscribe()是非堵塞的
		// - this is a verbose anonymous inner-class approach and doesn't do assertions
		coldObservable.subscribe(new Observer<String>() {

			// 先执行onNext再执行onCompleted
			// @Override
			public void onCompleted() {
				System.out.println("coldObservable completed");
			}
			// @Override
			public void onError(Throwable e) {
				System.out.println("coldObservable error");
				e.printStackTrace();
			}
			// @Override
			public void onNext(String v) {
				System.out.println("coldObservable onNext: " + v);
			}
		});
		// 非堵塞
		// - also verbose anonymous inner-class
		// - ignore errors and onCompleted signal
		/*coldObservable.subscribe(new Action1<String>() {

			public void call(String v) {
				// 相当于上面的onNext()
				// @Override
				System.out.println("coldObservable call: " + v);
				}
		});*/
		// 主线程不直接退出，在此一直等待其他线程执行
		System.in.read();

}

参考文献：

http://www.jianshu.com/p/b9af028efebb