Class TechnicalException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.fluxzero.sdk.common.exception.TechnicalException

All Implemented Interfaces:

Serializable

public class TechnicalException
extends RuntimeException

Exception indicating a technical or unexpected failure within the application.

Unlike FunctionalException, which is designed to communicate business or user-facing errors, TechnicalException represents low-level, infrastructure, or unforeseen errors such as I/O issues, serialization failures, or unexpected runtime failures.

These exceptions are typically used to wrap application exceptions or surface errors that should not be transferred to clients or external systems. However, they are still serialized cleanly (without stack traces) for logging or fallback handling.

Stack traces and suppressed exceptions are excluded to prevent information leakage during serialization.

See Also:

• FunctionalException
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TechnicalException()
TechnicalException(FluxzeroErrorReport fluxzeroErrorReport)
TechnicalException(FluxzeroErrorReport fluxzeroErrorReport, Throwable cause)
TechnicalException(String message)
TechnicalException(String message, Throwable cause)
TechnicalException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace)
TechnicalException(Throwable cause)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
String	getDocumentationUrl()	Returns the documentation URL for the error code, if available.
String	getErrorCode()	Returns the stable Fluxzero error code, if available.
FluxzeroErrorReport	getFluxzeroErrorReport()	Returns the structured Fluxzero report backing this exception, if this exception was created from one.
int	hashCode()

Methods inherited from class Throwable

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

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

TechnicalException

public TechnicalException()

TechnicalException

public TechnicalException(String message)

TechnicalException

public TechnicalException(String message,
 Throwable cause)

TechnicalException

public TechnicalException(Throwable cause)

TechnicalException

public TechnicalException(FluxzeroErrorReport fluxzeroErrorReport)

TechnicalException

public TechnicalException(FluxzeroErrorReport fluxzeroErrorReport,
 Throwable cause)

TechnicalException

public TechnicalException(String message,
 Throwable cause,
 boolean enableSuppression,
 boolean writableStackTrace)

Method Details

getFluxzeroErrorReport

public FluxzeroErrorReport getFluxzeroErrorReport()

Returns the structured Fluxzero report backing this exception, if this exception was created from one.

getErrorCode

public String getErrorCode()

Returns the stable Fluxzero error code, if available.

getDocumentationUrl

public String getDocumentationUrl()

Returns the documentation URL for the error code, if available.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object