Package gudusoft.gsqlparser.resolver2.model

Class ResolutionEvidence

Object

gudusoft.gsqlparser.resolver2.model.ResolutionEvidence

public class ResolutionEvidence
extends Object

Unified evidence model for column resolution.

This class consolidates the scattered evidence/confidence information from various resolver components into a single, consistent structure. It provides:

• Structured evidence type (enum, not string magic values)
• Confidence weight with clear semantics
• Traceability through source location and node
• Human-readable messages for debugging

Confidence Score Semantics

The confidence score represents "how verifiable is this resolution":

• 1.0 (Definite): Hard evidence - DDL/metadata/explicit definition
• ~0.9 (High-confidence): Qualified reference without metadata verification
• ~0.7 (Inferred): Star column inference, CTE reverse fill
• ~0.5 (Weak): Context-based guess, should not auto-resolve

See Also:

• EvidenceType
• ColumnSource

Constructor Summary

Constructors

Constructor	Description
ResolutionEvidence(EvidenceType type, double weight)	Create a simple ResolutionEvidence with just type and weight.
ResolutionEvidence(EvidenceType type, double weight, String message, TParseTreeNode node)	Create a ResolutionEvidence from an AST node.
ResolutionEvidence(EvidenceType type, double weight, String message, SourceLocation location)	Create a ResolutionEvidence without source node.
ResolutionEvidence(EvidenceType type, double weight, String message, SourceLocation location, TParseTreeNode sourceNode)	Create a new ResolutionEvidence with all fields.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
static ResolutionEvidence	fromCTEExplicitColumn(String cteName, String columnName, TParseTreeNode node)	Create evidence for CTE explicit column list.
static ResolutionEvidence	fromCTEImplicitColumn(String cteName, String columnName, TParseTreeNode node)	Create evidence for CTE implicit column (from subquery).
static ResolutionEvidence	fromDDL(String tableName, String columnName, TParseTreeNode node)	Create evidence for DDL-defined column (CREATE TABLE in same script).
static ResolutionEvidence	fromGuessStrategy(String columnName, String chosenTable, String strategy, TParseTreeNode node)	Create evidence for guess strategy application.
static ResolutionEvidence	fromInsertColumnList(String tableName, String columnName, TParseTreeNode node)	Create evidence for INSERT column list.
static ResolutionEvidence	fromJoinCondition(String tableName, String columnName, TParseTreeNode node)	Create evidence for JOIN condition.
static ResolutionEvidence	fromLegacyEvidence(String legacyEvidence, double confidence, TParseTreeNode node)	Deprecated. Use specific factory methods instead
static ResolutionEvidence	fromMetadata(String tableName, String columnName, TParseTreeNode node)	Create evidence for metadata-backed resolution (DDL, SQLEnv).
static ResolutionEvidence	fromQualifiedReference(String tableName, String columnName, boolean hasMetadata, TParseTreeNode node)	Create evidence for qualified reference (table.column).
static ResolutionEvidence	fromSelectList(String tableName, String columnName, TParseTreeNode node)	Create evidence for SELECT list.
static ResolutionEvidence	fromStarInference(String columnName, String namespaceName, boolean isQualified, TParseTreeNode node)	Create evidence for star column inference (outer reference pushdown).
static ResolutionEvidence	fromStructFieldAccess(String baseColumn, String fieldPath, double baseConfidence, TParseTreeNode node)	Create evidence for struct field access (BigQuery/Snowflake).
static ResolutionEvidence	fromUnqualifiedReference(String columnName, int tableCount, TParseTreeNode node)	Create evidence for unqualified reference.
static ResolutionEvidence	fromUpdateSet(String tableName, String columnName, TParseTreeNode node)	Create evidence for UPDATE SET clause.
SourceLocation	getLocation()
String	getMessage()
TParseTreeNode	getSourceNode()
EvidenceType	getType()
double	getWeight()
int	hashCode()
boolean	isDefinite()	Check if this evidence represents a definite resolution.
boolean	isHighConfidence()	Check if this evidence represents a high-confidence resolution.
boolean	isInferred()	Check if this evidence represents an inferred resolution.
String	toLegacyEvidence()	Convert to legacy string evidence format.
String	toString()
ResolutionEvidence	withAppendedMessage(String additionalMessage)	Create a copy with appended message.
ResolutionEvidence	withWeight(double newWeight)	Create a copy with updated weight.

Methods inherited from class java.lang.Object

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

Constructor Details

ResolutionEvidence

public ResolutionEvidence(EvidenceType type,
 double weight,
 String message,
 SourceLocation location,
 TParseTreeNode sourceNode)

Create a new ResolutionEvidence with all fields.

Parameters:

type - The evidence type

weight - Confidence weight [0.0, 1.0]

message - Human-readable description

location - Source location

sourceNode - The AST node (optional)

ResolutionEvidence

public ResolutionEvidence(EvidenceType type,
 double weight,
 String message,
 SourceLocation location)

Create a ResolutionEvidence without source node.

ResolutionEvidence

public ResolutionEvidence(EvidenceType type,
 double weight,
 String message,
 TParseTreeNode node)

Create a ResolutionEvidence from an AST node.

ResolutionEvidence

public ResolutionEvidence(EvidenceType type,
 double weight)

Create a simple ResolutionEvidence with just type and weight.

Method Details

fromMetadata

public static ResolutionEvidence fromMetadata(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for metadata-backed resolution (DDL, SQLEnv). Confidence: 1.0 (definite)

fromDDL

public static ResolutionEvidence fromDDL(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for DDL-defined column (CREATE TABLE in same script). Confidence: 1.0 (definite)

fromQualifiedReference

public static ResolutionEvidence fromQualifiedReference(String tableName,
 String columnName,
 boolean hasMetadata,
 TParseTreeNode node)

Create evidence for qualified reference (table.column). Confidence: 0.95 if we have metadata, 0.9 otherwise

fromUnqualifiedReference

public static ResolutionEvidence fromUnqualifiedReference(String columnName,
 int tableCount,
 TParseTreeNode node)

Create evidence for unqualified reference. Confidence depends on number of tables in scope.

fromCTEExplicitColumn

public static ResolutionEvidence fromCTEExplicitColumn(String cteName,
 String columnName,
 TParseTreeNode node)

Create evidence for CTE explicit column list. Confidence: 1.0 (explicit definition)

fromCTEImplicitColumn

public static ResolutionEvidence fromCTEImplicitColumn(String cteName,
 String columnName,
 TParseTreeNode node)

Create evidence for CTE implicit column (from subquery). Confidence: 1.0 (defined in subquery)

fromStarInference

public static ResolutionEvidence fromStarInference(String columnName,
 String namespaceName,
 boolean isQualified,
 TParseTreeNode node)

Create evidence for star column inference (outer reference pushdown). Confidence: 0.7-0.9 depending on context

fromJoinCondition

public static ResolutionEvidence fromJoinCondition(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for JOIN condition. Confidence: 0.9 (explicit relationship)

fromInsertColumnList

public static ResolutionEvidence fromInsertColumnList(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for INSERT column list. Confidence: 1.0 (explicit definition)

fromUpdateSet

public static ResolutionEvidence fromUpdateSet(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for UPDATE SET clause. Confidence: 0.95 (explicit assignment)

fromSelectList

public static ResolutionEvidence fromSelectList(String tableName,
 String columnName,
 TParseTreeNode node)

Create evidence for SELECT list. Confidence: 0.85

fromStructFieldAccess

public static ResolutionEvidence fromStructFieldAccess(String baseColumn,
 String fieldPath,
 double baseConfidence,
 TParseTreeNode node)

Create evidence for struct field access (BigQuery/Snowflake). Confidence: inherits from base column resolution

fromGuessStrategy

public static ResolutionEvidence fromGuessStrategy(String columnName,
 String chosenTable,
 String strategy,
 TParseTreeNode node)

Create evidence for guess strategy application. Confidence: 0.7 (guessed from candidates)

fromLegacyEvidence

@Deprecated
public static ResolutionEvidence fromLegacyEvidence(String legacyEvidence,
 double confidence,
 TParseTreeNode node)

Deprecated.

Use specific factory methods instead

Create evidence from legacy string evidence. This is for backward compatibility during migration.

getType

public EvidenceType getType()

getWeight

public double getWeight()

getMessage

public String getMessage()

getLocation

public SourceLocation getLocation()

getSourceNode

public TParseTreeNode getSourceNode()

isDefinite

public boolean isDefinite()

Check if this evidence represents a definite resolution. Definite means confidence >= 1.0 (has hard evidence like DDL/metadata).

isHighConfidence

public boolean isHighConfidence()

Check if this evidence represents a high-confidence resolution. High-confidence means confidence >= 0.9.

isInferred

public boolean isInferred()

Check if this evidence represents an inferred resolution. Inferred means confidence < 1.0 or type is INFERRED_FROM_USAGE.

withWeight

public ResolutionEvidence withWeight(double newWeight)

Create a copy with updated weight.

withAppendedMessage

public ResolutionEvidence withAppendedMessage(String additionalMessage)

Create a copy with appended message.

toLegacyEvidence

public String toLegacyEvidence()

Convert to legacy string evidence format. For backward compatibility with existing code.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object