gudusoft.gsqlparser.resolver2.scope

Class AbstractScope

Object

gudusoft.gsqlparser.resolver2.scope.AbstractScope

All Implemented Interfaces:

IScope

Direct Known Subclasses:

DeleteScope, GlobalScope, GroupByScope, HavingScope, ListBasedScope, MergeScope, OraclePackageScope, OrderByScope, PlsqlBlockScope, SelectScope, UpdateScope

public abstract class AbstractScope
extends Object
implements IScope

Abstract base class for all scopes. Implements delegation pattern - most methods delegate to parent. Subclasses only need to override methods where they have special behavior.

Field Summary

Fields

Modifier and Type	Field and Description
protected TParseTreeNode	node Associated AST node
protected IScope	parent Parent scope (never null - root has EmptyScope parent)
protected ScopeType	scopeType Scope type

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractScope(IScope parent, TParseTreeNode node, ScopeType scopeType)

Method Summary

Modifier and Type	Method and Description
protected static void	addAllDistinct(List<INamespace> out, List<INamespace> more) Appends every namespace of more that out does not already hold (by identity).
void	addChild(INamespace namespace, String alias, boolean nullable) Default implementation: not supported (most scopes don't have children)
protected static void	addOwnNamespaces(List<INamespace> out, IScope scope) Adds the namespaces scope itself declares (its IScope.getChildren()), each once.
QualifiedName	fullyQualify(String name) Default implementation: delegate to parent
List<ScopeChild>	getChildren() Default implementation: empty list
IScope	getLookupParent() The scope an unresolved name climbs to: the parent, unless the search must skip it.
TParseTreeNode	getNode() Get the associated AST node
IScope	getParent() Get the parent scope.
ScopeType	getScopeType() Get the scope type
List<INamespace>	getVisibleNamespaces() The namespaces a name in this scope can see: the scope's own, then those of its lookup parent, as resolve(java.util.List<java.lang.String>, gudusoft.gsqlparser.resolver2.matcher.INameMatcher, boolean, gudusoft.gsqlparser.resolver2.scope.IResolved) walks them.
boolean	isWithin(IScope ancestorScope) Default implementation: check ancestry
void	resolve(List<String> names, INameMatcher matcher, boolean deep, IResolved resolved) Default implementation: delegate to parent
INamespace	resolveTable(String tableName) Default implementation: delegate to parent
void	setLookupParent(IScope lookupParent) Make an unresolved name skip the parent and continue at lookupParent.
String	toString()

Methods inherited from class Object

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

Field Detail

parent

protected final IScope parent

Parent scope (never null - root has EmptyScope parent)

node

protected final TParseTreeNode node

Associated AST node

scopeType

protected final ScopeType scopeType

Scope type

Constructor Detail

AbstractScope

protected AbstractScope(IScope parent,
                        TParseTreeNode node,
                        ScopeType scopeType)

Method Detail

getParent

public IScope getParent()

Description copied from interface: IScope

Get the parent scope. Root scope (GlobalScope) has EmptyScope as parent.

Specified by:

getParent in interface IScope

Returns:

Parent scope, never null

getLookupParent

public IScope getLookupParent()

The scope an unresolved name climbs to: the parent, unless the search must skip it.

setLookupParent

public void setLookupParent(IScope lookupParent)

Make an unresolved name skip the parent and continue at lookupParent.

A derived-table body and a CTE body cannot see the FROM clause that contains them: in SELECT ... FROM (SELECT x FROM a) d JOIN t9 ... the x can never be a column of t9 or of d itself, only of a or of a query enclosing the whole statement. Only name lookup skips; getParent() still returns the structural parent.

getNode

public TParseTreeNode getNode()

Description copied from interface: IScope

Get the associated AST node

Specified by:

getNode in interface IScope

Returns:

AST node for this scope

getScopeType

public ScopeType getScopeType()

Description copied from interface: IScope

Get the scope type

Specified by:

getScopeType in interface IScope

Returns:

Scope type enum

resolve

public void resolve(List<String> names,
                    INameMatcher matcher,
                    boolean deep,
                    IResolved resolved)

Default implementation: delegate to parent

Specified by:

resolve in interface IScope

Parameters:

names - Name parts (e.g., ["schema", "table", "column"])

matcher - Name matcher for case sensitivity rules

deep - Whether to recursively resolve into record fields

resolved - Callback to collect all matches

resolveTable

public INamespace resolveTable(String tableName)

Default implementation: delegate to parent

Specified by:

resolveTable in interface IScope

Parameters:

tableName - Table name or alias

Returns:

Namespace if found, null otherwise

addChild

public void addChild(INamespace namespace,
                     String alias,
                     boolean nullable)

Default implementation: not supported (most scopes don't have children)

Specified by:

addChild in interface IScope

Parameters:

namespace - The namespace to add

alias - The alias for this namespace

nullable - Whether this namespace is nullable (e.g., RIGHT side of LEFT JOIN)

getChildren

public List<ScopeChild> getChildren()

Default implementation: empty list

Specified by:

getChildren in interface IScope

Returns:

List of scope children

getVisibleNamespaces

public List<INamespace> getVisibleNamespaces()

The namespaces a name in this scope can see: the scope's own, then those of its lookup parent, as resolve(java.util.List<java.lang.String>, gudusoft.gsqlparser.resolver2.matcher.INameMatcher, boolean, gudusoft.gsqlparser.resolver2.scope.IResolved) walks them. A non-lateral derived table or CTE body hides its owner's FROM scope by a lookup parent (ScopeBuilder.setLookupParent), so the structural parent is not followed here either (Mantis 4820, Codex review).

Specified by:

getVisibleNamespaces in interface IScope

Returns:

List of visible namespaces

addOwnNamespaces

protected static void addOwnNamespaces(List<INamespace> out,
                                       IScope scope)

Adds the namespaces scope itself declares (its IScope.getChildren()), each once. Used by the scopes that own a FROM scope: the FROM scope's parent is the owner, so the owner must read the FROM scope's own children instead of calling fromScope.getVisibleNamespaces(), which would re-enter the owner and recurse until the stack overflows (Mantis 4820).

addAllDistinct

protected static void addAllDistinct(List<INamespace> out,
                                     List<INamespace> more)

Appends every namespace of more that out does not already hold (by identity).

fullyQualify

public QualifiedName fullyQualify(String name)

Default implementation: delegate to parent

Specified by:

fullyQualify in interface IScope

Parameters:

name - Name to qualify

Returns:

Qualified name

isWithin

public boolean isWithin(IScope ancestorScope)

Default implementation: check ancestry

Specified by:

isWithin in interface IScope

Parameters:

ancestorScope - Potential ancestor scope

Returns:

true if this scope is nested within ancestorScope

toString

public String toString()

Overrides:

toString in class Object