gudusoft.gsqlparser.ir.semantic.diff

Class Lineage2Projector

Object

gudusoft.gsqlparser.ir.semantic.diff.Lineage2Projector

public final class Lineage2Projector
extends Object

Project a lineage2 contract JSON document (lineage2-contract.md §2, v0.9) into the CanonicalLineageModel comparison form shared with SemanticIRProjector and DlineageXmlProjector (US-010).

Mapping rules:

• VALUE-axis edges become EdgeRole.SELECT edges keyed by the lower-cased target column as outputName. The contract role (DIRECT/TRANSFORM/AGGREGATE/…) is preserved on CanonicalLineageEdge.getSemanticRole() for the DivergenceClass.ROLE_MISMATCH pass.
• ROW-axis edges become the typed null-output anchor edges: contract role JOIN maps to EdgeRole.JOIN, every other ROW-axis role (FILTER, and the R3 UNKNOWN fallback) maps to EdgeRole.FILTER — the same bucket legacy fdr projects into. The original role survives as the semanticRole.
• An output is flagged aggregate when any VALUE-axis edge feeding it carries contract role AGGREGATE.
• role: DERIVED edges have a null source by contract §4; they contribute the target output name (so output-presence comparison sees it) but no canonical edge.
• Base tables are the dot-joined non-empty database.schema.object endpoint parts, lower-cased — contract §4.1 promises physical endpoints arrive fully expanded.

Identity, transformation, location, confidence, and diagnostic fields are intentionally ignored: the canonical model compares lineage facts only. A document with no parseable edges array is ProjectorResult.UnsupportedReason.MALFORMED_CONTRACT_JSON; a valid document with zero edges is ProjectorResult.UnsupportedReason.NO_RELATIONSHIPS, mirroring the dlineage projector's convention.

Method Summary

Modifier and Type	Method and Description
static ProjectorResult	project(String contractJson)

Methods inherited from class Object

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

Method Detail

project

public static ProjectorResult project(String contractJson)

Parameters:

contractJson - one lineage2 contract document (the whole unit output, §2), as produced by the engine's exporter