gudusoft.gsqlparser.sqlenv

Class ApproximateIdentifierKey

Object

gudusoft.gsqlparser.sqlenv.ApproximateIdentifierKey

public final class ApproximateIdentifierKey
extends Object

Best-effort identifier key for rule cells the persistent API cannot serve exactly (plan §6, docs/designs/persistent-canonical-identity-implementation-plan.md).

Where IdentifierService.persistentKeyV1(gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, gudusoft.gsqlparser.sqlenv.IdentifierInputForm) throws — collation-based cells (SQL Server CI collations compare via collator weights that cannot be reproduced portably) and mixed-kind custom profiles — IdentifierService.approximateKeyV1(gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, gudusoft.gsqlparser.sqlenv.IdentifierInputForm) still serves: quote-strip plus pinned simple case-fold collapse (GspCaseData.simpleFoldCollapse(java.lang.String)).

No biconditional. Approximate key equality neither implies nor is implied by IdentifierService.areEqual(java.lang.String, java.lang.String, gudusoft.gsqlparser.sqlenv.ESQLDataObjectType): a CI collation may equate strings the collapse distinguishes (accent-insensitive collations) and may distinguish strings the collapse equates. Use these keys for grouping, bucketing and diagnostics — never as proof of identity.

Distinct type by design. This is deliberately NOT a PersistentIdentifierKey and lives in its own policy namespace (ak1-…): the two types can never compare equal, so an approximate key can never be stored where an exact key is expected.

The public constructor rehydrates a persisted key; minting goes through IdentifierService.approximateKeyV1(gudusoft.gsqlparser.sqlenv.ESQLDataObjectType, java.lang.String, gudusoft.gsqlparser.sqlenv.IdentifierInputForm).

Since:

4.1.5.15 (persistent canonical-identity slice U3)

Constructor Summary

Constructors

Constructor and Description
ApproximateIdentifierKey(String policyId, IdentifierProfile.ObjectGroup group, String payload) Rehydrate a key from its persisted fields.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
IdentifierProfile.ObjectGroup	getGroup() Object group — part of key identity, like the exact key's.
String	getPayload() Collapsed payload text.
String	getPolicyId() Policy identity: "ak1-" + base64url(SHA-256(canonicalDescriptor)).
int	hashCode()
String	toString()

Methods inherited from class Object

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

Constructor Detail

ApproximateIdentifierKey

public ApproximateIdentifierKey(String policyId,
                                IdentifierProfile.ObjectGroup group,
                                String payload)

Rehydrate a key from its persisted fields.

Parameters:

policyId - policy identity (ak1-…) the payload was minted under

group - object group the key belongs to

payload - collapsed payload text

Method Detail

getPolicyId

public String getPolicyId()

Policy identity: "ak1-" + base64url(SHA-256(canonicalDescriptor)).

getGroup

public IdentifierProfile.ObjectGroup getGroup()

Object group — part of key identity, like the exact key's.

getPayload

public String getPayload()

Collapsed payload text.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object