gudusoft.gsqlparser.pp2.render

Class LexicalIslandRenderer

Object

gudusoft.gsqlparser.pp2.render.LexicalIslandRenderer

All Implemented Interfaces:

RegionRenderer

public final class LexicalIslandRenderer
extends Object
implements RegionRenderer

The full lexical island renderer: runs the S18-S29 analysis + layout pipeline over a region's tokens and emits the formatted text via Pp2OutputWriter.

Pipeline

1. Slice a region-local Pp2TokenStream from the region's token range.
2. Run S20 SQL scope, S19 block scope, S21 clause annotation, and S22 island recognition over the slice.
3. Build a LayoutContext (with those analyses + the vendor's DialectStrategy) and run the full LayoutRulePipeline: spacing, clause/set-operator linebreaks, JOIN/paren/comma, CASE/AND-OR, indent/alignment, and case modification.
4. Render with Pp2OutputWriter.

Fall-through contract

Per RegionRenderer, this returns null (so the engine falls back to the conservative renderer) on any Throwable, or if a TokenEquivalence content guard detects that the formatted output lost a solid token. Content preservation and never-throw are thus upheld even if a layout rule misbehaves — the conservative renderer remains the safety net.

Plan reference: §5.2, §7.3/S31, §7.4/S31, §10.4.

Constructor Summary

Constructors

Constructor and Description
LexicalIslandRenderer(EDbVendor vendor)

Method Summary

Modifier and Type	Method and Description
long	getFallthroughCount()
long	getSuccessCount()
RendererId	id() Identifier mirrored on RendererId so Pp2FormatResult.Region.getRendererId() reflects which strategy actually produced the text for the region.
String	render(RegionParseOutcome outcome, Pp2TokenStream stream, Pp2FormatOptions opts) Render the outcome's region to its final text.

Methods inherited from class Object

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

Constructor Detail

LexicalIslandRenderer

public LexicalIslandRenderer(EDbVendor vendor)

Method Detail

getSuccessCount

public long getSuccessCount()

getFallthroughCount

public long getFallthroughCount()

id

public RendererId id()

Description copied from interface: RegionRenderer

Identifier mirrored on RendererId so Pp2FormatResult.Region.getRendererId() reflects which strategy actually produced the text for the region.

Specified by:

id in interface RegionRenderer

render

public String render(RegionParseOutcome outcome,
                     Pp2TokenStream stream,
                     Pp2FormatOptions opts)

Description copied from interface: RegionRenderer

Render the outcome's region to its final text.

Specified by:

render in interface RegionRenderer

Parameters:

outcome - non-null parse outcome for the region. Implementations may assume RegionParseOutcome.getRange() and RegionParseOutcome.getParsedSql() are non-null. RegionParseOutcome.getParser() is non-null only for AST_OK outcomes.

stream - the engine's full Pp2TokenStream for the whole input script (token-based renderers slice into it via the outcome's range token indices)

opts - non-null pp2 options

Returns:

the formatted text for this region, or null (the only sentinel) to signal fall-through to the next renderer in the chain. An empty string is a valid rendering, not a fall-through.