gudusoft.gsqlparser.catalog.runtime

Class ModelBackedCatalogProvider

Object

gudusoft.gsqlparser.catalog.runtime.ModelBackedCatalogProvider

All Implemented Interfaces:

CatalogProvider, AutoCloseable

public final class ModelBackedCatalogProvider
extends Object
implements CatalogProvider

CatalogProvider that wraps a single UnifiedCatalogModel, exposing it as a fully-materialized snapshot. Used by JSON / YAML / DDL / dbt / dump readers — every static-file source funnels here.

Plan §5.1 / §6. The model is translated into an InMemoryCatalogSnapshot once during open(CatalogProviderConfig); subsequent snapshot(CatalogQuery) calls return the same instance regardless of the query's narrowing options (model-backed sources are always eager).

Identifier handling routes through CatalogIdentifierPolicy.parse using the model's IdentifierConfig; per-segment qualified-name forms therefore honor every vendor rule the validator enforced at load time.

Constructor Summary

Constructors

Constructor and Description
ModelBackedCatalogProvider(UnifiedCatalogModel model)
ModelBackedCatalogProvider(UnifiedCatalogModel model, IdentifierConfig identifierConfigOverride) Construct a provider with an explicit IdentifierConfig override that supersedes model.identifierConfig() when the snapshot keys are built.

Method Summary

Modifier and Type	Method and Description
void	close()
CatalogProviderId	id()
static InMemoryCatalogSnapshot	materialize(UnifiedCatalogModel model) Translate a UnifiedCatalogModel into a fully-materialized InMemoryCatalogSnapshot.
static InMemoryCatalogSnapshot	materialize(UnifiedCatalogModel model, IdentifierConfig identifierConfig) Same as materialize(UnifiedCatalogModel) but uses identifierConfig to build snapshot keys when non-null.
void	open(CatalogProviderConfig config)
CatalogSnapshot	refresh(CatalogQuery query) Force a fresh fetch bypassing any internal caches.
CatalogSnapshot	snapshot(CatalogQuery query)

Methods inherited from class Object

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

Constructor Detail

ModelBackedCatalogProvider

public ModelBackedCatalogProvider(UnifiedCatalogModel model)

ModelBackedCatalogProvider

public ModelBackedCatalogProvider(UnifiedCatalogModel model,
                                  IdentifierConfig identifierConfigOverride)

Construct a provider with an explicit IdentifierConfig override that supersedes model.identifierConfig() when the snapshot keys are built. Callers (notably CatalogLoaders) use this when CatalogLoadOptions carries an override the validator already accepted, so materialization keys agree with the policy validation ran under.

Method Detail

id

public CatalogProviderId id()

Specified by:

id in interface CatalogProvider

open

public void open(CatalogProviderConfig config)
          throws CatalogException

Specified by:

open in interface CatalogProvider

Throws:

CatalogException

snapshot

public CatalogSnapshot snapshot(CatalogQuery query)
                         throws CatalogException

Specified by:

snapshot in interface CatalogProvider

Throws:

CatalogException

refresh

public CatalogSnapshot refresh(CatalogQuery query)
                        throws CatalogException

Description copied from interface: CatalogProvider

Force a fresh fetch bypassing any internal caches.

Specified by:

refresh in interface CatalogProvider

Throws:

CatalogException

close

public void close()
           throws CatalogException

Specified by:

close in interface CatalogProvider

Specified by:

close in interface AutoCloseable

Throws:

CatalogException

materialize

public static InMemoryCatalogSnapshot materialize(UnifiedCatalogModel model)

Translate a UnifiedCatalogModel into a fully-materialized InMemoryCatalogSnapshot. Public so the bridge layer can call this directly when it needs a snapshot but does not want to wire a provider lifecycle.

materialize

public static InMemoryCatalogSnapshot materialize(UnifiedCatalogModel model,
                                                  IdentifierConfig identifierConfig)

Same as materialize(UnifiedCatalogModel) but uses identifierConfig to build snapshot keys when non-null. Pass null to fall back to model.identifierConfig(). Used by CatalogLoaders so an explicit CatalogLoadOptions.identifierConfig flows through to materialization (otherwise the snapshot keys would diverge from the policy that validation accepted).