gudusoft.gsqlparser.resolver2.namespace

Class AbstractNamespace

Object

gudusoft.gsqlparser.resolver2.namespace.AbstractNamespace

All Implemented Interfaces:

INamespace

Direct Known Subclasses:

CTENamespace, DynamicStarSource, PivotNamespace, SubqueryNamespace, TableNamespace, UnionNamespace, UnnestNamespace, ValuesNamespace

public abstract class AbstractNamespace
extends Object
implements INamespace

Abstract base class for all namespaces. Provides common functionality for column resolution and caching.

Enhanced with reference traceability support: multiple syntactically different identifiers that refer to the same semantic column can be tracked and traced back.

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,ColumnSource>	columnSources Cached column sources (populated during validation) - keyed by normalized name
protected Map<String,ColumnSourceWithReferences>	columnSourcesWithRefs Enhanced column sources with reference traceability (keyed by normalized name).
protected int	guessColumnStrategy Strategy for handling ambiguous columns.
protected INameMatcher	nameMatcher Name matcher for column name comparisons
protected Object	node Associated AST node
protected boolean	referenceTraceabilityEnabled Whether reference traceability is enabled
protected boolean	validated Whether this namespace has been validated

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractNamespace(Object node)
protected	AbstractNamespace(Object node, INameMatcher nameMatcher)

Method Summary

Modifier and Type	Method and Description
protected void	addColumnSource(String columnName, ColumnSource source) Add a column source (backward compatible - no traceability).
protected void	addColumnSource(String columnName, ColumnSource source, TObjectName objectName) Add a column source with reference traceability support.
protected boolean	containsColumnByMatcher(Map<String,?> map, String columnName) Slice S1: matcher-aware containsKey replacement for column maps that need vendor-specific identifier rules to govern dedupe / lookup.
protected boolean	containsColumnNameByMatcher(Set<String> set, String columnName) Slice S1: matcher-aware Set#contains replacement.
protected abstract void	doValidate() Subclasses override this to perform actual validation logic.
void	enableReferenceTraceability() Enable reference traceability for this namespace.
protected void	ensureValidated() Ensure this namespace is validated before accessing column info
Map<String,ColumnSource>	getAllColumnSources() Get all column sources exposed by this namespace.
List<TTable>	getAllFinalTables() Get all final physical tables this namespace depends on.
Collection<ColumnSourceWithReferences>	getAllUniqueColumns() Get all unique columns with their references.
List<ColumnReference>	getColumnReferences(String columnName) Get all column references for a specific column.
ColumnSourceWithReferences	getColumnSourceWithReferences(String columnName) Get enhanced column source with references for a specific column.
int	getGuessColumnStrategy() Get the strategy for handling ambiguous columns.
INameMatcher	getNameMatcher() Get the name matcher used by this namespace.
Object	getNode() Get the associated AST node (TTable, TSelectSqlStatement, etc.)
ColumnLevel	hasColumn(String columnName) Check if a column exists in this namespace.
boolean	isReferenceTraceabilityEnabled() Check if reference traceability is enabled.
boolean	isValidated() Check if this namespace is validated/resolved.
ColumnSource	resolveColumn(String columnName) Resolve a column name to its source.
void	setGuessColumnStrategy(int strategy) Set the strategy for handling ambiguous columns.
String	toString()
void	validate() Validate/resolve this namespace.

Methods inherited from class Object

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

Methods inherited from interface gudusoft.gsqlparser.resolver2.namespace.INamespace

addInferredColumn, getDisplayName, getFinalTable, getInferredColumns, getMetadataState, getSelectStatement, getSourceTable, getStarColumn, hasStarColumn, resolveColumnPath, supportsDynamicInference

Field Detail

node

protected final Object node

Associated AST node

validated

protected boolean validated

Whether this namespace has been validated

columnSources

protected Map<String,ColumnSource> columnSources

Cached column sources (populated during validation) - keyed by normalized name

columnSourcesWithRefs

protected Map<String,ColumnSourceWithReferences> columnSourcesWithRefs

Enhanced column sources with reference traceability (keyed by normalized name). When enabled, this map stores ColumnSourceWithReferences that track all original references to each semantic column.

referenceTraceabilityEnabled

protected boolean referenceTraceabilityEnabled

Whether reference traceability is enabled

nameMatcher

protected final INameMatcher nameMatcher

Name matcher for column name comparisons

guessColumnStrategy

protected int guessColumnStrategy

Strategy for handling ambiguous columns. Defaults to -1, which means use global TBaseType.GUESS_COLUMN_STRATEGY. Can be overridden per-namespace instance.

Constructor Detail

AbstractNamespace

protected AbstractNamespace(Object node,
                            INameMatcher nameMatcher)

AbstractNamespace

protected AbstractNamespace(Object node)

Method Detail

setGuessColumnStrategy

public void setGuessColumnStrategy(int strategy)

Set the strategy for handling ambiguous columns.

Parameters:

strategy - One of TBaseType.GUESS_COLUMN_STRATEGY_* constants, or -1 to use global default

getGuessColumnStrategy

public int getGuessColumnStrategy()

Get the strategy for handling ambiguous columns. Returns the instance-level strategy if set, otherwise returns the global default.

Returns:

The strategy constant

getNode

public Object getNode()

Description copied from interface: INamespace

Get the associated AST node (TTable, TSelectSqlStatement, etc.)

Specified by:

getNode in interface INamespace

Returns:

AST node, or null if not applicable

isValidated

public boolean isValidated()

Description copied from interface: INamespace

Check if this namespace is validated/resolved. Some namespaces require resolution before they can provide column info.

Specified by:

isValidated in interface INamespace

Returns:

true if validated

validate

public void validate()

Description copied from interface: INamespace

Validate/resolve this namespace. For subqueries: resolve the SELECT list For tables: load metadata if needed

Specified by:

validate in interface INamespace

doValidate

protected abstract void doValidate()

Subclasses override this to perform actual validation logic.

enableReferenceTraceability

public void enableReferenceTraceability()

Enable reference traceability for this namespace. When enabled, all column additions will track original references.

isReferenceTraceabilityEnabled

public boolean isReferenceTraceabilityEnabled()

Check if reference traceability is enabled.

Returns:

true if traceability is enabled

addColumnSource

protected void addColumnSource(String columnName,
                               ColumnSource source,
                               TObjectName objectName)

Add a column source with reference traceability support.

This method normalizes the column name and either:

• Creates a new entry if this is the first reference
• Adds a reference to an existing entry if the column already exists

Parameters:

columnName - original column name (may include quotes)

source - the column source

objectName - the original AST node for traceability (may be null)

addColumnSource

protected void addColumnSource(String columnName,
                               ColumnSource source)

Add a column source (backward compatible - no traceability).

Parameters:

columnName - original column name

source - the column source

containsColumnByMatcher

protected boolean containsColumnByMatcher(Map<String,?> map,
                                          String columnName)

Slice S1: matcher-aware containsKey replacement for column maps that need vendor-specific identifier rules to govern dedupe / lookup.

Per-vendor identifier rules differ on whether MyCol and mycol are the same column (BigQuery / MySQL / SQL Server: yes for columns; Oracle / Postgres unquoted: yes via folding; quoted Oracle / Postgres: no). A raw map.containsKey(name) bypasses these rules and produces duplicate-key drift; a fixed equalsIgnoreCase loop is wrong for vendors where columns are case-sensitive (BigQuery tables, Oracle quoted).

This helper:

1. tries an O(1) normalized-key probe (fast path for vendors that fold unquoted identifiers to a canonical form, where the stored raw key is itself the folded form — e.g. Postgres stored "mycol" probed by query "MYCOL" that normalizes to "mycol"),
2. tries an O(1) raw-key probe for the exact-match common case,
3. falls back to a matcher loop that compares against ColumnSource.getExposedName() (when values are ColumnSource) so quote state is preserved on quoted-sensitive dialects.

Quote-state preservation (codex round 1 + round 2). The map values must hold the original-cased identifier (with quotes). Storage keys are also raw (= exposedName) — round 2 caught that storing under nameMatcher.normalize(name) can collide two matcher-distinct identifiers (e.g. Postgres quoted "mycol" vs unquoted MYCOL both normalize to mycol) into the same key and lose information. With raw-keyed storage, the normalize fast-probe only hits when the stored raw key already equals the normalized form, and in that case INameMatcher.matches(java.lang.String, java.lang.String) agrees; the matcher loop catches the case-only-different case.

containsColumnNameByMatcher

protected boolean containsColumnNameByMatcher(Set<String> set,
                                              String columnName)

Slice S1: matcher-aware Set#contains replacement. See containsColumnByMatcher(Map, String) for the rationale.

hasColumn

public ColumnLevel hasColumn(String columnName)

Description copied from interface: INamespace

Check if a column exists in this namespace. Returns a three-level answer: EXISTS, MAYBE, NOT_EXISTS

Specified by:

hasColumn in interface INamespace

Parameters:

columnName - Column name to check

Returns:

Column existence level

resolveColumn

public ColumnSource resolveColumn(String columnName)

Description copied from interface: INamespace

Resolve a column name to its source.

Specified by:

resolveColumn in interface INamespace

Parameters:

columnName - Column name to resolve

Returns:

ColumnSource if found, null otherwise

getAllColumnSources

public Map<String,ColumnSource> getAllColumnSources()

Description copied from interface: INamespace

Get all column sources exposed by this namespace. Used for SELECT * expansion and smart completion.

Specified by:

getAllColumnSources in interface INamespace

Returns:

Map of column name -> ColumnSource

getColumnReferences

public List<ColumnReference> getColumnReferences(String columnName)

Get all column references for a specific column.

Requires reference traceability to be enabled.

Parameters:

columnName - the column name (normalized or original)

Returns:

list of all references, empty if not found or traceability not enabled

getAllUniqueColumns

public Collection<ColumnSourceWithReferences> getAllUniqueColumns()

Get all unique columns with their references.

Requires reference traceability to be enabled.

Returns:

collection of enhanced column sources, empty if traceability not enabled

getColumnSourceWithReferences

public ColumnSourceWithReferences getColumnSourceWithReferences(String columnName)

Get enhanced column source with references for a specific column.

Parameters:

columnName - the column name

Returns:

enhanced column source, or null if not found

getAllFinalTables

public List<TTable> getAllFinalTables()

Description copied from interface: INamespace

Get all final physical tables this namespace depends on. For simple table namespace: returns single table For subquery/CTE: returns all tables in the query tree

Specified by:

getAllFinalTables in interface INamespace

Returns:

List of all physical tables

ensureValidated

protected void ensureValidated()

Ensure this namespace is validated before accessing column info

getNameMatcher

public INameMatcher getNameMatcher()

Get the name matcher used by this namespace.

Returns:

the name matcher

toString

public String toString()

Overrides:

toString in class Object