com.lightbend.lagom.javadsl.client

Interface CircuitBreakersPanel

public interface CircuitBreakersPanel

A CircuitBreakersPanel is a central point collecting all circuit breakers in Lagom.

Calls to remote services can make use of this facility in order to add circuit breaking capabilities to it.

Method Summary

Modifier and Type	Method and Description
<T> CompletionStage<T>	withCircuitBreaker(String id, Supplier<CompletionStage<T>> body) Executes body in the context of the circuit breaker identified by id.

Method Detail

withCircuitBreaker

<T> CompletionStage<T> withCircuitBreaker(String id,
                                          Supplier<CompletionStage<T>> body)

Executes body in the context of the circuit breaker identified by id. Whether body.get() is actually invoked is implementation-dependent, but implementations should call it at most once.

Type Parameters:

T - the result type

Parameters:

id - the unique identifier for the circuit breaker to use (often a service name)

body - effect to (optionally) execute within the context of the circuit breaker. May throw a RuntimeException to signal failure.

Returns:

a completion stage yielding either the same result as body.get(), or failing with an implementation-dependent exception.