gudusoft.gsqlparser.resolver2.model

Class ResolutionContext

Object

gudusoft.gsqlparser.resolver2.model.ResolutionContext

public class ResolutionContext
extends Object

Global context for resolution results. Provides efficient querying and statistics about resolved columns. Design principles: 1. Reverse indexing for O(1) queries 2. Categorized storage for quick access to different resolution states 3. Statistics for monitoring resolution quality

Constructor Summary

Constructors

Constructor and Description
ResolutionContext()

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all data (for reuse or testing)
void	enableBindingTrace() Enable per-TObjectName binding-trace recording.
Set<TTable>	getAllReferencedTables() Get all tables that have been referenced
List<TObjectName>	getAmbiguousColumns() Get all ambiguous columns
ResolutionResult	getColumnResolutionResult(TObjectName objName) Get the recorded resolution for a specific TObjectName reference.
List<TObjectName>	getColumnsByName(String columnName) Find all column references with a given name (for conflict detection).
BindingSkipReason	getColumnSkipReason(TObjectName objName) Get the skip-reason recorded for a specific TObjectName reference.
List<TObjectName>	getExactMatches() Get all exactly matched columns
List<TObjectName>	getReferencesTo(TTable table) Get all column references to a specific table.
List<TObjectName>	getReferencesTo(TTable table, String columnName) Get all column references to a specific table.column.
ResolutionResult	getResolution(TObjectName objName) Get resolution result for a specific TObjectName
ResolutionStatistics	getStatistics() Get resolution statistics
int	getTableReferenceCount(TTable table) Get reference count for a specific table
List<TObjectName>	getUnresolvedColumns() Get all unresolved columns
boolean	isBindingTraceEnabled()
void	recordColumnSkipReason(TObjectName objName, BindingSkipReason reason) Record an explicit binding-skip reason for a reference.
void	registerResolution(TObjectName objName, ResolutionResult result) Register a resolution result.
void	replaceResolution(TObjectName objName, ResolutionResult result) Register a resolution that CORRECTS one already registered for the same reference, retracting the superseded bookkeeping first.

Methods inherited from class Object

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

Constructor Detail

ResolutionContext

public ResolutionContext()

Method Detail

registerResolution

public void registerResolution(TObjectName objName,
                               ResolutionResult result)

Register a resolution result. Called by NameResolver when a column is resolved.

replaceResolution

public void replaceResolution(TObjectName objName,
                              ResolutionResult result)

Register a resolution that CORRECTS one already registered for the same reference, retracting the superseded bookkeeping first.

registerResolution(gudusoft.gsqlparser.nodes.TObjectName, gudusoft.gsqlparser.resolver2.model.ResolutionResult) is purely additive: it overwrites the forward map but appends to columnNameIndex, the status lists, tableReferences and the counters. Calling it twice for one reference therefore leaves the OLD binding visible — after a WHERE reference is corrected from a table column to a SELECT-list alias, getReferencesTo(oldTable) would still list it, it would appear twice in getExactMatches(), and totalColumnReferences would over-count. That makes the context disagree with TObjectName, and resolver2's own data structures are supposed to be the single source of truth (MantisBT 4659).

Safe to call when nothing was registered before — it degrades to a plain registerResolution(gudusoft.gsqlparser.nodes.TObjectName, gudusoft.gsqlparser.resolver2.model.ResolutionResult).

getReferencesTo

public List<TObjectName> getReferencesTo(TTable table)

Get all column references to a specific table. Complexity: O(1)

Parameters:

table - Target table

Returns:

List of TObjectName referencing that table

getReferencesTo

public List<TObjectName> getReferencesTo(TTable table,
                                         String columnName)

Get all column references to a specific table.column. Complexity: O(m) where m = number of references to the table

Parameters:

table - Target table

columnName - Target column name

Returns:

List of matching TObjectName

getColumnsByName

public List<TObjectName> getColumnsByName(String columnName)

Find all column references with a given name (for conflict detection). Complexity: O(1)

getExactMatches

public List<TObjectName> getExactMatches()

Get all exactly matched columns

getAmbiguousColumns

public List<TObjectName> getAmbiguousColumns()

Get all ambiguous columns

getUnresolvedColumns

public List<TObjectName> getUnresolvedColumns()

Get all unresolved columns

getTableReferenceCount

public int getTableReferenceCount(TTable table)

Get reference count for a specific table

getAllReferencedTables

public Set<TTable> getAllReferencedTables()

Get all tables that have been referenced

getStatistics

public ResolutionStatistics getStatistics()

Get resolution statistics

getResolution

public ResolutionResult getResolution(TObjectName objName)

Get resolution result for a specific TObjectName

clear

public void clear()

Clear all data (for reuse or testing)

enableBindingTrace

public void enableBindingTrace()

Enable per-TObjectName binding-trace recording.

Allocates the identity-keyed trace and skip-reason maps on first call; subsequent calls are no-ops. TSQLResolver2.resolve() flips this on at the start of resolution when either emitBindingDiagnostics or bindingIncludeSuccessfulReferences is set.

isBindingTraceEnabled

public boolean isBindingTraceEnabled()

Returns:

true once enableBindingTrace() has been called for this context.

getColumnResolutionResult

public ResolutionResult getColumnResolutionResult(TObjectName objName)

Get the recorded resolution for a specific TObjectName reference.

Identity-keyed (two references with equal toString are kept separate). Returns null when no resolution has been recorded for this reference, including when the trace is disabled.

getColumnSkipReason

public BindingSkipReason getColumnSkipReason(TObjectName objName)

Get the skip-reason recorded for a specific TObjectName reference.

recordColumnSkipReason

public void recordColumnSkipReason(TObjectName objName,
                                   BindingSkipReason reason)

Record an explicit binding-skip reason for a reference. Silently ignored when the trace is disabled.