Package gudusoft.gsqlparser.resolver2.scope

Class GlobalScope

Object

gudusoft.gsqlparser.resolver2.scope.AbstractScope

gudusoft.gsqlparser.resolver2.scope.GlobalScope

All Implemented Interfaces:

IScope

public class GlobalScope
extends AbstractScope

Global scope - contains session-level objects and metadata. This is typically the root of the scope tree.

Responsibilities:

1. Access to global metadata (SQLEnv)
2. Database/schema context with proper qualified name resolution
3. Session variables and settings

Qualified Name Resolution

When resolving table names, this scope uses QualifiedNameResolver to properly handle partial names (e.g., just "table" or "schema.table") by applying default catalog/schema from TSQLEnv.

Example: With default catalog="mydb" and schema="dbo":

• "users" matches "mydb.dbo.users"
• "hr.employees" matches "mydb.hr.employees"
• "otherdb.hr.employees" matches exactly

See Also:

• QualifiedNameResolver
• QualifiedName

Field Summary

Fields inherited from class gudusoft.gsqlparser.resolver2.scope.AbstractScope

node, parent, scopeType

Constructor Summary

Constructors

Constructor	Description
GlobalScope(gudusoft.gsqlparser.compiler.TContext globalContext, INameMatcher nameMatcher)
GlobalScope(gudusoft.gsqlparser.compiler.TContext globalContext, INameMatcher nameMatcher, TSQLEnv sqlEnv, EDbVendor vendor)	Create a GlobalScope with SQL environment for qualified name resolution.

Method Summary

Modifier and Type	Method	Description
void	addGlobalTable(String qualifiedNameStr, INamespace tableNamespace)	Add a globally accessible table (from metadata).
void	addGlobalTable(String catalog, String schema, String tableName, INamespace tableNamespace)	Add a globally accessible table with explicit catalog/schema/name.
String	getDefaultCatalog()	Get the default catalog from SQL environment.
String	getDefaultSchema()	Get the default schema from SQL environment.
gudusoft.gsqlparser.compiler.TContext	getGlobalContext()
INameMatcher	getNameMatcher()
QualifiedNameResolver	getQualifiedNameResolver()	Get the qualified name resolver.
TSQLEnv	getSqlEnv()	Get the SQL environment.
EDbVendor	getVendor()	Get the database vendor.
List<INamespace>	getVisibleNamespaces()	Default implementation: delegate to parent
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	setSqlEnv(TSQLEnv sqlEnv)	Set the SQL environment for qualified name resolution.
void	setVendor(EDbVendor vendor)	Set the database vendor.
String	toString()

Methods inherited from class gudusoft.gsqlparser.resolver2.scope.AbstractScope

addChild, fullyQualify, getChildren, getNode, getParent, getScopeType, isWithin

Methods inherited from class java.lang.Object

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

Constructor Details

GlobalScope

public GlobalScope(gudusoft.gsqlparser.compiler.TContext globalContext,
 INameMatcher nameMatcher)

GlobalScope

public GlobalScope(gudusoft.gsqlparser.compiler.TContext globalContext,
 INameMatcher nameMatcher,
 TSQLEnv sqlEnv,
 EDbVendor vendor)

Create a GlobalScope with SQL environment for qualified name resolution.

Parameters:

globalContext - The global parser context

nameMatcher - The name matcher for case sensitivity

sqlEnv - The SQL environment with default catalog/schema

vendor - The database vendor

Method Details

setSqlEnv

public void setSqlEnv(TSQLEnv sqlEnv)

Set the SQL environment for qualified name resolution.

Parameters:

sqlEnv - The SQL environment with default catalog/schema

getSqlEnv

public TSQLEnv getSqlEnv()

Get the SQL environment.

setVendor

public void setVendor(EDbVendor vendor)

Set the database vendor.

getVendor

public EDbVendor getVendor()

Get the database vendor.

addGlobalTable

public void addGlobalTable(String qualifiedNameStr,
 INamespace tableNamespace)

Add a globally accessible table (from metadata).

The qualified name should be in the format "catalog.schema.table" or "schema.table" or just "table". The name will be parsed and stored for proper matching later.

Parameters:

qualifiedNameStr - The qualified table name string

tableNamespace - The namespace representing the table

addGlobalTable

public void addGlobalTable(String catalog,
 String schema,
 String tableName,
 INamespace tableNamespace)

Add a globally accessible table with explicit catalog/schema/name.

Parameters:

catalog - The catalog name (nullable)

schema - The schema name (nullable)

tableName - The table name (required)

tableNamespace - The namespace representing the table

resolveTable

public INamespace resolveTable(String tableName)

Description copied from class: AbstractScope

Default implementation: delegate to parent

Specified by:

resolveTable in interface IScope

Overrides:

resolveTable in class AbstractScope

Parameters:

tableName - Table name or alias

Returns:

Namespace if found, null otherwise

getDefaultCatalog

public String getDefaultCatalog()

Get the default catalog from SQL environment.

getDefaultSchema

public String getDefaultSchema()

Get the default schema from SQL environment.

resolve

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

Description copied from class: AbstractScope

Default implementation: delegate to parent

Specified by:

resolve in interface IScope

Overrides:

resolve in class AbstractScope

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

getVisibleNamespaces

public List<INamespace> getVisibleNamespaces()

Description copied from class: AbstractScope

Default implementation: delegate to parent

Specified by:

getVisibleNamespaces in interface IScope

Overrides:

getVisibleNamespaces in class AbstractScope

Returns:

List of visible namespaces

getGlobalContext

public gudusoft.gsqlparser.compiler.TContext getGlobalContext()

getNameMatcher

public INameMatcher getNameMatcher()

getQualifiedNameResolver

public QualifiedNameResolver getQualifiedNameResolver()

Get the qualified name resolver.

toString

public String toString()

Overrides:

toString in class AbstractScope