Package dev.omnist.algebra

Class AlgebraException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalArgumentException

dev.omnist.algebra.AlgebraException

All Implemented Interfaces:

Serializable

public class AlgebraException
extends IllegalArgumentException

Structured exception thrown when a schema algebra or inference operation fails (omnist-spec §6).

Callers that need to surface algebra/inference errors should inspect:

• getPath() — target schema element path where the error occurred (e.g. "$" or "MyRecord.myField")
• getCode() — machine-readable error code (e.g. algebra.extract-invalidates-root, algebra.infer-mixed-shape)
• Throwable.getMessage() — human-readable message explaining the violation

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
AlgebraException(String path, String code, String message)	Constructs an algebra exception with path, code, and message.
AlgebraException(String path, String code, String message, Throwable cause)	Constructs an algebra exception with path, code, message, and cause.

Method Summary

Modifier and Type	Method	Description
String	getCode()	Returns the machine-readable error code identifying the violation category.
String	getPath()	Returns the schema element path where the error was detected.

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

AlgebraException

public AlgebraException(String path,
 String code,
 String message)

Constructs an algebra exception with path, code, and message.

Parameters:

path - the schema element path where the violation was detected; use "$" for root-level errors

code - the machine-readable error code identifying the error category

message - human-readable explanation of the error

AlgebraException

public AlgebraException(String path,
 String code,
 String message,
 Throwable cause)

Constructs an algebra exception with path, code, message, and cause.

Parameters:

path - the schema element path where the violation was detected; use "$" for root-level errors

code - the machine-readable error code identifying the error category

message - human-readable explanation of the error

cause - the underlying exception

Method Details

getPath

public String getPath()

Returns the schema element path where the error was detected.

getCode

public String getCode()

Returns the machine-readable error code identifying the violation category.