Package gudusoft.gsqlparser.parser

Class SoqlSqlParser

Object

gudusoft.gsqlparser.parser.AbstractSqlParser

gudusoft.gsqlparser.parser.SoqlSqlParser

All Implemented Interfaces:

SqlParser

public class SoqlSqlParser
extends AbstractSqlParser

Salesforce SOQL (Salesforce Object Query Language) parser implementation.

This parser handles SOQL-specific SQL syntax including:

• SOQL SELECT statements
• SOQL relationship queries
• SOQL aggregate functions
• Salesforce-specific syntax elements

Design Notes:

• Extends AbstractSqlParser using the template method pattern
• Uses TLexerSoql for tokenization
• Uses TParserSoql for parsing
• Tokenization follows MSSQL pattern
• Delimiter character: ';' for SOQL statements

Since:

3.2.0.0

See Also:

• SqlParser
• AbstractSqlParser
• TLexerSoql
• TParserSoql

Nested Class Summary

Nested classes/interfaces inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser

AbstractSqlParser.PreparedSqlReader

Field Summary

Fields

Modifier and Type	Field	Description
TLexerSoql	flexer	The SOQL lexer used for tokenization

Fields inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser

defaultDelimiterStr, delimiterChar, frameStack, globalContext, globalFrame, lexer, parserContext, sourcetokenlist, sqlcmds, sqlEnv, sqlstatements, syntaxErrors, vendor

Constructor Summary

Constructors

Constructor	Description
SoqlSqlParser()	Construct SOQL parser.

Method Summary

Modifier and Type	Method	Description
protected void	extractVendorRawStatements(SqlParseResult.Builder builder)	Call SOQL-specific raw statement extraction logic.
protected TCustomLexer	getLexer(ParserContext context)	Return the SOQL lexer instance.
protected TCustomParser	getParser(ParserContext context, TSourceTokenList tokens)	Return the SOQL parser instance with updated token list.
protected void	performInterpreter(ParserContext context, TStatementList statements)	Perform interpretation/evaluation on parsed statements.
protected TStatementList	performParsing(ParserContext context, TCustomParser parser, TCustomParser secondaryParser, TSourceTokenList tokens, TStatementList rawStatements)	Perform full parsing of statements with syntax checking.
protected void	performSemanticAnalysis(ParserContext context, TStatementList statements)	Perform semantic analysis on parsed statements.
protected void	setupVendorParsersForExtraction()	Setup SOQL parser for raw statement extraction.
protected void	tokenizeVendorSql()	Call SOQL-specific tokenization logic.

Methods inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser

afterStatementParsed, attemptErrorRecovery, copyErrorsFromStatement, doAfterTokenize, doExtractRawStatements, extractRawStatements, getanewsourcetoken, getDefaultDelimiterStr, getDelimiterChar, getErrorCount, getrawsqlstatements, getSecondaryParser, getSyntaxErrors, getVendor, handleStatementParsingException, initializeGlobalContext, isDollarFunctionDelimiter, onRawStatementComplete, onRawStatementCompleteVendorSpecific, parse, performTokenization, prepareSqlReader, processTokensBeforeParse, processTokensInTokenTable, setTokenHandle, tokenize, toString, towinlinebreak

Methods inherited from class java.lang.Object

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

Field Details

flexer

public TLexerSoql flexer

The SOQL lexer used for tokenization

Constructor Details

SoqlSqlParser

public SoqlSqlParser()

Construct SOQL parser.

Configures the parser for Salesforce SOQL with default delimiter (;).

Method Details

getLexer

protected TCustomLexer getLexer(ParserContext context)

Return the SOQL lexer instance.

Specified by:

getLexer in class AbstractSqlParser

Parameters:

context - the parser context

Returns:

configured lexer instance (never null)

getParser

protected TCustomParser getParser(ParserContext context,
 TSourceTokenList tokens)

Return the SOQL parser instance with updated token list.

Specified by:

getParser in class AbstractSqlParser

Parameters:

context - the parser context

tokens - the source token list

Returns:

configured parser instance (never null)

tokenizeVendorSql

protected void tokenizeVendorSql()

Call SOQL-specific tokenization logic.

SOQL uses MSSQL-like tokenization.

Specified by:

tokenizeVendorSql in class AbstractSqlParser

setupVendorParsersForExtraction

protected void setupVendorParsersForExtraction()

Setup SOQL parser for raw statement extraction.

Specified by:

setupVendorParsersForExtraction in class AbstractSqlParser

extractVendorRawStatements

protected void extractVendorRawStatements(SqlParseResult.Builder builder)

Call SOQL-specific raw statement extraction logic.

Specified by:

extractVendorRawStatements in class AbstractSqlParser

Parameters:

builder - the result builder to populate with raw statements

performParsing

protected TStatementList performParsing(ParserContext context,
 TCustomParser parser,
 TCustomParser secondaryParser,
 TSourceTokenList tokens,
 TStatementList rawStatements)

Perform full parsing of statements with syntax checking.

Specified by:

performParsing in class AbstractSqlParser

Parameters:

context - the parser context

parser - the main parser instance

secondaryParser - secondary parser (may be null)

tokens - the source token list

rawStatements - raw statements already extracted (never null)

Returns:

statement list with parsed AST (never null)

performSemanticAnalysis

protected void performSemanticAnalysis(ParserContext context,
 TStatementList statements)

Description copied from class: AbstractSqlParser

Perform semantic analysis on parsed statements.

Hook Method: Default implementation does nothing. Override to provide vendor-specific semantic analysis.

Typical Implementation:

• Column-to-table resolution (TSQLResolver)
• Dataflow analysis
• Reference resolution
• Scope resolution

Overrides:

performSemanticAnalysis in class AbstractSqlParser

Parameters:

context - the parser context

statements - the parsed statements (mutable)

performInterpreter

protected void performInterpreter(ParserContext context,
 TStatementList statements)

Description copied from class: AbstractSqlParser

Perform interpretation/evaluation on parsed statements.

Hook Method: Default implementation does nothing. Override to provide AST interpretation/evaluation.

Typical Implementation:

• Execute simple SQL statements
• Evaluate expressions
• Constant folding
• Static analysis

Overrides:

performInterpreter in class AbstractSqlParser

Parameters:

context - the parser context

statements - the parsed statements (mutable)