Интеграция Hystrix с существующим приложением Spring

1. Обзор

В ссылке:/Знакомство с Hystrix[последняя статья]мы рассмотрели основы Hystrix и то, как она может помочь в создании отказоустойчивого и отказоустойчивого приложения.

  • Существует множество существующих приложений Spring, которые выполняют вызовы во внешние системы, которые выиграют от Hystrix. ** К сожалению, может оказаться невозможным переписать эти приложения для интеграции Hystrix, однако возможен неинвазивный способ интеграции Hystrix с помощь Spring AOP .

В этой статье мы рассмотрим, как интегрировать Hystrix с существующим приложением Spring.

2. Hystrix в приложении Spring

2.1. Существующее приложение

Давайте посмотрим на существующий клиентский клиент приложения, который выполняет вызов RemoteServiceTestSimulator , который мы создали в предыдущей статье:

@Component("springClient")
public class SpringExistingClient {

    @Value("${remoteservice.timeout}")
    private int remoteServiceDelay;

    public String invokeRemoteServiceWithOutHystrix() throws InterruptedException {
        return new RemoteServiceTestSimulator(remoteServiceDelay).execute();
    }
}

Как видно из приведенного выше фрагмента кода, метод invokeRemoteServiceWithOutHystrix отвечает за выполнение вызовов удаленной службы RemoteServiceTestSimulator . Конечно, приложения реального мира не будут такими простыми.

2.2. Создать совет вокруг

Чтобы продемонстрировать, как интегрировать Hystrix, мы собираемся использовать этот клиент в качестве примера.

Для этого мы определим совет Around , который будет срабатывать при выполнении invokeRemoteService :

@Around("@annotation(com.baeldung.hystrix.HystrixCircuitBreaker)")
public Object circuitBreakerAround(ProceedingJoinPoint aJoinPoint) {
    return new RemoteServiceCommand(config, aJoinPoint).execute();
}

Приведенный выше совет разработан как Around совет, который должен быть выполнен в точке, обозначенной @ HystrixCircuitBreaker .

Теперь давайте посмотрим определение аннотации HystrixCircuitBreaker _: _

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface HystrixCircuitBreaker {}

2.3. Hystrix Logic

Теперь давайте посмотрим на RemoteServiceCommand . Он реализован в виде статического внутреннего класса в примере кода, чтобы инкапсулировать логику вызова Hystrix:

private static class RemoteServiceCommand extends HystrixCommand<String> {

    private ProceedingJoinPoint joinPoint;

    RemoteServiceCommand(Setter config, ProceedingJoinPoint joinPoint) {
        super(config);
        this.joinPoint = joinPoint;
    }

    @Override
    protected String run() throws Exception {
        try {
            return (String) joinPoint.proceed();
        } catch (Throwable th) {
            throw new Exception(th);
        }
    }
}

Полную реализацию компонента Aspect можно увидеть на here .

2.4. Аннотировать с помощью @ HystrixCircuitBreaker

После определения аспекта мы можем аннотировать наш клиентский метод с помощью @ HystrixCircuitBreaker , как показано ниже, и Hystrix будет вызываться для каждого вызова аннотированных методов:

@HystrixCircuitBreaker
public String invokeRemoteServiceWithHystrix() throws InterruptedException{
    return new RemoteServiceTestSimulator(remoteServiceDelay).execute();
}

Приведенный ниже интеграционный тест продемонстрирует разницу между маршрутом Hystrix и маршрутом без Hystrix.

2.5. Протестируйте интеграцию

В целях демонстрации мы определили два пути выполнения метода: один с Hystrix, а другой без.

public class SpringAndHystrixIntegrationTest {

    @Autowired
    private HystrixController hystrixController;

    @Test(expected = HystrixRuntimeException.class)
    public void givenTimeOutOf15000__whenClientCalledWithHystrix__thenExpectHystrixRuntimeException()
      throws InterruptedException {
        hystrixController.withHystrix();
    }

    @Test
    public void givenTimeOutOf15000__whenClientCalledWithOutHystrix__thenExpectSuccess()
      throws InterruptedException {
        assertThat(hystrixController.withOutHystrix(), equalTo("Success"));
    }
}

Когда тест будет выполнен, вы увидите, что вызов метода без Hystrix будет ожидать всего времени выполнения удаленной службы, тогда как маршрут Hystrix будет закорачивать и выбрасывать HystrixRuntimeException после определенного времени ожидания, которое в нашем случае составляет 10 секунд.

3. Вывод

Мы можем создать один аспект для каждого вызова удаленной службы, который мы хотим сделать с различными конфигурациями. В следующей статье мы рассмотрим интеграцию Hystrix с самого начала проекта.

Весь код в этой статье можно найти в хранилище GitHub .