org.sqlproc.engine.impl
Class SqlMetaStatement

java.lang.Object
  org.sqlproc.engine.impl.SqlMetaStatement

All Implemented Interfaces:

SqlMetaElement

public class SqlMetaStatement
extends java.lang.Object
implements SqlMetaElement

Precompiled META SQL statement. Instance of this class is created by the ANTLR parser. The grammar is defined in SqlStatement.g. It's based on the Composite (desing pattern). The main contract is SqlMetaElement.process(SqlProcessContext)

Schematically:

 SqlMetaStatement
     SqlMetaText
     SqlMetaIdent
     SqlMetaConst
     { SqlMetaAndOr}
     {? SqlMetaIf}
     {& SqlMetaAndOr}
     {| SqlMetaAndOr}
     {#DIGIT SqlMetaOrd}
 

Author:

Vladimir Hudec

Field Summary

(package private) java.util.List<SqlMetaElement>	elements All sub-elements based on ANTLR grammar defined in SqlStatement.g.
protected static org.slf4j.Logger	logger The internal slf4j logger.

Fields inherited from interface org.sqlproc.engine.impl.SqlMetaElement

AND_PREFIX, CONST_PREFIX, IDENT_PREFIX, IDENT_PREFIX_LEN, IDENT_SEPARATOR, OR_PREFIX

Constructor Summary

SqlMetaStatement()
Creates a new instance.

Method Summary

(package private) void	addElement(SqlMetaElement element) Adds a new sub-element.
static SqlMetaStatement	getInstance(java.lang.String statement) Simple factory method (design pattern).
SqlProcessResult	process(java.lang.Object dynamicInputValues, java.lang.Object staticInputValues, java.util.List<SqlOrder> order, java.util.Map<java.lang.String,java.lang.Object> features) The main contract for a dynamic ANSI SQL Query generation.
SqlProcessResult	process(SqlProcessContext ctx) The main contract for a dynamic ANSI SQL Query generation.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static org.slf4j.Logger logger

The internal slf4j logger.

elements

java.util.List<SqlMetaElement> elements

All sub-elements based on ANTLR grammar defined in SqlStatement.g.

Constructor Detail

SqlMetaStatement

SqlMetaStatement()

Creates a new instance. It's used from inside ANTLR parser.

Method Detail

getInstance

public static SqlMetaStatement getInstance(java.lang.String statement)
                                    throws SqlEngineException

Simple factory method (design pattern). The new instance of precompiled META SQL is created from the String input by the ANTLR parser.

Parameters:

statement - String representation of META SQL

Returns:

new instance of precompiled META SQL

Throws:

SqlEngineException - in the case of ANTLR parsing exception

addElement

void addElement(SqlMetaElement element)

Adds a new sub-element. It's used from inside ANTLR parser.

Parameters:

element - new sub-element, based on ANTLR grammar

process

public SqlProcessResult process(java.lang.Object dynamicInputValues,
                                java.lang.Object staticInputValues,
                                java.util.List<SqlOrder> order,
                                java.util.Map<java.lang.String,java.lang.Object> features)

The main contract for a dynamic ANSI SQL Query generation. The ANSI SQL Query creation is based on

• META SQL
• dynamic input values
• static input values
• ordering list directive
• optional features

  Parameters:

  dynamicInputValues - the SQL statement dynamic parameters (input values)

  staticInputValues - the SQL statement static parameters (input values)

  order - the list of ordering directives

  features - the optional SQL Processor features

  Returns:

  the crate for ANSI SQL and other attributes, which control the SQL statement itself

process

public SqlProcessResult process(SqlProcessContext ctx)

The main contract for a dynamic ANSI SQL Query generation. Also known as a META SQL processing. The composite pattern main contract. All ANTLR grammar based elements must implement this contract.

Specified by:

process in interface SqlMetaElement

Parameters:

ctx - the crate for all input parameters and the context of processing