gudusoft.gsqlparser.parser

Class InformixSqlParser

Object

gudusoft.gsqlparser.parser.AbstractSqlParser

gudusoft.gsqlparser.parser.InformixSqlParser

All Implemented Interfaces:

SqlParser

public class InformixSqlParser
extends AbstractSqlParser

IBM Informix SQL parser implementation.

This parser handles Informix-specific SQL syntax including:

• Informix stored procedures and functions
• Informix triggers
• Informix execute statements
• Special token handling (CONNECT TO, LOCK TABLE, etc.)

Design Notes:

• Extends AbstractSqlParser using the template method pattern
• Uses TLexerInformix for tokenization
• Uses TParserInformix for parsing
• Delimiter character: ';' for SQL statements

Usage Example:

 // Get Informix parser from factory
 SqlParser parser = SqlParserFactory.get(EDbVendor.dbvinformix);

 // Build context
 ParserContext context = new ParserContext.Builder(EDbVendor.dbvinformix)
     .sqlText("SELECT * FROM customer WHERE customer_num = 101")
     .build();

 // Parse
 SqlParseResult result = parser.parse(context);

 // Access statements
 TStatementList statements = result.getSqlStatements();
 

Since:

3.2.0.0

See Also:

SqlParser, AbstractSqlParser, TLexerInformix, TParserInformix

Nested Class Summary

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

AbstractSqlParser.PreparedSqlReader

Field Summary

Fields

Modifier and Type	Field and Description
TLexerInformix	flexer The Informix 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 and Description
InformixSqlParser() Construct Informix SQL parser.

Method Summary

Modifier and Type	Method and Description
protected void	extractVendorRawStatements(SqlParseResult.Builder builder) Call Informix-specific raw statement extraction logic.
protected TCustomLexer	getLexer(ParserContext context) Return the Informix lexer instance.
protected TCustomParser	getParser(ParserContext context, TSourceTokenList tokens) Return the Informix SQL parser instance with updated token list.
protected TCustomParser	getSecondaryParser(ParserContext context, TSourceTokenList tokens) No secondary parser for Informix (only Oracle has dual parsers).
protected void	performInterpreter(ParserContext context, TStatementList statements) Perform interpretation (AST evaluation).
protected TStatementList	performParsing(ParserContext context, TCustomParser parser, TCustomParser secondaryParser, TSourceTokenList tokens, TStatementList rawStatements) Parse all raw statements.
protected void	performSemanticAnalysis(ParserContext context, TStatementList statements) Perform semantic analysis using TSQLResolver.
protected void	setupVendorParsersForExtraction() Setup parsers for raw statement extraction.
protected void	tokenizeVendorSql() Call Informix-specific tokenization logic.
String	toString()

Methods inherited from class gudusoft.gsqlparser.parser.AbstractSqlParser

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

Methods inherited from class Object

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

Field Detail

flexer

public TLexerInformix flexer

The Informix lexer used for tokenization

Constructor Detail

InformixSqlParser

public InformixSqlParser()

Construct Informix SQL parser.

Configures the parser for Informix 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 Detail

getLexer

protected TCustomLexer getLexer(ParserContext context)

Return the Informix 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 Informix SQL 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 Informix-specific tokenization logic.

Delegates to doinformixtexttotokenlist which handles Informix's special token transformations and statement recognition.

Specified by:

tokenizeVendorSql in class AbstractSqlParser

setupVendorParsersForExtraction

protected void setupVendorParsersForExtraction()

Setup parsers for raw statement extraction.

Informix uses a single parser (no secondary parser like Oracle).

Specified by:

setupVendorParsersForExtraction in class AbstractSqlParser

extractVendorRawStatements

protected void extractVendorRawStatements(SqlParseResult.Builder builder)

Call Informix-specific raw statement extraction logic.

Delegates to doinformixgetrawsqlstatements which handles Informix's statement boundary detection and stored procedure recognition.

Specified by:

extractVendorRawStatements in class AbstractSqlParser

Parameters:

builder - the result builder to populate with raw statements

getSecondaryParser

protected TCustomParser getSecondaryParser(ParserContext context,
                                           TSourceTokenList tokens)

No secondary parser for Informix (only Oracle has dual parsers).

Overrides:

getSecondaryParser in class AbstractSqlParser

Parameters:

context - the parser context

tokens - the source token list

Returns:

secondary parser instance, or null if not needed

performParsing

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

Parse all raw statements.

Migrated from TGSqlParser.doparse() with Informix-specific handling.

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)

Perform semantic analysis using TSQLResolver.

Inherited pattern from AbstractSqlParser with Informix-specific context.

Overrides:

performSemanticAnalysis in class AbstractSqlParser

Parameters:

context - the parser context

statements - the parsed statements (mutable)

performInterpreter

protected void performInterpreter(ParserContext context,
                                  TStatementList statements)

Perform interpretation (AST evaluation).

Inherited pattern from AbstractSqlParser with Informix-specific context.

Overrides:

performInterpreter in class AbstractSqlParser

Parameters:

context - the parser context

statements - the parsed statements (mutable)

toString

public String toString()

Overrides:

toString in class AbstractSqlParser