gudusoft.gsqlparser.ir.semantic

Class LineageRef

Object

gudusoft.gsqlparser.ir.semantic.LineageRef

public final class LineageRef
extends Object

One endpoint of a LineageEdge. Either references an output column of a StatementGraph (by index + name) or a column of a base table (by qualified name + column name). The discriminator is getKind().

An optional StructuredColumnPath carries a typed path under the root column (e.g. nodes[*].key) for endpoints produced by structured-dataflow adapters. Existing factories leave it null.

An optional SourceSpan (US-021a) anchors the endpoint back to the source text it was derived from. Existing factories leave it null; builders attach it via withSpan(SourceSpan).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LineageRef.Kind

Method Summary

Modifier and Type	Method and Description
String	getColumnName()
LineageRef.Kind	getKind()
String	getOutputName()
String	getQualifiedName()
SourceSpan	getSpan() Optional source span of this endpoint (US-021a).
int	getStatementIndex()
StructuredColumnPath	getStructuredPath()
static LineageRef	statementOutput(int statementIndex, String outputName)
static LineageRef	statementOutput(int statementIndex, String outputName, StructuredColumnPath structuredPath)
static LineageRef	tableColumn(String qualifiedName, String columnName)
static LineageRef	tableColumn(String qualifiedName, String columnName, StructuredColumnPath structuredPath)
LineageRef	withSpan(SourceSpan span) Copy of this ref with the optional endpoint source span attached (US-021a) — for a STATEMENT_OUTPUT endpoint, the projection expression's span; for a TABLE_COLUMN endpoint, the span of the column reference it was resolved from.

Methods inherited from class Object

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

Method Detail

statementOutput

public static LineageRef statementOutput(int statementIndex,
                                         String outputName)

statementOutput

public static LineageRef statementOutput(int statementIndex,
                                         String outputName,
                                         StructuredColumnPath structuredPath)

tableColumn

public static LineageRef tableColumn(String qualifiedName,
                                     String columnName)

tableColumn

public static LineageRef tableColumn(String qualifiedName,
                                     String columnName,
                                     StructuredColumnPath structuredPath)

withSpan

public LineageRef withSpan(SourceSpan span)

Copy of this ref with the optional endpoint source span attached (US-021a) — for a STATEMENT_OUTPUT endpoint, the projection expression's span; for a TABLE_COLUMN endpoint, the span of the column reference it was resolved from. Returns this when span is null (nothing to attach), so callers can pass possibly-null spans unconditionally.

getKind

public LineageRef.Kind getKind()

getStatementIndex

public int getStatementIndex()

getOutputName

public String getOutputName()

getQualifiedName

public String getQualifiedName()

getColumnName

public String getColumnName()

getStructuredPath

public StructuredColumnPath getStructuredPath()

getSpan

public SourceSpan getSpan()

Optional source span of this endpoint (US-021a). null unless a builder attached one via withSpan(SourceSpan). Null-safe: never throws.