gudusoft.gsqlparser.sqlenv

Class NameService

Object

gudusoft.gsqlparser.sqlenv.NameService

public class NameService
extends Object

Vendor-aware and type-aware name comparison utilities over the CANONICAL identifier-equality engine (unification plan P0d follow-up).

Equality delegates to IdentifierService.areEqualStatic(gudusoft.gsqlparser.EDbVendor, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, java.lang.String) and the set/dedup utilities key by CanonKey, so every operation here observes exactly the same relation as SQLUtil.sameName / TSQLEnv.compareIdentifier. The previous implementation routed through the SqlNameMatcher framework configured from the legacy per-type case booleans, which collapsed quoted-case distinctions the canonical rules preserve (e.g. BigQuery tables, Couchbase).

Since:

3.2.0.3 (Phase 1); canonical since P0d

Constructor Summary

Constructors

Constructor and Description
NameService(EDbVendor vendor) Creates a new NameService for the specified database vendor.

Method Summary

Modifier and Type	Method and Description
Set<String>	createSet(ESQLDataObjectType type) Creates a Set whose membership follows canonical name equality: names are the same element iff their CanonKeys are equal.
List<String>	distinctCopy(ESQLDataObjectType type, Iterable<String> names) Creates a distinct copy of a collection, removing canonical duplicates.
boolean	equals(ESQLDataObjectType type, String name1, String name2) Checks if two names are equal under the canonical identifier-equality relation (IdentifierService.areEqualStatic(gudusoft.gsqlparser.EDbVendor, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, java.lang.String)) for this vendor and object type.
EDbVendor	getVendor() Returns the database vendor associated with this service.
int	indexOf(ESQLDataObjectType type, Iterable<String> names, String target) Finds the index of a name in a collection under canonical equality.
boolean	isCaseSensitive(ESQLDataObjectType type) Whether the UNQUOTED comparison policy for this object type is case-sensitive.

Methods inherited from class Object

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

Constructor Detail

NameService

public NameService(EDbVendor vendor)

Creates a new NameService for the specified database vendor.

Parameters:

vendor - the database vendor

Method Detail

getVendor

public EDbVendor getVendor()

Returns the database vendor associated with this service.

Returns:

the database vendor

equals

public boolean equals(ESQLDataObjectType type,
                      String name1,
                      String name2)

Checks if two names are equal under the canonical identifier-equality relation (IdentifierService.areEqualStatic(gudusoft.gsqlparser.EDbVendor, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, java.lang.String)) for this vendor and object type.

Parameters:

type - the SQL object type (table, column, function, etc.)

name1 - the first name to compare

name2 - the second name to compare

Returns:

true if the names refer to the same object

indexOf

public int indexOf(ESQLDataObjectType type,
                   Iterable<String> names,
                   String target)

Finds the index of a name in a collection under canonical equality.

This is a case-aware version of List.indexOf().

Parameters:

type - the SQL object type

names - the collection of names to search

target - the name to find

Returns:

the index of the first matching name, or -1 if not found

distinctCopy

public List<String> distinctCopy(ESQLDataObjectType type,
                                 Iterable<String> names)

Creates a distinct copy of a collection, removing canonical duplicates.

Preserves insertion order and the first spelling seen. For example, for a case-insensitive domain:

 ["foo", "FOO", "bar", "Bar"] → ["foo", "bar"]
 

Parameters:

type - the SQL object type

names - the collection of names (may contain duplicates)

Returns:

a new list with duplicates removed, preserving order

createSet

public Set<String> createSet(ESQLDataObjectType type)

Creates a Set whose membership follows canonical name equality: names are the same element iff their CanonKeys are equal.

Parameters:

type - the SQL object type

Returns:

a new Set with canonical name equality

isCaseSensitive

public boolean isCaseSensitive(ESQLDataObjectType type)

Whether the UNQUOTED comparison policy for this object type is case-sensitive.

Quoted operands may follow a different rule (quoted-case-preserving vendors); this describes only the unquoted policy from the vendor's identifier rules.

Parameters:

type - the object type

Returns:

true if unquoted names compare case-sensitively