Interface CircuitBreakerConfig

All Superinterfaces:
Prototype.Api, Prototype.Factory<CircuitBreaker>
All Known Implementing Classes:
CircuitBreakerConfig.BuilderBase.CircuitBreakerConfigImpl
public interface CircuitBreakerConfig extends Prototype.Api
Configuration of a circuit breaker.
See Also:

  • Field Details

    • DEFAULT_ERROR_RATIO

      static final int DEFAULT_ERROR_RATIO
      Default error ratio.
      See Also:

    • DEFAULT_SUCCESS_THRESHOLD

      static final int DEFAULT_SUCCESS_THRESHOLD
      Default success threshold.
      See Also:

    • DEFAULT_VOLUME

      static final int DEFAULT_VOLUME
      Default volume.
      See Also:

  • Method Details

    • builder

      static CircuitBreakerConfig.Builder builder()
      Create a new fluent API builder to customize configuration.
      Returns:
      a new builder

    • builder

      static CircuitBreakerConfig.Builder builder(CircuitBreakerConfig instance)
      Create a new fluent API builder from an existing instance.
      Parameters:
      instance - an existing instance used as a base for the builder
      Returns:
      a builder based on an instance

    • create

      static CircuitBreakerConfig create(Config config)
      Create a new instance from configuration.
      Parameters:
      config - used to configure the new instance
      Returns:
      a new instance configured from configuration

    • create

      static CircuitBreakerConfig create()
      Create a new instance with default values.
      Returns:
      a new instance

    • name

      Optional<String> name()
      Name of this circuit breaker.
      Returns:
      name

    • delay

      Duration delay()
      How long to wait before transitioning from open to half-open state; must not be negative and must be small enough to represent in milliseconds.
      Returns:
      delay

    • errorRatio

      int errorRatio()
      How many failures out of 100 will trigger the circuit to open; must be between 1 and 100, inclusive, and its product with the configured volume must not exceed 2,147,483,647. This is adapted to the volume() used to handle the window of requests.

      If errorRatio is 40, and volume is 10, 4 failed requests will open the circuit. Default is 60.

      Returns:
      percent of failure that trigger the circuit to open
      See Also:

    • volume

      int volume()
      Rolling window size used to calculate ratio of failed requests; must be at least 1 and its product with the configured error ratio must not exceed 2,147,483,647. Default is 10.
      Returns:
      how big a window is used to calculate error errorRatio
      See Also:

    • successThreshold

      int successThreshold()
      How many successful calls will close a half-open circuit; must be at least 1. Nevertheless, the first failed call will open the circuit again. Default is 1.
      Returns:
      number of calls

    • executor

      Optional<ExecutorService> executor()
      Executor service to schedule future tasks.
      Returns:
      executor to use

    • skipOn

      Set<Class<? extends Throwable>> skipOn()
      These throwables will not be considered failures, all other will.
      Returns:
      throwable classes to not be considered a failure
      See Also:

    • applyOn

      Set<Class<? extends Throwable>> applyOn()
      These throwables will be considered failures.
      Returns:
      throwable classes to be considered a failure
      See Also:

    • enableMetrics

      boolean enableMetrics()
      Flag to enable metrics for this instance. The value of this flag is combined with the global config entry FaultTolerance.FT_METRICS_DEFAULT_ENABLED. If either of these flags is true, then metrics will be enabled for the instance.
      Returns:
      metrics enabled flag