Package gudusoft.gsqlparser.resolver2.enhancement

Class NamespaceEnhancer

Object

gudusoft.gsqlparser.resolver2.enhancement.NamespaceEnhancer

public class NamespaceEnhancer
extends Object

Handles explicit namespace enhancement between resolution passes. The enhancement process: 1. During resolution, collect column references that target namespaces with star columns 2. Between passes, explicitly add these columns to the namespaces 3. Track which columns were added in which pass for debugging This makes the column inference process explicit and traceable, rather than happening implicitly during resolution.

Constructor Summary

Constructors

Constructor	Description
NamespaceEnhancer()
NamespaceEnhancer(boolean debug)

Method Summary

Modifier and Type	Method	Description
void	collectColumnRef(String columnName, INamespace targetNamespace, TObjectName sourceReference, double confidence, String evidence)	Deprecated. Use collectColumnRef(String, INamespace, TObjectName, ResolutionEvidence) instead
void	collectColumnRef(String columnName, INamespace targetNamespace, TObjectName sourceReference, ResolutionEvidence evidenceDetail)	Collect a column reference with structured evidence.
void	collectFromResolution(TObjectName column, ResolutionResult result, INamespace candidateNamespace)	Collect a column reference based on resolution result.
EnhancementResult	enhance()	Perform namespace enhancement using collected column references.
String	generateReport()	Generate a summary report of all enhancements
List<EnhancementResult>	getEnhancementHistory()	Get all enhancement results history
int	getPendingCount()	Get number of pending references (not yet enhanced)
Set<INamespace>	getStarNamespaces()	Get all star namespaces
int	getTotalColumnsAdded()	Get total columns added across all passes
void	initialize(ScopeBuildResult scopeBuildResult)	Initialize the enhancer with scope build result.
boolean	isStarNamespace(INamespace namespace)	Check if a namespace is a star namespace
void	startPass(int passNumber)	Start a new resolution pass.

Methods inherited from class java.lang.Object

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

Constructor Details

NamespaceEnhancer

public NamespaceEnhancer()

NamespaceEnhancer

public NamespaceEnhancer(boolean debug)

Method Details

initialize

public void initialize(ScopeBuildResult scopeBuildResult)

Initialize the enhancer with scope build result. Caches namespaces that have star columns and builds TTable -> INamespace mapping.

startPass

public void startPass(int passNumber)

Start a new resolution pass. Clears pending references from previous pass.

collectColumnRef

public void collectColumnRef(String columnName,
 INamespace targetNamespace,
 TObjectName sourceReference,
 double confidence,
 String evidence)

Deprecated.

Use collectColumnRef(String, INamespace, TObjectName, ResolutionEvidence) instead

Collect a column reference that could not be resolved. Called during resolution when a column targets a star namespace.

Parameters:

columnName - The column name

targetNamespace - The namespace the column should belong to

sourceReference - The AST node

confidence - Confidence score

evidence - Reason for this inference

collectColumnRef

public void collectColumnRef(String columnName,
 INamespace targetNamespace,
 TObjectName sourceReference,
 ResolutionEvidence evidenceDetail)

Collect a column reference with structured evidence. Called during resolution when a column targets a star namespace.

Parameters:

columnName - The column name

targetNamespace - The namespace the column should belong to

sourceReference - The AST node

evidenceDetail - Structured evidence detail

collectFromResolution

public void collectFromResolution(TObjectName column,
 ResolutionResult result,
 INamespace candidateNamespace)

Collect a column reference based on resolution result. Automatically determines if collection is needed based on resolution status.

enhance

public EnhancementResult enhance()

Perform namespace enhancement using collected column references. This is called BETWEEN resolution passes.

Returns:

EnhancementResult with details of what was added

getEnhancementHistory

public List<EnhancementResult> getEnhancementHistory()

Get all enhancement results history

getTotalColumnsAdded

public int getTotalColumnsAdded()

Get total columns added across all passes

getPendingCount

public int getPendingCount()

Get number of pending references (not yet enhanced)

isStarNamespace

public boolean isStarNamespace(INamespace namespace)

Check if a namespace is a star namespace

getStarNamespaces

public Set<INamespace> getStarNamespaces()

Get all star namespaces

generateReport

public String generateReport()

Generate a summary report of all enhancements