org.ow2.jonas.lib.ejb21.sql
Class EjbqlQueryFilterVisitor

java.lang.Object
  org.ow2.jonas.lib.ejb21.sql.EjbqlAbstractVisitor
      org.ow2.jonas.lib.ejb21.sql.EjbqlQueryFilterVisitor

All Implemented Interfaces:

EJBQLVisitor

public class EjbqlQueryFilterVisitor
extends EjbqlAbstractVisitor

Implementation of a visitor that creates the filter corresponding to the WHERE clause. Created on Sep 6, 2002

Author:

Christophe Ney [cney@batisseurs.com] : Intial developer, Helene Joanin: Take into account the following operators abs(x), sqrt(x), length(str), substring(s, start, length), locate(str1, str2), locate(str1, str2, start)., Helene Joanin: EJBLocalObject as parameter of a EJB-QL query., Helene Joanin: Take into account the InExpression (IN operator)., Helene Joanin: Take into account the IS NULL operator., Helene Joanin: Fix a bug in the visitor for ASTIdentificationVariable: push a BasicFieldOperand(field) instead of the field itself., Helene Joanin: add '.element' to the path for CollectionValuedPathExpression., Helene Joanin: Convert IsNull(cmr-field) to Equal(cmr-field, PNameNull)., Helene Joanin: Take into account the operators: IS EMPTY / IS NOT EMPTY, Helene Joanin: Take into account the CONCAT operator, Helene Joanin: Take into account the EJBQL version 2.1 syntax., Helene Joanin: Take into account the operator MOD., Helene Joanin: Take into account the operator ISNULL with a parameter.

Nested Class Summary

Nested classes/interfaces inherited from class org.ow2.jonas.lib.ejb21.sql.EjbqlAbstractVisitor

EjbqlAbstractVisitor.IdValue, EjbqlAbstractVisitor.VisitorException

Constructor Summary

EjbqlQueryFilterVisitor(org.objectweb.jorm.api.PMapper _mapper, Map _fields, Class[] parameterTypes, ASTEJBQL ejbql, org.objectweb.medor.query.jorm.lib.QueryBuilder qb)
Constructor

Method Summary

org.objectweb.medor.expression.api.Expression	getQueryFilter() get the query filter that was built from visiting the syntaxic tree
Object	visit(ASTArithmeticExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTArithmeticFactor node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTArithmeticLiteral node, Object data) Visit child nodes arithmetic_literal ::= integer_literal | floatingpoint_literal
Object	visit(ASTArithmeticTerm node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTBetweenExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTBooleanExpression node, Object data) Visit child nodes boolean_expression ::= cmp_path_expression | boolean_literal | input_parameter
Object	visit(ASTBooleanLiteral node, Object data) Node with value set to litteral boolean.
Object	visit(ASTCmpPathExpression node, Object data) Push corresponding MedorField to the stack.
Object	visit(ASTCollectionMemberExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTCollectionValuedPathExpression node, Object data) Push corresponding MedorField to the stack.
Object	visit(ASTComparisonExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTConditionalExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTConditionalFactor node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTConditionalTerm node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTDatetimeExpression node, Object data) Visit child nodes datetime_expression ::= datetime_value | input_parameter
Object	visit(ASTEmptyCollectionComparisonExpression node, Object data) Nothing to do: Already taken into account in EjbqlVariableVisitor at the variables parsing, so, just push the OP_IGNORE in the stack empty_collection_comparison_expression ::= collection_valued_path_expression IS [ NOT ] EMPTY
Object	visit(ASTEntityBeanExpression node, Object data) Visit child nodes entity_bean_expression ::= entity_bean_value | input_parameter
Object	visit(ASTFloatingPointLiteral node, Object data) Node with value set to integer litteral arithmetic.
Object	visit(ASTFunctionsReturningNumerics node, Object data) visit child nodes Push corresponding Expression to the stack.
Object	visit(ASTFunctionsReturningStrings node, Object data) visit child nodes Push corresponding Expression to the stack.
Object	visit(ASTIdentificationVariable node, Object data) Node with value set to identification variable string.
Object	visit(ASTInExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTInputParameter node, Object data) Node with value set to parameter index (1..n) string.
Object	visit(ASTIntegerLiteral node, Object data) Node with value set to integer litteral arithmetic.
Object	visit(ASTLikeExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTLiteral node, Object data) Visit child nodes literal ::= string_literal | arithmetic_literal | boolean_literal
Object	visit(ASTNullComparisonExpression node, Object data) Push corresponding Expression to the stack.
Object	visit(ASTPath node, Object data) Push the Node to the stack
Object	visit(ASTSingleValuedCmrPathExpression node, Object data) Push corresponding MedorField to the stack.
Object	visit(ASTSingleValuedPathExpression node, Object data) Push corresponding MedorField to the stack.
Object	visit(ASTStringExpression node, Object data) Visit child nodes string_expression ::= string_primary | input_parameter
Object	visit(ASTStringLiteral node, Object data) Node with value set to litteral string.
Object	visit(ASTWhereClause node, Object data) If query contains WHERE clause, visit child nodes where_clause ::= WHERE conditional_expression

Methods inherited from class org.ow2.jonas.lib.ejb21.sql.EjbqlAbstractVisitor

basePath, endsWith, mergePath, mergePath, splitPath, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class java.lang.Object

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

Constructor Detail

EjbqlQueryFilterVisitor

public EjbqlQueryFilterVisitor(org.objectweb.jorm.api.PMapper _mapper,
                               Map _fields,
                               Class[] parameterTypes,
                               ASTEJBQL ejbql,
                               org.objectweb.medor.query.jorm.lib.QueryBuilder qb)
                        throws Exception

Constructor

Parameters:

_mapper - the mapper of each fields. Needed to build the expression for the IsNull with a reference as an operand. This parameter may be null in case of the GenIC phase

_fields - QueryTreeFields for all defined identifiers and all path expression of the query

parameterTypes - Type of paramaters of the finder/select method

ejbql - root of the lexical tree of the query

Throws:

Exception

Method Detail

getQueryFilter

public org.objectweb.medor.expression.api.Expression getQueryFilter()

get the query filter that was built from visiting the syntaxic tree

visit

public Object visit(ASTWhereClause node,
                    Object data)

If query contains WHERE clause, visit child nodes
where_clause ::= WHERE conditional_expression

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTSingleValuedPathExpression node,
                    Object data)

Push corresponding MedorField to the stack.
single_valued_path_expression ::= path was in initial BNF single_valued_path_expression ::= cmp_path_expression | single_valued_cmr_path_expression

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTCmpPathExpression node,
                    Object data)

Push corresponding MedorField to the stack.
cmp_path_expression ::= path was in initial BNF cmp_path_expression ::= identification_variable. [ single_valued_cmr_field. ] * cmp_field

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTSingleValuedCmrPathExpression node,
                    Object data)

Push corresponding MedorField to the stack.
single_valued_cmr_path_expression ::= path was in initial BNF single_valued_cmr_path_expression ::= identification_variable. [ single_valued_cmr_field. ] * single_valued_cmr_field

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTCollectionValuedPathExpression node,
                    Object data)

Push corresponding MedorField to the stack.
collection_valued_path_expression ::= path was in initial BNF collection_valued_path_expression ::= identification_variable. [ single_valued_cmr_field. ] *collection_valued_cmr_field

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTConditionalExpression node,
                    Object data)

Push corresponding Expression to the stack.
conditional_expression ::= conditional_term [ OR conditional_term ]*

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTConditionalTerm node,
                    Object data)

Push corresponding Expression to the stack.
conditional_term ::= conditional_factor [ AND conditional_factor ]*

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTConditionalFactor node,
                    Object data)

Push corresponding Expression to the stack.
conditional_factor ::= [ NOT ] conditional_test

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTBetweenExpression node,
                    Object data)

Push corresponding Expression to the stack.
between_expression ::= arithmetic_expression [ NOT ] BETWEEN arithmetic_expression AND arithmetic_expression

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTInExpression node,
                    Object data)

Push corresponding Expression to the stack.
in_expression ::= cmp_path_expression [ NOT ] IN {literal|input_parameter} [ , {literal|input_parameter} ] * )

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTLikeExpression node,
                    Object data)

Push corresponding Expression to the stack.
like_expression ::= cmp_path_expression [ NOT ] LIKE pattern_value [ ESCAPE escape_character ]

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTNullComparisonExpression node,
                    Object data)

Push corresponding Expression to the stack.
null_comparison_expression ::= {single_valued_path_expression|input_parameter} IS [ NOT ] NULL

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTEmptyCollectionComparisonExpression node,
                    Object data)

Nothing to do: Already taken into account in EjbqlVariableVisitor at the variables parsing, so, just push the OP_IGNORE in the stack empty_collection_comparison_expression ::= collection_valued_path_expression IS [ NOT ] EMPTY

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTCollectionMemberExpression node,
                    Object data)

Push corresponding Expression to the stack.
collection_member_expression ::= {single_valued_cmr_path_expression | identification_variable | input_parameter} [ NOT ] MEMBER [ OF ] collection_valued_path_expression

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTComparisonExpression node,
                    Object data)

Push corresponding Expression to the stack.
comparison_expression ::= string_value { = | > | >= | < | <= | <> } string_expression | boolean_value { = | <>} boolean_expression | datetime_value { = | > | >= | < | <= | <> } datetime_expression | entity_bean_value { = | <> } entity_bean_expression | arithmetic_value { = | > | >= | < | <= | <> } single_value_designator

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTArithmeticExpression node,
                    Object data)

Push corresponding Expression to the stack.
arithmetic_expression ::= arithmetic_term [ { + | - } arithmetic_term ] *

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTArithmeticTerm node,
                    Object data)

Push corresponding Expression to the stack.
arithmetic_term ::= arithmetic_factor [ { * | / } arithmetic_factor ]*

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTArithmeticFactor node,
                    Object data)

Push corresponding Expression to the stack.
arithmetic_factor ::= [ + |- ] arithmetic_primary

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTStringExpression node,
                    Object data)

Visit child nodes string_expression ::= string_primary | input_parameter

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTDatetimeExpression node,
                    Object data)

Visit child nodes datetime_expression ::= datetime_value | input_parameter

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTBooleanExpression node,
                    Object data)

Visit child nodes boolean_expression ::= cmp_path_expression | boolean_literal | input_parameter

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTEntityBeanExpression node,
                    Object data)

Visit child nodes entity_bean_expression ::= entity_bean_value | input_parameter

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTFunctionsReturningStrings node,
                    Object data)

visit child nodes Push corresponding Expression to the stack.
functions_returning_strings ::= CONCAT (string_expression, string_expression) | SUBSTRING (string_expression,arithmetic_expression,arithmetic_expression)

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTFunctionsReturningNumerics node,
                    Object data)

visit child nodes Push corresponding Expression to the stack.
functions_returning_numerics ::= LENGTH (string_expression) | LOCATE (string_expression, string_expression [ , arithmetic_expression ] ) | ABS (arithmetic_expression) | SQRT (arithmetic_expression) | MOD (arithmetic_expression , arithmetic_expression)

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTIdentificationVariable node,
                    Object data)

Node with value set to identification variable string. Push the Node to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTLiteral node,
                    Object data)

Visit child nodes literal ::= string_literal | arithmetic_literal | boolean_literal

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTStringLiteral node,
                    Object data)

Node with value set to litteral string. Push the corresponding Operand to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTArithmeticLiteral node,
                    Object data)

Visit child nodes arithmetic_literal ::= integer_literal | floatingpoint_literal

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTIntegerLiteral node,
                    Object data)

Node with value set to integer litteral arithmetic. Push the corresponding Operand to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTFloatingPointLiteral node,
                    Object data)

Node with value set to integer litteral arithmetic. Push the corresponding Operand to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTBooleanLiteral node,
                    Object data)

Node with value set to litteral boolean. Push the corresponding Operand to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTInputParameter node,
                    Object data)

Node with value set to parameter index (1..n) string. Push the corresponding Operand to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null

visit

public Object visit(ASTPath node,
                    Object data)

Push the Node to the stack

Specified by:

visit in interface EJBQLVisitor

Overrides:

visit in class EjbqlAbstractVisitor

Parameters:

node - the node to visit

data - the current stack

Returns:

null