擴展Spring Cloud Feign 實現自動降級

時間 2019-11-26

標籤擴展 spring cloud feign 實現自動降級欄目 Spring 简体版

原文原文鏈接

自動降級目的

在Spring Cloud 使用feign 的時候，須要明確指定fallback 策略，否則會提示錯誤。
先來看默認的feign service 是要求怎麼作的。feign service 定義一個 factory 和 fallback 的類git

@FeignClient(value = ServiceNameConstants.UMPS_SERVICE, fallbackFactory = RemoteLogServiceFallbackFactory.class)
public interface RemoteLogService {}
複製代碼

可是咱們大多數狀況的feign 降級策略爲了保證冪等都會很簡單，輸出錯誤日誌便可。相似以下代碼，在企業中開發很是不方便github

@Slf4j
@Component
public class RemoteLogServiceFallbackImpl implements RemoteLogService {
	@Setter
	private Throwable cause;


	@Override
	public R<Boolean> saveLog(SysLog sysLog, String from) {
		log.error("feign 插入日誌失敗", cause);
		return null;
	}
}
複製代碼

自動降級效果

@FeignClient(value = ServiceNameConstants.UMPS_SERVICE)
public interface RemoteLogService {}
複製代碼

Feign Service 完成一樣的降級錯誤輸出
FeignClient 中無需定義無用的fallbackFactory
FallbackFactory 也無需註冊到Spring 容器中

代碼變化，去掉FeignClient 指定的降級工廠

代碼變化，刪除降級相關的代碼

核心源碼

注入咱們個性化後的Feign

@Configuration
@ConditionalOnClass({HystrixCommand.class, HystrixFeign.class})
protected static class HystrixFeignConfiguration {
	@Bean
	@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
	@ConditionalOnProperty("feign.hystrix.enabled")
	public Feign.Builder feignHystrixBuilder(FeignContext feignContext) {
		return PigxHystrixFeign.builder(feignContext)
				.decode404()
				.errorDecoder(new PigxFeignErrorDecoder());
	}
}
複製代碼

PigxHystrixFeign.target 方法是根據@FeignClient 註解生成代理類的過程，注意註釋

@Override
public <T> T target(Target<T> target) {
	Class<T> targetType = target.type();
	FeignClient feignClient = AnnotatedElementUtils.getMergedAnnotation(targetType, FeignClient.class);
	String factoryName = feignClient.name();
	SetterFactory setterFactoryBean = this.getOptional(factoryName, feignContext, SetterFactory.class);
	if (setterFactoryBean != null) {
		this.setterFactory(setterFactoryBean);
	}
	
	// 如下爲獲取降級策略代碼，構建降級，這裏去掉了降級非空的非空的校驗
	Class<?> fallback = feignClient.fallback();
	if (fallback != void.class) {
		return targetWithFallback(factoryName, feignContext, target, this, fallback);
	}
	Class<?> fallbackFactory = feignClient.fallbackFactory();
	if (fallbackFactory != void.class) {
		return targetWithFallbackFactory(factoryName, feignContext, target, this, fallbackFactory);
	}
	return build().newInstance(target);
}
複製代碼

構建feign 客戶端執行PigxHystrixInvocationHandler的加強

Feign build(@Nullable final FallbackFactory<?> nullableFallbackFactory) {
		super.invocationHandlerFactory((target, dispatch) ->
				new PigxHystrixInvocationHandler(target, dispatch, setterFactory, nullableFallbackFactory));
		super.contract(new HystrixDelegatingContract(contract));
		return super.build();
	}
複製代碼

PigxHystrixInvocationHandler.getFallback() 獲取降級策略

@Override
	@Nullable
	@SuppressWarnings("unchecked")
	protected Object getFallback() {
	        // 若是 @FeignClient  沒有配置降級策略，使用動態代理建立一個
			if (fallbackFactory == null) {
				fallback = PigxFeignFallbackFactory.INSTANCE.create(target.type(), getExecutionException());
			} else {
			  // 若是 @FeignClient配置降級策略，使用配置的
				fallback = fallbackFactory.create(getExecutionException());
			}
	}
複製代碼

PigxFeignFallbackFactory.create 動態代理邏輯

public T create(final Class<?> type, final Throwable cause) {
		return (T) FALLBACK_MAP.computeIfAbsent(type, key -> {
			Enhancer enhancer = new Enhancer();
			enhancer.setSuperclass(key);
			enhancer.setCallback(new PigxFeignFallbackMethod(type, cause));
			return enhancer.create();
		});
	}
複製代碼

PigxFeignFallbackMethod.intercept，默認的降級邏輯，輸出降級方法信息和錯誤信息，而且把錯誤格式

public Object intercept(Object o, Method method, Object[] objects, MethodProxy methodProxy) {
	log.error("Fallback class:[{}] method:[{}] message:[{}]",
			type.getName(), method.getName(), cause.getMessage());

	if (R.class == method.getReturnType()) {
		final R result = cause instanceof PigxFeignException ?
				((PigxFeignException) cause).getResult() : R.builder()
				.code(CommonConstants.FAIL)
				.msg(cause.getMessage()).build();
		return result;
	}
	return null;
}
複製代碼