io.github.resilience4j.circuitbreaker.internal

Class CircuitBreakerStateMachine

java.lang.Object

io.github.resilience4j.circuitbreaker.internal.CircuitBreakerStateMachine

All Implemented Interfaces:

CircuitBreaker

public final class CircuitBreakerStateMachine
extends java.lang.Object
implements CircuitBreaker

A CircuitBreaker finite state machine.

Nested Class Summary

Nested classes/interfaces inherited from interface io.github.resilience4j.circuitbreaker.CircuitBreaker

CircuitBreaker.EventPublisher, CircuitBreaker.Metrics, CircuitBreaker.State, CircuitBreaker.StateTransition

Constructor Summary

Constructors

Constructor and Description
CircuitBreakerStateMachine(java.lang.String name) Creates a circuitBreaker with default config.
CircuitBreakerStateMachine(java.lang.String name, CircuitBreakerConfig circuitBreakerConfig) Creates a circuitBreaker.
CircuitBreakerStateMachine(java.lang.String name, java.util.function.Supplier<CircuitBreakerConfig> circuitBreakerConfig) Creates a circuitBreaker.

Method Summary

Modifier and Type	Method and Description
CircuitBreakerConfig	getCircuitBreakerConfig() Get the config of this CircuitBreaker.
CircuitBreaker.EventPublisher	getEventPublisher() Returns an EventPublisher which can be used to register event consumers.
CircuitBreaker.Metrics	getMetrics() Returns the Metrics of this CircuitBreaker.
java.lang.String	getName() Get the name of this CircuitBreaker.
CircuitBreaker.State	getState() Get the state of this CircuitBreaker.
boolean	isCallPermitted() Requests permission to call this backend.
void	onError(long durationInNanos, java.lang.Throwable throwable) Records a failed call.
void	onSuccess(long durationInNanos) Records a successful call.
void	reset() Returns the circuit breaker to its original closed state, losing statistics.
java.lang.String	toString()
void	transitionToClosedState() Transitions the state machine to CLOSED state.
void	transitionToDisabledState() Transitions the state machine to a DISABLED state, stopping state transition, metrics and event publishing.
void	transitionToForcedOpenState() Transitions the state machine to a FORCED_OPEN state, stopping state transition, metrics and event publishing.
void	transitionToHalfOpenState() Transitions the state machine to HALF_OPEN state.
void	transitionToOpenState() Transitions the state machine to OPEN state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.github.resilience4j.circuitbreaker.CircuitBreaker

decorateCallable, decorateCheckedConsumer, decorateCheckedFunction, decorateCheckedRunnable, decorateCheckedSupplier, decorateCompletionStage, decorateConsumer, decorateFunction, decorateRunnable, decorateSupplier, executeCallable, executeCheckedSupplier, executeCompletionStage, executeRunnable, executeSupplier, of, of, ofDefaults

Constructor Detail

CircuitBreakerStateMachine

public CircuitBreakerStateMachine(java.lang.String name,
                                  CircuitBreakerConfig circuitBreakerConfig)

Creates a circuitBreaker.

Parameters:

name - the name of the CircuitBreaker

circuitBreakerConfig - The CircuitBreaker configuration.

CircuitBreakerStateMachine

public CircuitBreakerStateMachine(java.lang.String name)

Creates a circuitBreaker with default config.

Parameters:

name - the name of the CircuitBreaker

CircuitBreakerStateMachine

public CircuitBreakerStateMachine(java.lang.String name,
                                  java.util.function.Supplier<CircuitBreakerConfig> circuitBreakerConfig)

Creates a circuitBreaker.

Parameters:

name - the name of the CircuitBreaker

circuitBreakerConfig - The CircuitBreaker configuration supplier.

Method Detail

isCallPermitted

public boolean isCallPermitted()

Requests permission to call this backend.

Specified by:

isCallPermitted in interface CircuitBreaker

Returns:

true, if the call is allowed.

onError

public void onError(long durationInNanos,
                    java.lang.Throwable throwable)

Description copied from interface: CircuitBreaker

Records a failed call. This method must be invoked when a call failed.

Specified by:

onError in interface CircuitBreaker

Parameters:

durationInNanos - The elapsed time duration of the call

throwable - The throwable which must be recorded

onSuccess

public void onSuccess(long durationInNanos)

Description copied from interface: CircuitBreaker

Records a successful call.

Specified by:

onSuccess in interface CircuitBreaker

Parameters:

durationInNanos - The elapsed time duration of the call This method must be invoked when a call was successful.

getState

public CircuitBreaker.State getState()

Get the state of this CircuitBreaker.

Specified by:

getState in interface CircuitBreaker

Returns:

the the state of this CircuitBreaker

getName

public java.lang.String getName()

Get the name of this CircuitBreaker.

Specified by:

getName in interface CircuitBreaker

Returns:

the the name of this CircuitBreaker

getCircuitBreakerConfig

public CircuitBreakerConfig getCircuitBreakerConfig()

Get the config of this CircuitBreaker.

Specified by:

getCircuitBreakerConfig in interface CircuitBreaker

Returns:

the config of this CircuitBreaker

getMetrics

public CircuitBreaker.Metrics getMetrics()

Description copied from interface: CircuitBreaker

Returns the Metrics of this CircuitBreaker.

Specified by:

getMetrics in interface CircuitBreaker

Returns:

the Metrics of this CircuitBreaker

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

reset

public void reset()

Description copied from interface: CircuitBreaker

Returns the circuit breaker to its original closed state, losing statistics. Should only be used, when you want to want to fully reset the circuit breaker without creating a new one.

Specified by:

reset in interface CircuitBreaker

transitionToDisabledState

public void transitionToDisabledState()

Description copied from interface: CircuitBreaker

Transitions the state machine to a DISABLED state, stopping state transition, metrics and event publishing. Should only be used, when you want to disable the circuit breaker allowing all calls to pass. To recover from this state you must force a new state transition

Specified by:

transitionToDisabledState in interface CircuitBreaker

transitionToForcedOpenState

public void transitionToForcedOpenState()

Description copied from interface: CircuitBreaker

Transitions the state machine to a FORCED_OPEN state, stopping state transition, metrics and event publishing. Should only be used, when you want to disable the circuit breaker allowing no call to pass. To recover from this state you must force a new state transition

Specified by:

transitionToForcedOpenState in interface CircuitBreaker

transitionToClosedState

public void transitionToClosedState()

Description copied from interface: CircuitBreaker

Transitions the state machine to CLOSED state. Should only be used, when you want to force a state transition. State transition are normally done internally.

Specified by:

transitionToClosedState in interface CircuitBreaker

transitionToOpenState

public void transitionToOpenState()

Description copied from interface: CircuitBreaker

Transitions the state machine to OPEN state. Should only be used, when you want to force a state transition. State transition are normally done internally.

Specified by:

transitionToOpenState in interface CircuitBreaker

transitionToHalfOpenState

public void transitionToHalfOpenState()

Description copied from interface: CircuitBreaker

Transitions the state machine to HALF_OPEN state. Should only be used, when you want to force a state transition. State transition are normally done internally.

Specified by:

transitionToHalfOpenState in interface CircuitBreaker

getEventPublisher

public CircuitBreaker.EventPublisher getEventPublisher()

Description copied from interface: CircuitBreaker

Returns an EventPublisher which can be used to register event consumers.

Specified by:

getEventPublisher in interface CircuitBreaker

Returns:

an EventPublisher