Package dev.frostlake.executor

Class ParseTreeText

java.lang.Object

dev.frostlake.executor.ParseTreeText

public final class ParseTreeText
extends Object

Stateless helpers that read text and names out of ANTLR parse-tree nodes. Extracted from QueryExecutor so query stages can share the same parse-tree text extraction without depending on engine instance state — every method here is a pure function of its arguments.

Method Summary

Modifier and Type	Method	Description
static String	extractStringLiteral(org.antlr.v4.runtime.tree.TerminalNode node)
static List<FrostlakeParser.BooleanExprContext>	functionBooleanArgs(FrostlakeParser.FunctionArgListContext list)	The plain (non-lambda) boolean-expression arguments of a function call.
static String[]	functionNameParts(FrostlakeParser.FunctionNameContext ctx)	The canonical parts of a function's name, or null for a name that is a keyword or an IDENTIFIER(...); an empty middle part, db..f, is the database's PUBLIC schema.
static String	getIdentifier(FrostlakeParser.AliasNameContext ctx)	The canonical text of an ALIAS, which may be an ordinary identifier or one of the words legal only in a name position (CASE, CAST, CONSTRAINT, CROSS, DEFAULT, INNER, JOIN, WHEN).
static String	getIdentifier(FrostlakeParser.IdentifierContext ctx)
static String	getIdentifier(org.antlr.v4.runtime.tree.TerminalNode node)
static String	getOriginalText(org.antlr.v4.runtime.ParserRuleContext ctx)
static String	getQualifiedName(FrostlakeParser.QualifiedNameContext ctx)
static String	getQualifiedName(FrostlakeParser.StarQualifiedNameContext ctx)	The <name>.* flavour of getQualifiedName(dev.frostlake.parser.FrostlakeParser.QualifiedNameContext).
static String	getQualifiedName(FrostlakeParser.TableQualifiedNameContext ctx)	The FROM-position flavour of getQualifiedName(dev.frostlake.parser.FrostlakeParser.QualifiedNameContext).
static FrostlakeParser.SelectClauseContext	getSelectClause(FrostlakeParser.SelectOperandContext op)	Extract SelectClauseContext from a selectOperand (bare or parenthesised).
static List<FrostlakeParser.SelectClauseContext>	getSelectClauses(FrostlakeParser.SelectStatementContext ctx)	Collect all top-level SelectClauseContexts from selectOperands (non-parenthesised ones).
static FrostlakeParser.WhereClauseContext	getWhereClause(FrostlakeParser.SelectClauseContext ctx)	Get the whereClause of a selectClause, or null when absent.
static boolean	hasEmptySchemaPart(FrostlakeParser.QualifiedNameContext ctx)	Whether a name leaves its middle part empty, db..t: it then has as many dots as written parts, where every other name has one dot fewer.
static String	namePartText(FrostlakeParser.ColumnDefNameContext part)	The COLUMN-DEFINITION flavour — the same vocabulary less CONSTRAINT, which leads a constraint.
static String	namePartText(FrostlakeParser.NamePartContext part)	See namePartText(FrostlakeParser.NameStartPartContext) — the after-dot flavour.
static String	namePartText(FrostlakeParser.NameStartPartContext part)	The canonical text of one name part: a regular identifier folds through SqlIdentifiers.canonical(dev.frostlake.parser.FrostlakeParser.IdentifierContext); a keyword-as-name part (INNER, JOIN, LEFT, CROSS, CASE) is unquoted by construction and upper-cases directly.
static Object	parseLiteral(FrostlakeParser.LiteralContext ctx)
static String[]	qualifiedNameParts(FrostlakeParser.QualifiedNameContext ctx)	The name parts of a qualified name, read from the parse tree instead of splitting its flattened text on '.' — correct even for a quoted identifier containing a dot.
static String[]	qualifiedNameParts(FrostlakeParser.StarQualifiedNameContext ctx)	The <name>.* flavour: a starQualifiedName's parts.
static String[]	qualifiedNameParts(FrostlakeParser.TableQualifiedNameContext ctx)	The FROM-position flavour: a tableQualifiedName's parts.
static String	writtenText(FrostlakeParser.StarQualifiedNameContext ctx)	A star qualifier as written, with an empty middle part (db..t.*) spelled out as the PUBLIC schema it names; any other qualifier exactly as written.

Methods inherited from class java.lang.Object

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

Method Details

getWhereClause

public static FrostlakeParser.WhereClauseContext getWhereClause(FrostlakeParser.SelectClauseContext ctx)

Get the whereClause of a selectClause, or null when absent.

getSelectClause

public static FrostlakeParser.SelectClauseContext getSelectClause(FrostlakeParser.SelectOperandContext op)

Extract SelectClauseContext from a selectOperand (bare or parenthesised).

getSelectClauses

public static List<FrostlakeParser.SelectClauseContext> getSelectClauses(FrostlakeParser.SelectStatementContext ctx)

Collect all top-level SelectClauseContexts from selectOperands (non-parenthesised ones).

getIdentifier

public static String getIdentifier(FrostlakeParser.IdentifierContext ctx)

getIdentifier

public static String getIdentifier(FrostlakeParser.AliasNameContext ctx)

The canonical text of an ALIAS, which may be an ordinary identifier or one of the words legal only in a name position (CASE, CAST, CONSTRAINT, CROSS, DEFAULT, INNER, JOIN, WHEN). The keyword form is unquoted by construction, so it upper-cases directly — the same split namePartText(dev.frostlake.parser.FrostlakeParser.NameStartPartContext) makes.

getQualifiedName

public static String getQualifiedName(FrostlakeParser.QualifiedNameContext ctx)

namePartText

public static String namePartText(FrostlakeParser.NameStartPartContext part)

The canonical text of one name part: a regular identifier folds through SqlIdentifiers.canonical(dev.frostlake.parser.FrostlakeParser.IdentifierContext); a keyword-as-name part (INNER, JOIN, LEFT, CROSS, CASE) is unquoted by construction and upper-cases directly.

namePartText

public static String namePartText(FrostlakeParser.NamePartContext part)

See namePartText(FrostlakeParser.NameStartPartContext) — the after-dot flavour.

namePartText

public static String namePartText(FrostlakeParser.ColumnDefNameContext part)

The COLUMN-DEFINITION flavour — the same vocabulary less CONSTRAINT, which leads a constraint.

qualifiedNameParts

public static String[] qualifiedNameParts(FrostlakeParser.TableQualifiedNameContext ctx)

The FROM-position flavour: a tableQualifiedName's parts.

getQualifiedName

public static String getQualifiedName(FrostlakeParser.TableQualifiedNameContext ctx)

The FROM-position flavour of getQualifiedName(dev.frostlake.parser.FrostlakeParser.QualifiedNameContext).

qualifiedNameParts

public static String[] qualifiedNameParts(FrostlakeParser.StarQualifiedNameContext ctx)

The <name>.* flavour: a starQualifiedName's parts.

getQualifiedName

public static String getQualifiedName(FrostlakeParser.StarQualifiedNameContext ctx)

The <name>.* flavour of getQualifiedName(dev.frostlake.parser.FrostlakeParser.QualifiedNameContext).

qualifiedNameParts

public static String[] qualifiedNameParts(FrostlakeParser.QualifiedNameContext ctx)

The name parts of a qualified name, read from the parse tree instead of splitting its flattened text on '.' — correct even for a quoted identifier containing a dot.

functionNameParts

public static String[] functionNameParts(FrostlakeParser.FunctionNameContext ctx)

The canonical parts of a function's name, or null for a name that is a keyword or an IDENTIFIER(...); an empty middle part, db..f, is the database's PUBLIC schema.

writtenText

public static String writtenText(FrostlakeParser.StarQualifiedNameContext ctx)

A star qualifier as written, with an empty middle part (db..t.*) spelled out as the PUBLIC schema it names; any other qualifier exactly as written.

hasEmptySchemaPart

public static boolean hasEmptySchemaPart(FrostlakeParser.QualifiedNameContext ctx)

Whether a name leaves its middle part empty, db..t: it then has as many dots as written parts, where every other name has one dot fewer.

functionBooleanArgs

public static List<FrostlakeParser.BooleanExprContext> functionBooleanArgs(FrostlakeParser.FunctionArgListContext list)

The plain (non-lambda) boolean-expression arguments of a function call. functionArgList now admits lambda arguments (for TRANSFORM/FILTER/REDUCE); aggregate/window/grouping call sites only ever have boolean-expression arguments, so this unwraps each functionArg to its booleanExpr.

getOriginalText

public static String getOriginalText(org.antlr.v4.runtime.ParserRuleContext ctx)

extractStringLiteral

public static String extractStringLiteral(org.antlr.v4.runtime.tree.TerminalNode node)

getIdentifier

public static String getIdentifier(org.antlr.v4.runtime.tree.TerminalNode node)

parseLiteral

public static Object parseLiteral(FrostlakeParser.LiteralContext ctx)