Class ProviderException

java.lang.Object

java.lang.Throwable

java.lang.Exception

ai.doctruth.ProviderException

All Implemented Interfaces:

Serializable

public class ProviderException
extends Exception

Thrown by Layer 2 LLM providers (Anthropic, OpenAI, Gemini, DeepSeek) when an upstream call fails. Carries the provider name, the HTTP status (when applicable), and a retryable flag so the extraction loop can decide whether to back off or fail fast.

Checked.

Invariants:

• errorCode non-null and non-blank.
• message non-null.
• providerName non-null and non-blank.
• httpStatus is a non-null OptionalInt; pass OptionalInt.empty() (not null) for non-HTTP failures (timeout, DNS, schema-validation failure).

Since:

0.1.0

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ProviderException(String errorCode, String message, String providerName, OptionalInt httpStatus, boolean retryable)
ProviderException(String errorCode, String message, String providerName, OptionalInt httpStatus, boolean retryable, Throwable cause)

Method Summary

Modifier and Type	Method	Description
String	errorCode()
OptionalInt	httpStatus()
String	providerName()
boolean	retryable()

Methods inherited from class Throwable

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

Methods inherited from class Object

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

Constructor Details

ProviderException

public ProviderException(String errorCode,
 String message,
 String providerName,
 OptionalInt httpStatus,
 boolean retryable)

ProviderException

public ProviderException(String errorCode,
 String message,
 String providerName,
 OptionalInt httpStatus,
 boolean retryable,
 Throwable cause)

Method Details

errorCode

public String errorCode()

providerName

public String providerName()

httpStatus

public OptionalInt httpStatus()

retryable

public boolean retryable()