gudusoft.gsqlparser.resolver2.model

Class StructFieldHint

Object

gudusoft.gsqlparser.resolver2.model.StructFieldHint

public class StructFieldHint
extends Object

A side-channel annotation for deep struct field access (3+ part names without alias).

Unlike ColumnSource (which is part of the main resolution result and triggers sourceTable binding), this hint is purely informational. It provides struct field path information to downstream consumers (e.g., DataFlowAnalyzer) without altering the resolution path or lineage topology.

This solves the problem where 3-part no-alias struct access like customer.address.city FROM orders cannot use the main EXACT_MATCH resolution path because doing so changes sourceTable binding and breaks existing lineage chains (see plan document Section 10).

Example:

 -- SQL: SELECT customer.address.city FROM orders
 -- StructFieldHint:
 --   baseColumn = "customer"
 --   fieldPath = ["address", "city"]
 --   evidence = "struct_field_hint_no_alias"
 --   confidence = 0.7
 

See Also:

FieldPath

Constructor Summary

Constructors

Constructor and Description
StructFieldHint(String baseColumn, FieldPath fieldPath, String evidence, double confidence)

Method Summary

Modifier and Type	Method and Description
String	getBaseColumn()
double	getConfidence()
String	getEvidence()
FieldPath	getFieldPath()
String	toFullReference() Get the full dotted reference (e.g., "customer.address.city").
String	toString()

Methods inherited from class Object

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

Constructor Detail

StructFieldHint

public StructFieldHint(String baseColumn,
                       FieldPath fieldPath,
                       String evidence,
                       double confidence)

Method Detail

getBaseColumn

public String getBaseColumn()

getFieldPath

public FieldPath getFieldPath()

getEvidence

public String getEvidence()

getConfidence

public double getConfidence()

toFullReference

public String toFullReference()

Get the full dotted reference (e.g., "customer.address.city").

toString

public String toString()

Overrides:

toString in class Object