gudusoft.gsqlparser.resolver2.format

Class IdentityNameList

Object

gudusoft.gsqlparser.resolver2.format.IdentityNameList

public final class IdentityNameList
extends Object

Collects the names a listing will print and de-duplicates them by OBJECT IDENTITY, then picks which spelling to print with a DisplayNamePolicy.

The listings used to de-duplicate rendered strings case-insensitively. Rendered text has already lost what decides identity, so that was wrong in both directions:

• it MERGED distinct objects. BigQuery table names are case-sensitive, so Sales and SALES are two tables, yet only one reached the list — a silently missing table;
• it SPLIT one object. Oracle Sales, SALES and "SALES" are one table, yet the quoted spelling printed as a second row.

Identity comes from the unified name service (IdentifierService), per vendor and per object type — BigQuery tables compare case-sensitively while its columns do not, so the caller states the type and nothing here guesses it from text.

Constructor Summary

Constructors

Constructor and Description
IdentityNameList(EDbVendor vendor, DisplayNamePolicy policy)

Method Summary

Modifier and Type	Method and Description
void	add(String rendered, String lexical, ESQLDataObjectType objectType, String decoration, boolean definitionSite, String catalogRendered) Record one occurrence of a name.
void	addOpaque(String rendered) Record a line whose identity the caller cannot state (a synthesized or composite line).
void	clear()
boolean	isEmpty()
static String	renderCatalogTableName(EDbVendor vendor, TSQLEnv sqlEnv, TObjectName tableName, DisplayNameMode mode, SqlNameGenerator.QuotePolicy quotePolicy) How a listing prints the catalog's stored name for a table, or null when there is no catalog entry.
List<String>	resolve(DisplayNameMode mode) The lines to print: exactly ONE per object in every mode, sorted case-insensitively as the listings always were.

Methods inherited from class Object

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

Constructor Detail

IdentityNameList

public IdentityNameList(EDbVendor vendor,
                        DisplayNamePolicy policy)

Method Detail

clear

public void clear()

isEmpty

public boolean isEmpty()

add

public void add(String rendered,
                String lexical,
                ESQLDataObjectType objectType,
                String decoration,
                boolean definitionSite,
                String catalogRendered)

Record one occurrence of a name.

Parameters:

rendered - the text the listing would print for this occurrence, decorations included

lexical - the name as written in SQL (may be qualified); identity is derived from this, never from rendered

objectType - syntactic role of lexical

decoration - any suffix the listing appended ("(tetSelect)"); two occurrences of one object under different decorations are different lines. May be null.

definitionSite - true when this occurrence is where the object is defined

catalogRendered - how the listing would print the catalog's stored name for this object, or null when no catalog metadata is known

renderCatalogTableName

public static String renderCatalogTableName(EDbVendor vendor,
                                            TSQLEnv sqlEnv,
                                            TObjectName tableName,
                                            DisplayNameMode mode,
                                            SqlNameGenerator.QuotePolicy quotePolicy)

How a listing prints the catalog's stored name for a table, or null when there is no catalog entry. One rule shared by every writer, so the metadata rung of the policy cannot differ between them.

Only an unqualified reference is answered: a stored leaf name says nothing about how the qualifiers should be spelled, and none are invented. Under DisplayNameMode.SQL_RENDER the stored name is written back as SQL by SqlNameGenerator, delimited only when it must be.

addOpaque

public void addOpaque(String rendered)

Record a line whose identity the caller cannot state (a synthesized or composite line). It is de-duplicated only against an identical line, so it can never swallow a named object and never be swallowed by one.

resolve

public List<String> resolve(DisplayNameMode mode)

The lines to print: exactly ONE per object in every mode, sorted case-insensitively as the listings always were.

A DisplayNameMode decides HOW a name is written and a DisplayNamePolicy decides WHICH occurrence supplies the spelling; the two are orthogonal and no mode is exempt from the policy. DisplayNameMode.SQL_RENDER therefore prints the policy-chosen occurrence with its SQL delimiters kept, rather than one row per spelling: a listing row stands for an object, and how an object with several spellings is shown is the policy's question, not the mode's.

Parameters:

mode - accepted for symmetry with the writers; the rendering was already applied when each occurrence was added