Package com.tnsai.exceptions

Class RateLimitException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.tnsai.exceptions.TnsAIException

com.tnsai.exceptions.RateLimitException

All Implemented Interfaces:

Serializable

public class RateLimitException
extends TnsAIException

Exception for rate limit errors (HTTP 429, quota exceeded). Retryable after waiting for the suggested delay.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
RateLimitException(String message)
RateLimitException(String message, Long retryAfterMs)
RateLimitException(String service, Long retryAfterMs, Integer remainingQuota)

Method Summary

Modifier and Type	Method	Description
static RateLimitException	apiRateLimit(String endpoint, long retryAfterMs)	Factory method for API rate limit.
static RateLimitException	fromHttp429(String service, String retryAfterHeader)	Factory method for HTTP 429 responses.
int	getMaxRetryAttempts()	Gets maximum recommended retry attempts.
Integer	getRemainingQuota()
Long	getRetryAfterMs()
String	getService()
long	getSuggestedRetryDelayMs()	Gets suggested retry delay in milliseconds.
static RateLimitException	llmQuotaExceeded(String model)	Factory method for LLM quota exceeded.

Methods inherited from class com.tnsai.exceptions.TnsAIException

getContext, getErrorCode, getMessage, getThrownAt, isRetryable, wrap

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

RateLimitException

public RateLimitException(String message)

RateLimitException

public RateLimitException(String message,
 Long retryAfterMs)

RateLimitException

public RateLimitException(String service,
 Long retryAfterMs,
 Integer remainingQuota)

Method Details

getRetryAfterMs

public Long getRetryAfterMs()

getService

public String getService()

getRemainingQuota

public Integer getRemainingQuota()

getSuggestedRetryDelayMs

public long getSuggestedRetryDelayMs()

Description copied from class: TnsAIException

Gets suggested retry delay in milliseconds. Override in subclasses for specific retry strategies.

Overrides:

getSuggestedRetryDelayMs in class TnsAIException

getMaxRetryAttempts

public int getMaxRetryAttempts()

Description copied from class: TnsAIException

Gets maximum recommended retry attempts.

Overrides:

getMaxRetryAttempts in class TnsAIException

fromHttp429

public static RateLimitException fromHttp429(String service,
 String retryAfterHeader)

Factory method for HTTP 429 responses.

llmQuotaExceeded

public static RateLimitException llmQuotaExceeded(String model)

Factory method for LLM quota exceeded.

apiRateLimit

public static RateLimitException apiRateLimit(String endpoint,
 long retryAfterMs)

Factory method for API rate limit.