Spring Cloud Feign(第五篇) 之Hystrix

Spring Cloud Feign 之Hystrix

環境信息: java 1.8、Spring boot 1.5.10.RELEASE、spring cloud-Edgware.SR3、maven 3.3+

本章節只針對Hystrix在Feign中的簡單實用，和一些簡單的源碼分析，更詳細的請參考GitHub官網

Fallback章節已經簡單的介紹了Hystrix的熔斷保護使用，這章將介紹HystrixCommand、Observable、Single、Completable這四種異步HTTP請求方式。

那麼Hystrix爲什麼可以支持者四種異步HTTP請求方式，其實很簡單通過一段源碼就可以看出

HystrixDelegatingContract.parseAndValidatateMetadata方法的四個if else判斷分別對應四個類

package feign.hystrix;

import static feign.Util.resolveLastTypeParameter;

import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.util.List;

import com.netflix.hystrix.HystrixCommand;

import feign.Contract;
import feign.MethodMetadata;
import rx.Completable;
import rx.Observable;
import rx.Single;

/**
 * This special cases methods that return {@link HystrixCommand}, {@link Observable}, or {@link Single} so that they
 * are decoded properly.
 * 
 * <p>For example, {@literal HystrixCommand<Foo>} and {@literal Observable<Foo>} will decode {@code Foo}.
 */
// Visible for use in custom Hystrix invocation handlers
public final class HystrixDelegatingContract implements Contract {


  private final Contract delegate;

  public HystrixDelegatingContract(Contract delegate) {
    this.delegate = delegate;
  }

  @Override
  public List<MethodMetadata> parseAndValidatateMetadata(Class<?> targetType) {
    List<MethodMetadata> metadatas = this.delegate.parseAndValidatateMetadata(targetType);

    for (MethodMetadata metadata : metadatas) {
      Type type = metadata.returnType();

      if (type instanceof ParameterizedType && ((ParameterizedType) type).getRawType().equals(HystrixCommand.class)) {
        Type actualType = resolveLastTypeParameter(type, HystrixCommand.class);
        metadata.returnType(actualType);
      } else if (type instanceof ParameterizedType && ((ParameterizedType) type).getRawType().equals(Observable.class)) {
        Type actualType = resolveLastTypeParameter(type, Observable.class);
        metadata.returnType(actualType);
      } else if (type instanceof ParameterizedType && ((ParameterizedType) type).getRawType().equals(Single.class)) {
        Type actualType = resolveLastTypeParameter(type, Single.class);
        metadata.returnType(actualType);
      } else if (type instanceof ParameterizedType && ((ParameterizedType) type).getRawType().equals(Completable.class)) {
        metadata.returnType(void.class);
      }
    }

    return metadatas;
  }
}

這裏使用了委派模式，具體工作給委派對象，實際就是SpringMvcContract，它負責處理spring MVC 註解方式聲明的Feign接口，所以需要SpringMvcContract。

HystrixCommand

Hystrix命令模式，在這裏不做深度剖析有興趣的同學可以到GitHub官網查看，只針對對在Feign中是如何使用的。

其實在Feign中使用很簡單，HystrixCommand是一個泛型的抽象類，只需在返回類型指定泛型的類型即可

如：HystrixCommand<List<User>>指定List<User>泛型即可

UserFeign.findAll:

@GetMapping
HystrixCommand<List<User>> findAll();

是不是很簡單,那麼HystrixCommand如何使用呢，下面講一下兩個常用方法

HystrixCommand.execute 直接獲取請求結果

這種方式跟java.util.concurrent.Future.get()方法使用方式是一樣的。

啓動FeignApplication服務提供方

運行單元測試UserFeignTest.save保存兩條數據。

UserFeignTest.findAll ，直接將結果打印

    @Test
    public void findAll() {
        HystrixCommand<List<User>> userList = userFeign.findAll();
        //直接獲取結果，這塊可以處理一些業務邏輯，最後需要userList數據調用execute方法
        System.out.println(userList.execute());
    }

[User{id='1', name='張三1'}, User{id='2', name='張三2'}]

HystrixCommand.observe或toObservable 觀察者模式(訂閱發佈)

observe() 是 Hot observables ，toObservable()是 Cold observables

Hot observables

Hot observable 不管有沒有訂閱者訂閱，他們(發佈者/生產者)創建後就開發發射數據流。

Cold observables

只有當有訂閱者訂閱的時候， Cold Observable 纔開始執行發射數據流的代碼。

更多請參考Reactive Execution 或 RxJava 馴服數據流之 hot & cold Observable

Observable<List<User>> listObservable = userList.observe();
Observable<List<User>> listObservable = userList.toObservable();

接下來講下 Observable使用

Observable觀察者模式(訂閱發佈)

Feign接口的方法返回類型也可以是Observable<T>泛型類型可以是任意類型，我們這裏以Observable<User>爲例

由於Hystrix是異步，會出現主線程結束後Hystrix線程同時殺死，導致結果無法打印，在訂閱之後添加TimeUnit.SECONDS.sleep(2)使主線程睡眠2秒鐘。

UserFeign.getUserByID,其他內容省略

@GetMapping("/{id}")
Observable<User> getUserByID(@PathVariable("id") String id);

如果對結果集處理，只需訂閱Observable<User>

Observable<User> user = userFeign.getUserByID("1");
user.subscribe(new Observer<User>() {
           /**
             * 數據發射完成時執行與{@link #onError(Throwable)} 它倆只會執行其中一個方法
             */
            @Override
            public void onCompleted() {
                System.out.println("user處理完成");
            }

            /**
             * 發生錯誤時執行與{@link #onCompleted()} 它倆只會執行其中一個方法
             */
            @Override
            public void onError(Throwable e) {
                System.out.println("user出現異常" + e);
            }

            /**
             * 發射數據流 user
             */
            @Override
            public void onNext(User user) {
                System.out.println("返回數據：" + user);
            }
});

運行單元測試UserFeignTest.getUserByID,輸出結果

返回數據：User{id='1', name='張三'}
user處理完成

Single

Observable的訂閱者Observer.onNext方法可能執行多次，最後執行Observer.onCompleted或Observer.onError(發生異常的情況下),其實在平時開發過程中大多數情況下Observer.onNext只需執行一次就可以獲取到全部結果集，Single的訂閱者Observer.onNext方法只會執行一次就完成了。接下來簡單介紹下Single的使用

UserFeign.getUserByIDSingle 很簡單返回類型指定Single泛型是User即可:

@GetMapping("/{id}")
Single<User> getUserByIDSingle(@PathVariable("id") String id);

運行單元測試UserFeignTest.getUserByIDSingle

Single<User> singleUser = userFeign.getUserByIDSingle("1");
singleUser.subscribe(new Observer<User>() {
    @Override
    public void onCompleted() {
        System.out.println("執行完成");
    }
    @Override
    public void onError(Throwable e) {
        System.out.println("執行錯誤" + e);
    }
    @Override
    public void onNext(User user) {
        System.out.println("返回數據：" + user);
    }
});

輸出結果：

返回數據：User{id='1', name='張三'}
執行完成

Single訂閱者Observer.onNext方法只會執行一次，其實Observer.onCompleted方法沒有什麼作用，再加上我們有的時候不需要處理錯誤Observer.onError，這樣我們就可以簡化代碼了

簡化後的代碼：

Single<User> singleUser = userFeign.getUserByIDSingle("1");
singleUser.subscribe(System.out::println);

Completable

CompletableHTTP客戶端只需知道請求成功或失敗，不需要返回的數據時使用。

這裏以保存爲例UserFeign.save

單元測試UserFeignTest.save

單元測試UserFeignTest.save完成處理

User user = new User();
user.setName("張三4");
Completable completable = userFeign.save(user);
completable.subscribe(() -> System.out.println("保存成功"));

單元測試UserFeignTest.save同步請求阻塞，異常處理，如果沒有異常throwable==null

        User user = new User();
        user.setName("張三4");
        Completable completable = userFeign.save(user);
//        completable.subscribe(() -> System.out.println("保存成功"));
        Throwable throwable = completable.get();
        System.out.println("異常信息："+throwable);

總結

本章節講了如下內容

Spring Cloud Feign HTTP請求異常Fallback容錯機制，它是基於Hystrix實現的，所以要通過配置參數feign.hystrix.enabled=true開啓該功能，及其兩種實現方式。

Fallback工廠方式引出了ErrorDecoder錯誤解碼自定義處理，有三種方式，可根據實際請求選擇，舉一反三其他自定義配置也可以通過這種方式實現如：Decoder、Encoder、Logger(第二、三章有介紹)。

如果開啓的Hystrix就不要用feign的超時配置了,單位是毫秒

feign.client.config.defalut.connect-timeout=10000

defalut是默認配置名稱，可以使用feign.client.default-config替換自定義名稱

feign.client.default-config=my-config
feign.client.config.my-config.connect-timeout=10000

請使用如下屬性配置超時時間，單位毫秒

hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=20000

樣例地址 spring-cloud-feign 分支 Spring-Cloud-Feign-之fallback

寫在最後

Spring Cloud Feign 系列持續更新中。。。。。歡迎關注

如發現哪些知識點有誤或是沒有看懂，請在評論區提出，博主及時改正。

歡迎轉載請註明出處。