gudusoft.gsqlparser.pp2

Class FormatDiagnostic

Object

gudusoft.gsqlparser.pp2.FormatDiagnostic

public final class FormatDiagnostic
extends Object

A single diagnostic event produced by the pp2 engine — a recovered parse failure, a tokenizer gap, a guard fall-through, etc.

Immutable. Carries the byte-span on the original input that the diagnostic refers to, a FormatDiagnostic.Severity, a human-readable message, and (optionally) the underlying TSyntaxError from the parser when the diagnostic was triggered by a parse failure.

Severity policy follows plan §12. Briefly: INFO for routine notes (e.g., region too large to parse), WARNING for recovered conditions (e.g., AST delegate guard fell through), ERROR for parse failures and renderer fall-throughs, FATAL for invariant violations that should never occur in practice.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FormatDiagnostic.Severity Severity level.

Constructor Summary

Constructors

Constructor and Description
FormatDiagnostic(FormatDiagnostic.Severity severity, int startOffset, int endOffset, String message)
FormatDiagnostic(FormatDiagnostic.Severity severity, int startOffset, int endOffset, String message, TSyntaxError parserError)

Method Summary

Modifier and Type	Method and Description
int	getEndOffset()
String	getMessage()
TSyntaxError	getParserError() May be null if the diagnostic did not originate from a parser failure.
FormatDiagnostic.Severity	getSeverity()
int	getStartOffset()
String	toString()

Methods inherited from class Object

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

Constructor Detail

FormatDiagnostic

public FormatDiagnostic(FormatDiagnostic.Severity severity,
                        int startOffset,
                        int endOffset,
                        String message)

FormatDiagnostic

public FormatDiagnostic(FormatDiagnostic.Severity severity,
                        int startOffset,
                        int endOffset,
                        String message,
                        TSyntaxError parserError)

Method Detail

getSeverity

public FormatDiagnostic.Severity getSeverity()

getStartOffset

public int getStartOffset()

getEndOffset

public int getEndOffset()

getMessage

public String getMessage()

getParserError

public TSyntaxError getParserError()

May be null if the diagnostic did not originate from a parser failure.

toString

public String toString()

Overrides:

toString in class Object