gudusoft.gsqlparser.ir.builder.common

Class AbstractRoutineRefResolver

Object

gudusoft.gsqlparser.ir.builder.common.AbstractRoutineRefResolver

Direct Known Subclasses:

PostgresqlRoutineRefResolver

public abstract class AbstractRoutineRefResolver
extends Object

Shared base class for dialect-specific routine reference resolvers.

Owns the common resolve() loop: builds uppercase and name-based indexes, iterates all unresolved refs, delegates per-ref resolution to subclass, and replaces the ref list on the program.

Dialect-specific resolution tiers (qualified match, schema inference, default schema, etc.) belong in the subclass tryResolve(gudusoft.gsqlparser.ir.bound.BoundRoutineRef, gudusoft.gsqlparser.ir.bound.BoundProgram, java.util.Map<java.lang.String, gudusoft.gsqlparser.ir.bound.BoundRoutineSymbol>, java.util.Map<java.lang.String, java.util.List<gudusoft.gsqlparser.ir.bound.BoundRoutineSymbol>>) method.

Constructor Summary

Constructors

Constructor and Description
AbstractRoutineRefResolver()

Method Summary

Modifier and Type	Method and Description
protected Map<String,List<BoundRoutineSymbol>>	buildNameIndex(BoundProgram program) Builds a case-insensitive name → list of symbols index.
protected Map<String,BoundRoutineSymbol>	buildUpperCaseIndex(BoundProgram program) Builds a case-insensitive routineId → symbol index.
protected abstract void	classifyExternalIfKnown(BoundRoutineRef ref) Called for unresolved refs to check if they are known external dependencies.
protected static BoundRoutineSymbol	findBestDefaultParamMatch(Map<String,List<BoundRoutineSymbol>> nameIndex, String upperName, int argCount) Finds the best default-parameter match (smallest paramCount > argCount).
protected static List<BoundRoutineSymbol>	findByNameAndArgCount(Map<String,List<BoundRoutineSymbol>> nameIndex, String upperName, int argCount) Finds candidates matching a name and exact arg count from the name index.
void	resolve(BoundProgram program) Resolves all unresolved routine refs in the program.
protected static BoundRoutineSymbol	tryKindVariants(Map<String,BoundRoutineSymbol> ciIndex, String baseName, int argCount, String[] kindCodes) Tries all KIND code variants for a given base name and argCount.
protected abstract BoundRoutineRef	tryResolve(BoundRoutineRef ref, BoundProgram program, Map<String,BoundRoutineSymbol> upperIndex, Map<String,List<BoundRoutineSymbol>> nameIndex) Attempts to resolve a single routine ref against the known routines.

Methods inherited from class Object

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

Constructor Detail

AbstractRoutineRefResolver

public AbstractRoutineRefResolver()

Method Detail

resolve

public final void resolve(BoundProgram program)

Resolves all unresolved routine refs in the program. Replaces the program's ref list with updated copies where matches are found.

tryResolve

protected abstract BoundRoutineRef tryResolve(BoundRoutineRef ref,
                                              BoundProgram program,
                                              Map<String,BoundRoutineSymbol> upperIndex,
                                              Map<String,List<BoundRoutineSymbol>> nameIndex)

Attempts to resolve a single routine ref against the known routines.

Parameters:

ref - the unresolved ref

program - the program containing all routines

upperIndex - case-insensitive routineId → symbol index

nameIndex - case-insensitive name → list of symbols index

Returns:

resolved ref, or null if no match found

classifyExternalIfKnown

protected abstract void classifyExternalIfKnown(BoundRoutineRef ref)

Called for unresolved refs to check if they are known external dependencies. Subclasses should set properties like "externalDependency", "externalType", etc.

buildUpperCaseIndex

protected final Map<String,BoundRoutineSymbol> buildUpperCaseIndex(BoundProgram program)

Builds a case-insensitive routineId → symbol index.

buildNameIndex

protected final Map<String,List<BoundRoutineSymbol>> buildNameIndex(BoundProgram program)

Builds a case-insensitive name → list of symbols index.

tryKindVariants

protected static BoundRoutineSymbol tryKindVariants(Map<String,BoundRoutineSymbol> ciIndex,
                                                    String baseName,
                                                    int argCount,
                                                    String[] kindCodes)

Tries all KIND code variants for a given base name and argCount. Returns the first match, or null.

findByNameAndArgCount

protected static List<BoundRoutineSymbol> findByNameAndArgCount(Map<String,List<BoundRoutineSymbol>> nameIndex,
                                                                String upperName,
                                                                int argCount)

Finds candidates matching a name and exact arg count from the name index.

findBestDefaultParamMatch

protected static BoundRoutineSymbol findBestDefaultParamMatch(Map<String,List<BoundRoutineSymbol>> nameIndex,
                                                              String upperName,
                                                              int argCount)

Finds the best default-parameter match (smallest paramCount > argCount).