gudusoft.gsqlparser.resolver2.binding

Class SqlBinding

Object

gudusoft.gsqlparser.resolver2.binding.SqlBinding

public final class SqlBinding
extends Object

Public, static façade for the binding-diagnostic API.

Plan §5.3 / §7.3 S17: third-party consumers (SQL Guard, lineage, lint, IDE) that just want a BindingResult for a single SQL snippet can call resolve(String, EDbVendor, TSQLEnv, TSQLResolverConfig) instead of wiring a TGSqlParser themselves.

The façade is a thin convenience wrapper around the standard parse-and-resolve pipeline:

1. Construct a TGSqlParser for the requested vendor.
2. Apply the supplied TSQLEnv and TSQLResolverConfig (or default empty config when null).
3. Force resolver2 (EResolverType.RESOLVER2) so the binding post-pass has its required substrate.
4. Call TGSqlParser.parse() exactly once. Resolver2 is auto-invoked from inside parse() per the project contract (CLAUDE.md §"TSQLResolver2 is Automatically Invoked"). The façade never calls resolver.resolve() again — doing so would double-mutate the AST (plan §7.5 #2).
5. Return the BindingResult produced by the post-pass; on syntax error, returns the empty result.

If the supplied config does not enable any binding flag, the result is non-null and empty — same as direct parser usage. To get diagnostics, supply a config with at least TSQLResolverConfig.setEmitBindingDiagnostics(boolean) on.

Thread-safety: stateless. Each call constructs its own parser.

Since:

4.1

Method Summary

Modifier and Type	Method and Description
static BindingResult	resolve(String sql, EDbVendor vendor, TSQLEnv env, TSQLResolverConfig config) Parse and resolve sql against the supplied vendor / catalog, returning the binding result.

Methods inherited from class Object

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

Method Detail

resolve

public static BindingResult resolve(String sql,
                                    EDbVendor vendor,
                                    TSQLEnv env,
                                    TSQLResolverConfig config)

Parse and resolve sql against the supplied vendor / catalog, returning the binding result.

Parameters:

sql - the SQL text; must not be null

vendor - the SQL dialect; must not be null

env - catalog metadata supplied to the resolver. May be null; in that case the parser is left without authoritative metadata and most diagnostics will report METADATA_UNAVAILABLE rather than UNKNOWN_COLUMN (plan §5.5).

config - resolver configuration. May be null; in that case a default config is used (no binding diagnostics will be emitted because all flags default off).

Returns:

the BindingResult; never null, even when parsing fails (returns BindingResult.empty()).