gudusoft.gsqlparser.ir.semantic

Class RecoveryMetadata

Object

gudusoft.gsqlparser.ir.semantic.RecoveryMetadata

public final class RecoveryMetadata
extends Object

Immutable sidecar that links recovered Semantic IR subjects to the root diagnostics that caused recovery.

Normal builds use empty(). Recovery-capable validators add one RecoveryMetadata.Entry per recovered subject instead of weakening the invariants of ordinary Semantic IR entities. The subject kind and id are stable, non-localized identifiers owned by the producer (for example "JOIN" and "statement:0/join:1"); consumers must not parse user-visible diagnostic messages to recover this association.

API status: advanced/preview. This is part of the atomic low-level builder protocol, not Join Analysis Consumption Profile v1.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RecoveryMetadata.Entry One recovered-subject to root-diagnostic association.

Method Summary

Modifier and Type	Method and Description
static RecoveryMetadata	empty() Return the shared empty metadata value used by normal builds.
boolean	equals(Object o)
List<RecoveryMetadata.Entry>	getEntries() Recovery associations in deterministic producer order.
int	hashCode()
boolean	isEmpty()
static RecoveryMetadata	of(List<RecoveryMetadata.Entry> entries) Construct metadata from recovered-subject associations.
String	toString()

Methods inherited from class Object

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

Method Detail

empty

public static RecoveryMetadata empty()

Return the shared empty metadata value used by normal builds.

of

public static RecoveryMetadata of(List<RecoveryMetadata.Entry> entries)

Construct metadata from recovered-subject associations.

Returns:

empty() when entries is empty

getEntries

public List<RecoveryMetadata.Entry> getEntries()

Recovery associations in deterministic producer order.

isEmpty

public boolean isEmpty()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object