gudusoft.gsqlparser.sqlenv

Enum IdentifierInputForm

Object

Enum<IdentifierInputForm>

gudusoft.gsqlparser.sqlenv.IdentifierInputForm

All Implemented Interfaces:

Serializable, Comparable<IdentifierInputForm>

public enum IdentifierInputForm
extends Enum<IdentifierInputForm>

How an identifier string reached the caller — the two forms are NOT interchangeable and selecting the wrong one silently produces wrong keys (plan §6, docs/designs/persistent-canonical-identity-implementation-plan.md).

The same character sequence means different things in the two forms: Oracle lexical MixedCase denotes the stored name MIXEDCASE (unquoted identifiers fold upper), while the catalog-stored string MixedCase IS the stored name, exactly as the data dictionary holds it — equal to the lexical spelling "MixedCase", not to MixedCase.

Since:

4.1.5.15 (persistent canonical-identity slice U3)

Enum Constant Summary

Enum Constants

Enum Constant and Description
CATALOG_STORED The string is a name read back from a database catalog / data dictionary (INFORMATION_SCHEMA, ALL_TABLES, a metadata export): it is already the stored payload.
SQL_LEXICAL The string is SQL source text: quote recognition and strict decoding (IdentifierCodec.decodeLexical(gudusoft.gsqlparser.sqlenv.IdentifierProfile, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String)) apply, then the vendor's quote-state-specific fold.

Method Summary

Modifier and Type	Method and Description
static IdentifierInputForm	valueOf(String name) Returns the enum constant of this type with the specified name.
static IdentifierInputForm[]	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

SQL_LEXICAL

public static final IdentifierInputForm SQL_LEXICAL

The string is SQL source text: quote recognition and strict decoding (IdentifierCodec.decodeLexical(gudusoft.gsqlparser.sqlenv.IdentifierProfile, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String)) apply, then the vendor's quote-state-specific fold. A recognized-but-malformed quoted spelling is REJECTED (IdentifierCodec.MalformedIdentifierException) by persistentKeyV1 — the persistent API never guesses identity.

CATALOG_STORED

public static final IdentifierInputForm CATALOG_STORED

The string is a name read back from a database catalog / data dictionary (INFORMATION_SCHEMA, ALL_TABLES, a metadata export): it is already the stored payload. No quote recognition and no decoding are applied. The equivalence treatment is the one the vendor applies to stored names themselves: SENSITIVE domains keep the stored text; INSENSITIVE domains whose cell folds apply the cell's fold (idempotent on real catalog data — stored names ARE fold-images, so this keys them with the lexical spellings that produced them); never-folding INSENSITIVE cells use the case-fold collapse.

Method Detail

values

public static IdentifierInputForm[] 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 (IdentifierInputForm c : IdentifierInputForm.values())
    System.out.println(c);

Returns:

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

valueOf

public static IdentifierInputForm 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