gudusoft.gsqlparser.lineage2.contract

Class FingerprintV1

Object

gudusoft.gsqlparser.lineage2.contract.FingerprintV1

public final class FingerprintV1
extends Object

FINGERPRINT-V1 — query fingerprint participating in variant/occurrence identity, per lineage2-contract.md §3 [D-10] (normative source: CONTRACT_lineage_role_and_hash_identity.md rev 3, pinned commit b1d5d893).

This algorithm is promised stable across engine versions; any change requires a new name (FINGERPRINT-V2) and a contract major bump. Byte-identity against gudu-sqlflow/tools/lineage-contract-fixtures/hash_identity_fixtures.json is asserted by Lineage2ContractConformanceTest.

Algorithm (frozen):

1. input = exact statement text sliced from the artifact original (UTF-8);
2. strip comments: -- to end-of-line, /* */ with T-SQL nesting; comment markers inside '...' string literals and [...] / "..." quoted identifiers are not comment starts;
3. string literals and quoted identifiers preserved verbatim (including case); all other text lowercased;
4. whitespace runs collapse to one space; trim;
5. SHA-256 over UTF-8, 64 lowercase hex chars.

Internal API: not part of the public gsqlparser surface.

Method Summary

Modifier and Type	Method and Description
static String	fingerprint(String statementText) FINGERPRINT-V1 of the statement text: sha256 hex of normalize(String).
static String	normalize(String text) The normalization family shared with transformation normalizedExpression (contract §4.2): comment strip + lowercase outside quotes + whitespace collapse.

Methods inherited from class Object

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

Method Detail

fingerprint

public static String fingerprint(String statementText)

FINGERPRINT-V1 of the statement text: sha256 hex of normalize(String).

normalize

public static String normalize(String text)

The normalization family shared with transformation normalizedExpression (contract §4.2): comment strip + lowercase outside quotes + whitespace collapse. Null input normalizes to the empty string.