gudusoft.gsqlparser.dlineage.dataflow.model

Class ModelLabelKey

Object

gudusoft.gsqlparser.dlineage.dataflow.model.ModelLabelKey

public final class ModelLabelKey
extends Object

Identity of a dlineage model name that is not a SQL identifier — an expression rendering, a literal constant, a pseudo-rows marker, a function display label (stage S0 of docs/refactor/identifier_identity_display_separation_plan.md).

Why these need their own key

dlineage's name-keyed indexes hold a mixture: some entries are identifiers (a column, a table) and some are labels the analyzer invented to describe a computation. Running a label through identifier normalization applies the wrong rules to it: a constant 'Ab' is not an Oracle identifier that folds to 'AB', and two different expressions are not the same expression because a vendor happens to be case-insensitive. Conversely, comparing an identifier with equals is wrong in the other direction.

So labels compare exactly — byte-for-byte, no case folding, no delimiter stripping, no vendor rules — and they carry a ModelLabelKey.Kind so that a label can never collide with an identifier key or with a label of another kind in the same index. The root CLAUDE.md allows equalsIgnoreCase for "dlineage display names" precisely because they are not identifiers; this type is the positive form of that rule: if a name is a label, key it here, and the question of which vendor folding applies never arises.

This type deliberately does not decide whether a given model name is an identifier or a label — that is a per-call-site judgement made when the index is migrated in stage S3. It only makes the two representable as different things.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ModelLabelKey.Kind What kind of non-identifier name this is.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
ModelLabelKey.Kind	getKind()
String	getText() The label text, exactly as supplied.
int	hashCode()
static ModelLabelKey	of(ModelLabelKey.Kind kind, String text)
String	toString()

Methods inherited from class Object

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

Method Detail

of

public static ModelLabelKey of(ModelLabelKey.Kind kind,
                               String text)

Parameters:

kind - what sort of label this is; labels of different kinds never compare equal

text - the label exactly as the model holds it — not normalized, not trimmed

Throws:

IllegalArgumentException - if either argument is null. An empty string IS a legal label (an empty expression rendering is a real, distinguishable state); null is not, because a null label in an index is a bug, not a value.

getKind

public ModelLabelKey.Kind getKind()

getText

public String getText()

The label text, exactly as supplied.

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