gudusoft.gsqlparser.lineage2.api

Class LineageAnalyzer

Object

gudusoft.gsqlparser.lineage2.api.LineageAnalyzer

public final class LineageAnalyzer
extends Object

lineage2 engine entry point (lineage2-execution-plan.md §3): analyzes one unit (a SQL file or script) and produces the uniform contract document (lineage2-contract.md).

The document carries the statement inventory — 1-based statementIndex in source order, contract kind, FINGERPRINT-V1 queryFingerprint, absolute sourceLocation (1-based, half-open, trailing statement separator excluded) — plus statement-level degrade [D-09]: a statement that fails to parse yields a PARSE_FAILED diagnostic on its own entry and the remaining statements are unaffected; the engine never throws for malformed SQL. Edge extraction is per statement kind: SELECT statements flow through StatementLineageExtractor (US-021); the remaining kinds land with their stories (US-022+), so transformGraphs is still empty.

The artifactLocator is bound here, at the API boundary where the unit is known: from LineageConfig.getArtifactLocator() for text input, or the file's base name for the File overload (the config value wins when non-empty).

The Catalog parameter feeds the semantic gate and the endpoint resolutionStatus computation; the full BindingGate (AMBIGUOUS / PARSER_UNSUPPORTED facts) arrives with US-025.

This class is stateless and its static methods are safe to call from multiple threads.

Internal API: not part of the public gsqlparser surface.

Method Summary

Modifier and Type	Method and Description
static LineageResult	analyze(File unitFile, EDbVendor vendor, Catalog catalog, LineageConfig config) Analyze a unit supplied as a file (read as UTF-8).
static LineageResult	analyze(String unitText, EDbVendor vendor, Catalog catalog, LineageConfig config) Analyze a unit supplied as text.

Methods inherited from class Object

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

Method Detail

analyze

public static LineageResult analyze(String unitText,
                                    EDbVendor vendor,
                                    Catalog catalog,
                                    LineageConfig config)

Analyze a unit supplied as text.

Parameters:

unitText - non-null SQL text of the whole unit

vendor - non-null vendor enum

catalog - optional catalog snapshot; may be null

config - optional configuration; null means LineageConfig.defaults()

Returns:

the contract document wrapped in a LineageResult; never throws for malformed SQL (runtime exceptions signal engine bugs, per contract §2)

analyze

public static LineageResult analyze(File unitFile,
                                    EDbVendor vendor,
                                    Catalog catalog,
                                    LineageConfig config)
                             throws IOException

Analyze a unit supplied as a file (read as UTF-8). The artifactLocator defaults to the file's base name; a non-empty LineageConfig.getArtifactLocator() overrides it.

Throws:

IOException - when the file cannot be read — I/O failures are the caller's concern, unlike SQL-level failures which degrade into diagnostics