Package gudusoft.gsqlparser.parser
Class OdbcSqlParser
Object
gudusoft.gsqlparser.parser.AbstractSqlParser
gudusoft.gsqlparser.parser.OdbcSqlParser
- All Implemented Interfaces:
SqlParser
ODBC database SQL parser implementation.
This parser handles ODBC-specific SQL syntax including:
- ODBC escape sequences ({ ... })
- ODBC date/time literals ({ d 'date' }, { t 'time' }, { ts 'timestamp' })
- ODBC function calls ({ fn function_name(...) })
- ODBC outer join syntax ({ oj outer_join })
- ODBC CALL statements ({ call procedure_name(...) })
- Base MSSQL syntax (inherited)
Design Notes:
- Extends
AbstractSqlParserusing the template method pattern - Uses
TLexerOdbcfor tokenization - Uses
TParserOdbcfor parsing - Based on MSSQL parser with ODBC escape sequence handling
- Delimiter character: ';' for SQL statements
Usage Example:
// Get ODBC parser from factory
SqlParser parser = SqlParserFactory.get(EDbVendor.dbvodbc);
// Build context
ParserContext context = new ParserContext.Builder(EDbVendor.dbvodbc)
.sqlText("SELECT * FROM Employees WHERE hire_date > { d '2020-01-01' }")
.build();
// Parse
SqlParseResult result = parser.parse(context);
// Access statements
TStatementList statements = result.getSqlStatements();
- Since:
- 3.3.0.0
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser
AbstractSqlParser.PreparedSqlReader -
Field Summary
FieldsFields inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser
defaultDelimiterStr, delimiterChar, frameStack, globalContext, globalFrame, lexer, parserContext, sourcetokenlist, sqlcmds, sqlEnv, sqlstatements, syntaxErrors, vendor -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected voidCall ODBC-specific raw statement extraction logic.protected TCustomLexergetLexer(ParserContext context) Return the ODBC lexer instance.protected TCustomParsergetParser(ParserContext context, TSourceTokenList tokens) Return the ODBC SQL parser instance with updated token list.protected voidperformInterpreter(ParserContext context, TStatementList statements) Perform interpretation/evaluation on parsed statements.protected TStatementListperformParsing(ParserContext context, TCustomParser parser, TCustomParser secondaryParser, TSourceTokenList tokens, TStatementList rawStatements) Perform full parsing of statements with syntax checking.protected voidperformSemanticAnalysis(ParserContext context, TStatementList statements) Perform ODBC-specific semantic analysis using TSQLResolver.protected voidSetup ODBC parser for raw statement extraction.protected voidCall ODBC-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
-
Field Details
-
flexer
The ODBC lexer used for tokenization
-
-
Constructor Details
-
OdbcSqlParser
public OdbcSqlParser()Construct ODBC SQL parser.Configures the parser for ODBC database with default delimiter (;).
Following the original TGSqlParser pattern, the lexer and parser are created once in the constructor and reused for all parsing operations.
-
-
Method Details
-
getLexer
Return the ODBC lexer instance.- Specified by:
getLexerin classAbstractSqlParser- Parameters:
context- the parser context- Returns:
- configured lexer instance (never null)
-
getParser
Return the ODBC SQL parser instance with updated token list.- Specified by:
getParserin classAbstractSqlParser- Parameters:
context- the parser contexttokens- the source token list- Returns:
- configured parser instance (never null)
-
tokenizeVendorSql
Call ODBC-specific tokenization logic.Delegates to doodbcsqltexttotokenlist which handles ODBC's specific escape sequences and MSSQL base syntax.
- Specified by:
tokenizeVendorSqlin classAbstractSqlParser
-
setupVendorParsersForExtraction
Setup ODBC parser for raw statement extraction.ODBC uses a single parser, so we inject sqlcmds and update the token list for the main parser only.
- Specified by:
setupVendorParsersForExtractionin classAbstractSqlParser
-
extractVendorRawStatements
Call ODBC-specific raw statement extraction logic.Delegates to doodbcgetrawsqlstatements which handles ODBC's statement delimiters (inherits from MSSQL: semicolon and GO command).
- Specified by:
extractVendorRawStatementsin classAbstractSqlParser- 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.This method orchestrates the parsing of all statements.
- Specified by:
performParsingin classAbstractSqlParser- Parameters:
context- the parser contextparser- the main parser instancesecondaryParser- secondary parser (may be null)tokens- the source token listrawStatements- raw statements already extracted (never null)- Returns:
- statement list with parsed AST (never null)
-
performSemanticAnalysis
Perform ODBC-specific semantic analysis using TSQLResolver.- Overrides:
performSemanticAnalysisin classAbstractSqlParser- Parameters:
context- the parser contextstatements- the parsed statements (mutable)
-
performInterpreter
Perform interpretation/evaluation on parsed statements.- Overrides:
performInterpreterin classAbstractSqlParser- Parameters:
context- the parser contextstatements- the parsed statements (mutable)
-