gudusoft.gsqlparser.sqlenv

Class IdentifierProfile

Object

gudusoft.gsqlparser.sqlenv.IdentifierProfile

public final class IdentifierProfile
extends Object

厂商标识符配置档案（Vendor Identifier Profile）

封装每个数据库厂商的完整标识符配置，包括：

• 按对象组（NAME_GROUP, COLUMN_GROUP, ROUTINE_GROUP）的标识符规则
• 按对象类别（catalog/project、schema、table、column…）的独立覆盖，见 IdentifierProfile.Builder.withObjectRules(ESQLDataObjectType, IdentifierRules)
• Vendor-specific flags（如 MySQL lower_case_table_names, SQL Server collation）

设计目标：

• 集中管理所有 vendor-specific 配置
• 统一注入路径，避免配置散落在各处
• 支持缓存失效（通过 fingerprint）

使用示例：

 // 创建 Oracle profile（使用默认 flags）
 IdentifierProfile oracleProfile = IdentifierProfile.forVendor(
     EDbVendor.dbvoracle,
     VendorFlags.defaults()
 );

 // 创建 MySQL profile（指定 lower_case_table_names）
 IdentifierProfile mysqlProfile = IdentifierProfile.forVendor(
     EDbVendor.dbvmysql,
     new VendorFlags(1, null, false, false)  // lower_case_table_names = 1
 );

 // 查询规则
 IdentifierRules tableRules = oracleProfile.getRules(ESQLDataObjectType.dotTable);
 

Since:

3.1.0.9

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IdentifierProfile.Builder Builder for creating customized IdentifierProfile instances.
static class	IdentifierProfile.ObjectGroup 对象组（用于区分不同对象类型的标识符规则）
static class	IdentifierProfile.VendorFlags Vendor-specific flags（厂商特定配置）

Method Summary

Modifier and Type	Method and Description
static IdentifierProfile.Builder	builder(EDbVendor vendor) Create a builder seeded from default rules for the given vendor with default VendorFlags.
static IdentifierProfile.Builder	builder(EDbVendor vendor, IdentifierProfile.VendorFlags flags) Create a builder seeded from default rules for the given vendor and the specified VendorFlags.
boolean	equals(Object o) Value equality over the complete effective strategy — see hasSameEffectivePolicyAs(gudusoft.gsqlparser.sqlenv.IdentifierProfile).
static IdentifierProfile	forVendor(EDbVendor vendor, IdentifierProfile.VendorFlags flags) 为指定厂商创建标识符配置档案
static IdentifierProfile	forVendorOr(IdentifierProfile configured, EDbVendor vendor) configured when it is a configuration for vendor, else that vendor's default profile.
long	getFingerprint() 计算配置指纹（用于 TObjectName 缓存失效）
IdentifierProfile.VendorFlags	getFlags() 获取 vendor flags
Map<ESQLDataObjectType,IdentifierRules>	getObjectRuleOverrides() The categories this profile configures explicitly, finest granularity first.
IdentifierRules	getRules(ESQLDataObjectType objectType) 获取指定对象类型的标识符规则
EDbVendor	getVendor() 获取数据库厂商
IdentifierProfile.ObjectGroup	groupOf(ESQLDataObjectType objectType) 将对象类型映射到对象组（公开访问器，供 CanonKey 的规则域标识使用）
int	hashCode()
boolean	hasSameEffectivePolicyAs(IdentifierProfile other) Whether this profile and other are the SAME effective strategy: same vendor, same flags, and the same resolved rule for every object category — regardless of how each was built (vendor default, group override, category override) or of object identity.
IdentifierRules	ruleDomainOf(ESQLDataObjectType objectType) The effective rule cell of one object category with SAME_AS_UNQUOTED resolved — the rule domain a CanonKey of that category belongs to.
IdentifierProfile.Builder	toBuilder() Create a builder pre-populated from this profile's current state.
String	toString()

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

forVendor

public static IdentifierProfile forVendor(EDbVendor vendor,
                                          IdentifierProfile.VendorFlags flags)

为指定厂商创建标识符配置档案

Parameters:

vendor - 数据库厂商

flags - vendor-specific flags

Returns:

标识符配置档案

forVendorOr

public static IdentifierProfile forVendorOr(IdentifierProfile configured,
                                            EDbVendor vendor)

configured when it is a configuration for vendor, else that vendor's default profile.

For the places that build an object of a dialect an analysis may or may not be configured for — a metadata file that declares its own dbVendor, nested SQL in another dialect. A profile belongs to exactly one vendor, so it is never transplanted onto another: rules chosen for BigQuery tables say nothing about Oracle's.

Parameters:

configured - the analysis's configuration, or null when there is none

vendor - the vendor the caller actually needs a profile for

Returns:

a profile for vendor; never null

builder

public static IdentifierProfile.Builder builder(EDbVendor vendor)

Create a builder seeded from default rules for the given vendor with default VendorFlags.

Parameters:

vendor - database vendor

Returns:

a new Builder

builder

public static IdentifierProfile.Builder builder(EDbVendor vendor,
                                                IdentifierProfile.VendorFlags flags)

Create a builder seeded from default rules for the given vendor and the specified VendorFlags.

Parameters:

vendor - database vendor

flags - vendor-specific flags

Returns:

a new Builder

toBuilder

public IdentifierProfile.Builder toBuilder()

Create a builder pre-populated from this profile's current state. Enables deriving a variant without re-specifying everything.

Returns:

a new Builder seeded from this profile

getRules

public IdentifierRules getRules(ESQLDataObjectType objectType)

获取指定对象类型的标识符规则

Parameters:

objectType - 对象类型

Returns:

标识符规则

ruleDomainOf

public IdentifierRules ruleDomainOf(ESQLDataObjectType objectType)

The effective rule cell of one object category with SAME_AS_UNQUOTED resolved — the rule domain a CanonKey of that category belongs to.

Since categories inside one IdentifierProfile.ObjectGroup may now carry different rules, the group alone no longer identifies the domain a canonical payload was produced in: with tables insensitive and schemas sensitive, a table keyed as orders and a schema literally named orders would otherwise produce equal keys. Two categories with the same effective cell share a domain, which is what keeps a default profile's table/schema/catalog keys interchangeable exactly as before.

Parameters:

objectType - the object category

Returns:

the resolved rule cell; never null

hasSameEffectivePolicyAs

public boolean hasSameEffectivePolicyAs(IdentifierProfile other)

Whether this profile and other are the SAME effective strategy: same vendor, same flags, and the same resolved rule for every object category — regardless of how each was built (vendor default, group override, category override) or of object identity.

The fingerprint is a hash: it can accelerate this answer but must never stand in for it, since distinct strategies can collide in 32 bits.

Parameters:

other - the profile to compare with; null is never the same strategy

Returns:

true if the two profiles decide every identifier question identically

equals

public boolean equals(Object o)

Value equality over the complete effective strategy — see hasSameEffectivePolicyAs(gudusoft.gsqlparser.sqlenv.IdentifierProfile). Two profiles that decide every identifier question the same way ARE the same profile, so an equivalent instance passed at a second entry point does not read as a conflicting configuration.

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getObjectRuleOverrides

public Map<ESQLDataObjectType,IdentifierRules> getObjectRuleOverrides()

The categories this profile configures explicitly, finest granularity first. Diagnostics only — the strategy itself is getRules(gudusoft.gsqlparser.sqlenv.ESQLDataObjectType).

Returns:

an unmodifiable view of the per-category overrides

getFlags

public IdentifierProfile.VendorFlags getFlags()

获取 vendor flags

Returns:

vendor flags

getVendor

public EDbVendor getVendor()

获取数据库厂商

Returns:

厂商

groupOf

public IdentifierProfile.ObjectGroup groupOf(ESQLDataObjectType objectType)

将对象类型映射到对象组（公开访问器，供 CanonKey 的规则域标识使用）

Parameters:

objectType - 对象类型

Returns:

对象组

getFingerprint

public long getFingerprint()

计算配置指纹（用于 TObjectName 缓存失效）

当 vendor 或 flags 变化时，指纹会改变，触发缓存失效

Returns:

配置指纹（64位哈希值）

toString

public String toString()

Overrides:

toString in class Object