io.github.resilience4j.bulkhead.internal

Class SemaphoreBulkhead

java.lang.Object

io.github.resilience4j.bulkhead.internal.SemaphoreBulkhead

All Implemented Interfaces:

Bulkhead

public class SemaphoreBulkhead
extends java.lang.Object
implements Bulkhead

A Bulkhead implementation based on a semaphore.

Nested Class Summary

Nested classes/interfaces inherited from interface io.github.resilience4j.bulkhead.Bulkhead

Bulkhead.EventPublisher, Bulkhead.Metrics

Constructor Summary

Constructors

Constructor and Description
SemaphoreBulkhead(java.lang.String name) Creates a bulkhead with a default config.
SemaphoreBulkhead(java.lang.String name, BulkheadConfig bulkheadConfig) Creates a bulkhead using a configuration supplied
SemaphoreBulkhead(java.lang.String name, java.util.function.Supplier<BulkheadConfig> configSupplier) Create a bulkhead using a configuration supplier

Method Summary

Modifier and Type	Method and Description
void	changeConfig(BulkheadConfig newConfig) Dynamic bulkhead configuration change.
BulkheadConfig	getBulkheadConfig() Returns the BulkheadConfig of this Bulkhead.
Bulkhead.EventPublisher	getEventPublisher() Returns an EventPublisher which subscribes to the reactive stream of BulkheadEvent and can be used to register event consumers.
Bulkhead.Metrics	getMetrics() Get the Metrics of this Bulkhead.
java.lang.String	getName() Returns the name of this bulkhead.
boolean	isCallPermitted() Attempts to acquire a permit, which allows an call to be executed.
void	onComplete() Records a completed call.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.github.resilience4j.bulkhead.Bulkhead

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

Constructor Detail

SemaphoreBulkhead

public SemaphoreBulkhead(java.lang.String name,
                         @Nullable
                         BulkheadConfig bulkheadConfig)

Creates a bulkhead using a configuration supplied

Parameters:

name - the name of this bulkhead

bulkheadConfig - custom bulkhead configuration

SemaphoreBulkhead

public SemaphoreBulkhead(java.lang.String name)

Creates a bulkhead with a default config.

Parameters:

name - the name of this bulkhead

SemaphoreBulkhead

public SemaphoreBulkhead(java.lang.String name,
                         java.util.function.Supplier<BulkheadConfig> configSupplier)

Create a bulkhead using a configuration supplier

Parameters:

name - the name of this bulkhead

configSupplier - BulkheadConfig supplier

Method Detail

changeConfig

public void changeConfig(BulkheadConfig newConfig)

Dynamic bulkhead configuration change. NOTE! New `maxWaitTime` duration won't affect threads that are currently waiting for permission.

Specified by:

changeConfig in interface Bulkhead

Parameters:

newConfig - new BulkheadConfig

isCallPermitted

public boolean isCallPermitted()

Attempts to acquire a permit, which allows an call to be executed.

Specified by:

isCallPermitted in interface Bulkhead

Returns:

boolean whether a call should be executed

onComplete

public void onComplete()

Records a completed call.

Specified by:

onComplete in interface Bulkhead

getName

public java.lang.String getName()

Returns the name of this bulkhead.

Specified by:

getName in interface Bulkhead

Returns:

the name of this bulkhead

getBulkheadConfig

public BulkheadConfig getBulkheadConfig()

Returns the BulkheadConfig of this Bulkhead.

Specified by:

getBulkheadConfig in interface Bulkhead

Returns:

bulkhead config

getMetrics

public Bulkhead.Metrics getMetrics()

Get the Metrics of this Bulkhead.

Specified by:

getMetrics in interface Bulkhead

Returns:

the Metrics of this Bulkhead

getEventPublisher

public Bulkhead.EventPublisher getEventPublisher()

Returns an EventPublisher which subscribes to the reactive stream of BulkheadEvent and can be used to register event consumers.

Specified by:

getEventPublisher in interface Bulkhead

Returns:

an EventPublisher

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object