gudusoft.gsqlparser.lineage2.contract

Class ContractJsonExporter

Object

gudusoft.gsqlparser.lineage2.contract.ContractJsonExporter

public final class ContractJsonExporter
extends Object

Deterministic JSON serializer for LineageDocument (lineage2-contract.md §2): same input + same engine version => byte-identical output.

Documented sort keys (applied by this exporter, regardless of model construction order):

• statements — statementIndex ascending;
• edges — target endpoint (database, schema, object, column; lower-cased, null → empty string), then source endpoint (same key; a null source sorts first as all-empty), then role, then axis, then statementIndex. Ties preserve construction order (stable sort);
• transformGraphs — statementIndex ascending;
• diagnostics (document-level and per-statement) — emitted in producer order, which the engine keeps deterministic (source order). No re-sort, so producers control clustering.

Output format matches json.dumps(doc, indent=2, ensure_ascii=False) of the gold-fixture generator: two-space indent, ": " key separator, non-ASCII characters emitted raw, contractVersion as the first key (consumers may short-circuit parse). No trailing newline (callers append one when writing files).

Key-emission conventions pinned by the gold fixtures:

• statement diagnostics omitted when empty;
• endpoint location: non-null location emitted alone; null location with a reason emitted as "sourceLocation": null + "locationNullReason"; both absent → keys omitted;
• transformation always carries both sourceLocation and locationNullReason keys (one of the two null);
• edge caseBranch always present (null when not a CASE edge); transformation omitted when null.

Internal API: not part of the public gsqlparser surface.

Method Summary

Modifier and Type	Method and Description
static String	toJson(LineageDocument document) Serialize document to deterministic contract JSON.

Methods inherited from class Object

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

Method Detail

toJson

public static String toJson(LineageDocument document)

Serialize document to deterministic contract JSON.