Package dev.omnist.oml

Class OmlParseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

dev.omnist.oml.OmlParseException

All Implemented Interfaces:

Serializable

public class OmlParseException
extends RuntimeException

Structured exception thrown when an OML document fails to parse (omnist-spec §8).

Callers that need to surface parse errors to users should inspect:

• getLine() and getColumn() — the 1-based source location
• getCode() — a machine-readable error code (e.g. parse.unterminated-string)
• Throwable.getMessage() — a human-readable message combining location, code, and description

This exception is thrown by OmlLexer and OmlReader for any lexical or structural violation, including unterminated strings, unexpected tokens, reserved-word labels, empty arrays, and exceeded safety limits.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
OmlParseException(int line, int column, String code, String message)	Constructs an OML parse exception with full location and code details.
OmlParseException(int line, int column, String code, String diagnosticPath, String message)	Constructs an OML parse exception whose diagnostic path is a Document path rather than a text position, as E-11 requires for the document.* family (for example document.limit.depth).

Method Summary

Modifier and Type	Method	Description
String	getCode()	Returns the machine-readable error code identifying the violation category, e.g.
int	getColumn()	Returns the 1-based column number in the OML source where the error was detected.
int	getLine()	Returns the 1-based line number in the OML source where the error was detected.
String	getPath()	Returns a location string in the form "line:column", identical to the prefix of Throwable.getMessage().

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

OmlParseException

public OmlParseException(int line,
 int column,
 String code,
 String message)

Constructs an OML parse exception with full location and code details.

Parameters:

line - 1-based line number in the OML source where the error was detected

column - 1-based column number in the OML source where the error was detected

code - machine-readable error code identifying the violation category, e.g. parse.unterminated-string, document.limit.depth

message - human-readable description of the error

OmlParseException

public OmlParseException(int line,
 int column,
 String code,
 String diagnosticPath,
 String message)

Constructs an OML parse exception whose diagnostic path is a Document path rather than a text position, as E-11 requires for the document.* family (for example document.limit.depth). The line and column still locate the failure in the message.

Parameters:

line - 1-based line number where the error was detected

column - 1-based column number where the error was detected

code - machine-readable error code

diagnosticPath - the diagnostic path: line:col for parse.*, a Document path such as $.n for document.*

message - human-readable description of the violation

Method Details

getLine

public int getLine()

Returns the 1-based line number in the OML source where the error was detected.

getColumn

public int getColumn()

Returns the 1-based column number in the OML source where the error was detected.

getCode

public String getCode()

Returns the machine-readable error code identifying the violation category, e.g. parse.unterminated-string or document.limit.int-digits.

getPath

public String getPath()

Returns a location string in the form "line:column", identical to the prefix of Throwable.getMessage().