gudusoft.gsqlparser.pp2.render

Class RenderedRegion

Object

gudusoft.gsqlparser.pp2.render.RenderedRegion

public final class RenderedRegion
extends Object

Immutable coupling of a StatementRange and the text a RegionRenderer produced for that range.

Created by Pp2Engine (S16) after dispatching each region to the appropriate renderer, and consumed by RegionAssembler (S15) which interleaves the rendered texts with the original inter-region trivia.

Leading-whitespace convention

Every RegionRenderer implementation omits the leading whitespace for the first token of its range — the bytes that sit in the original source between the previous region's end and this region's first token. The RegionAssembler is the counterparty: it fills those gaps verbatim from SourceSpanLedger.getSource().

Plan reference: §10.4 (engine dispatch loop), §7.3/S15, §7.3/S16.

Constructor Summary

Constructors

Constructor and Description
RenderedRegion(StatementRange range, String text, RendererId rendererId)

Method Summary

Modifier and Type	Method and Description
StatementRange	getRange() The statement boundary this rendering covers.
RendererId	getRendererId() Which renderer produced this text.
String	getText() The rendered output text.
String	toString()

Methods inherited from class Object

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

Constructor Detail

RenderedRegion

public RenderedRegion(StatementRange range,
                      String text,
                      RendererId rendererId)

Parameters:

range - the statement boundary covering this rendering; StatementRange.getStartOffset() and StatementRange.getEndOffset() are the byte coordinates the assembler reads to locate inter-region trivia

text - the rendered output; "" is valid for an empty region; must not be null

rendererId - which renderer produced text; non-null

Method Detail

getRange

public StatementRange getRange()

The statement boundary this rendering covers.

getText

public String getText()

The rendered output text. By convention, starts with the first token's text (no leading whitespace); ends with the last token's text (no trailing whitespace from the inter-region gap). May be "" for a legitimately empty region.

getRendererId

public RendererId getRendererId()

Which renderer produced this text.

toString

public String toString()

Overrides:

toString in class Object