gudusoft.gsqlparser.ir.semantic

Class ColumnRef

Object

gudusoft.gsqlparser.ir.semantic.ColumnRef

public final class ColumnRef
extends Object

In-statement reference to a column. Holds the FROM-clause alias and the column name as they appear in the SQL — not the final physical table. Physical/provenance information lives on RelationSource's RelationBinding so that later CTE/subquery slices can describe provenance separately without mutating this shape.

An optional StructuredColumnPath carries a typed path into a structured column (e.g. nodes[*].key) produced by a structured-dataflow adapter such as Spark from_json+explode. Existing constructors leave it null for full backward compatibility.

Join-analysis slice 164 (S3) adds an optional SourceSpan pointing at the source-text reference this column was read from; slice 165 (S4) adds an optional ColumnResolution surfacing the resolved base relation (GAP 5). Both are excluded from equals(java.lang.Object)/hashCode() so that set/map dedupe and golden ordering are unaffected — two refs that differ only in span or resolution remain equal. Existing constructors default them to null.

Constructor Summary

Constructors

Constructor and Description
ColumnRef(String relationAlias, String columnName)
ColumnRef(String relationAlias, String columnName, StructuredColumnPath structuredPath)
ColumnRef(String relationAlias, String columnName, StructuredColumnPath structuredPath, SourceSpan sourceSpan) Slice 164 — adds the optional source span.
ColumnRef(String relationAlias, String columnName, StructuredColumnPath structuredPath, SourceSpan sourceSpan, ColumnResolution resolution) Full constructor (join-analysis slice 165).

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
String	getColumnName()
String	getRelationAlias()
ColumnResolution	getResolution() Optional resolution of this column to its base relation / final table (join-analysis slice 165, GAP 5).
SourceSpan	getSourceSpan() Optional source-text span of this column reference (join-analysis slice 164).
StructuredColumnPath	getStructuredPath()
int	hashCode()
String	toString()

Methods inherited from class Object

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

Constructor Detail

ColumnRef

public ColumnRef(String relationAlias,
                 String columnName)

ColumnRef

public ColumnRef(String relationAlias,
                 String columnName,
                 StructuredColumnPath structuredPath)

ColumnRef

public ColumnRef(String relationAlias,
                 String columnName,
                 StructuredColumnPath structuredPath,
                 SourceSpan sourceSpan)

Slice 164 — adds the optional source span.

ColumnRef

public ColumnRef(String relationAlias,
                 String columnName,
                 StructuredColumnPath structuredPath,
                 SourceSpan sourceSpan,
                 ColumnResolution resolution)

Full constructor (join-analysis slice 165). sourceSpan and resolution are optional (null when the parser cannot anchor the reference / when no resolution was attempted) and both are excluded from identity.

Method Detail

getRelationAlias

public String getRelationAlias()

getColumnName

public String getColumnName()

getStructuredPath

public StructuredColumnPath getStructuredPath()

getSourceSpan

public SourceSpan getSourceSpan()

Optional source-text span of this column reference (join-analysis slice 164). Null when the parser cannot anchor it. Excluded from equals(java.lang.Object)/hashCode().

getResolution

public ColumnResolution getResolution()

Optional resolution of this column to its base relation / final table (join-analysis slice 165, GAP 5). Null when no resolution was attempted (e.g. synthetic merged-key refs); otherwise carries an explicit ColumnResolution (RESOLVED with a final-table name, or UNRESOLVED). Excluded from equals(java.lang.Object)/hashCode().

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