Module io.github.teceli.resiliencia.patterns

Package io.github.teceli.resiliencia.patterns.bulkhead

Class BulkheadFullException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.github.teceli.resiliencia.core.api.ResilientException

io.github.teceli.resiliencia.patterns.bulkhead.BulkheadFullException

All Implemented Interfaces:

Serializable

public final class BulkheadFullException
extends ResilientException

Thrown when a Bulkhead rejects a call because all permits are in use and no permit became available within the configured maximum wait time.

The name carried by this exception is the bulkhead's own name, which must be a static, compile-time-known string — never request-derived or tenant-derived. It is used as a cardinality-bounded key/tag in metrics and logging; unbounded distinct names would cause unbounded memory growth in metrics backends.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
BulkheadFullException(String name, int maxConcurrentCalls, Duration maxWait)

Method Summary

Modifier and Type	Method	Description
int	maxConcurrentCalls()	The concurrency limit that was reached.
Duration	maxWait()	How long the call waited for a permit before being rejected (zero means fail-fast).
String	name()	The bulkhead instance name.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

BulkheadFullException

public BulkheadFullException(String name,
 int maxConcurrentCalls,
 Duration maxWait)

Method Details

name

public String name()

The bulkhead instance name.

maxConcurrentCalls

public int maxConcurrentCalls()

The concurrency limit that was reached.

maxWait

public Duration maxWait()

How long the call waited for a permit before being rejected (zero means fail-fast).