gudusoft.gsqlparser.resolver2.binding

Enum BindingSkipReason

Object

Enum<BindingSkipReason>

gudusoft.gsqlparser.resolver2.binding.BindingSkipReason

All Implemented Interfaces:

Serializable, Comparable<BindingSkipReason>

public enum BindingSkipReason
extends Enum<BindingSkipReason>

Reasons that a TObjectName reference is intentionally excluded from binding-diagnostic emission.

Slice S3 introduces this enum as the deterministic input the BindingDiagnosticPostPass (S5+) uses to skip references that resolver2 either did not resolve (synthetic clones, syntax-error blocked) or that would be category errors to flag (definition sites, target columns, unsupported scopes, metadata-unavailable namespaces).

The enum is exposed as public so it can be stored on ResolutionContext (different package) but is intentionally absent from any documented public binding API surface — see plan §5.7 ("Public BindingDiagnostic.getSkipReason() accessor — leaks resolver internals; rejected").

Enum Constant Summary

Enum Constants

Enum Constant and Description
DEFINITION_SITE Reference is a definition site (CTE column-list entry, alias clause, VALUES alias, pivot output, CTAS target column list, etc.) — not a use site.
METADATA_UNAVAILABLE Reference resolved against a namespace whose authoritative metadata is unavailable.
SYNTAX_ERROR_BLOCKED Reference comes from a parse with a non-zero return code.
SYNTHETIC_STAR_CLONE Reference is a synthetic clone produced by star-column push-down / createTracedColumnClones.
TARGET_COLUMN Reference is a DML target column (e.g.
UNSUPPORTED_SCOPE Reference falls inside a binding scope resolver2 cannot yet model (e.g.

Method Summary

Modifier and Type	Method and Description
static BindingSkipReason	valueOf(String name) Returns the enum constant of this type with the specified name.
static BindingSkipReason[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

SYNTHETIC_STAR_CLONE

public static final BindingSkipReason SYNTHETIC_STAR_CLONE

Reference is a synthetic clone produced by star-column push-down / createTracedColumnClones. The clone has a sourceTable set but never goes through NameResolver.resolve(); the post-pass must skip it to avoid double-reporting and false UNKNOWN_COLUMN.

DEFINITION_SITE

public static final BindingSkipReason DEFINITION_SITE

Reference is a definition site (CTE column-list entry, alias clause, VALUES alias, pivot output, CTAS target column list, etc.) — not a use site. Wired by S13's BindingReferenceClassifier; reserved here.

TARGET_COLUMN

public static final BindingSkipReason TARGET_COLUMN

Reference is a DML target column (e.g. INSERT (a,b) list, the LHS of UPDATE SET, MERGE INSERT target). Targets must not emit UNKNOWN_COLUMN. Wired by S13.

METADATA_UNAVAILABLE

public static final BindingSkipReason METADATA_UNAVAILABLE

Reference resolved against a namespace whose authoritative metadata is unavailable. Strict mode upgrades this to a WARNING diagnostic in S6; non-strict mode stays silent.

UNSUPPORTED_SCOPE

public static final BindingSkipReason UNSUPPORTED_SCOPE

Reference falls inside a binding scope resolver2 cannot yet model (e.g. NATURAL JOIN AST gaps for some dialects, dynamic struct fields). Strict mode upgrades to UNSUPPORTED_BINDING_SCOPE in S8/S12.

SYNTAX_ERROR_BLOCKED

public static final BindingSkipReason SYNTAX_ERROR_BLOCKED

Reference comes from a parse with a non-zero return code. Per plan §5.6.9 binding diagnostics are silent on syntax-error parses; the trace records this skip reason so callers that inspect ResolutionContext directly can still tell intent from gap.

Method Detail

values

public static BindingSkipReason[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (BindingSkipReason c : BindingSkipReason.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static BindingSkipReason valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null