Oracle Fusion Middleware Java API Reference for Oracle TopLink
11g Release 1 (11.1.1)

E28847-01


org.eclipse.persistence.jpa.internal.jpql.parser
Class CollectionMemberExpression

java.lang.Object
  extended by org.eclipse.persistence.jpa.internal.jpql.parser.StringExpression
      extended by org.eclipse.persistence.jpa.internal.jpql.parser.AbstractExpression
          extended by org.eclipse.persistence.jpa.internal.jpql.parser.CollectionMemberExpression

All Implemented Interfaces:
Expression

public final class CollectionMemberExpression
extends AbstractExpression

This expression tests whether the designated value is a member of the collection specified by the collection-valued path expression. If the collection-valued path expression designates an empty collection, the value of the MEMBER OF expression is FALSE and the value of the NOT MEMBER OF expression is TRUE. Otherwise, if the value of the collection-valued path expression or single-valued association-field path expression in the collection member expression is NULL or unknown, the value of the collection member expression is unknown.

BNF: collection_member_expression ::= entity_or_value_expression [NOT] MEMBER [OF] collection_valued_path_expression
Since:
2.3
Version:
2.3
Author:
Pascal Filion

Field Summary
private  AbstractExpression collectionValuedPathExpression
          The Expression representing the collection-valued path expression.
private  AbstractExpression entityExpression
          The Expression representing the entity expression.
private  boolean hasNot
          Determines whether the identifier NOT was parsed.
private  boolean hasOf
          Determines whether the identifier OF was parsed.
private  boolean hasSpaceAfterMember
          Determines whether a whitespace was parsed after MEMBER.
private  boolean hasSpaceAfterOf
          Determines whether a whitespace was parsed after OF.
 
Fields inherited from class org.eclipse.persistence.jpa.internal.jpql.parser.AbstractExpression
COMMA, DOT, DOUBLE_QUOTE, LEFT_CURLY_BRACKET, LEFT_PARENTHESIS, NOT_DEFINED, RIGHT_CURLY_BRACKET, RIGHT_PARENTHESIS, SINGLE_QUOTE, SPACE, UNDERSCORE
 
Fields inherited from interface org.eclipse.persistence.jpa.internal.jpql.parser.Expression
ABS, ALL, AND, ANY, AS, ASC, AVG, BETWEEN, BIT_LENGTH, BOTH, CASE, CHAR_LENGTH, CHARACTER_LENGTH, CLASS, COALESCE, CONCAT, COUNT, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, DELETE, DELETE_FROM, DESC, DIFFERENT, DISTINCT, DIVISION, ELSE, EMPTY, END, ENTRY, EQUAL, ESCAPE, EXISTS, FALSE, FETCH, FROM, FUNC, GREATER_THAN, GREATER_THAN_OR_EQUAL, GROUP_BY, HAVING, IN, INDEX, INNER, INNER_JOIN, INNER_JOIN_FETCH, IS, IS_EMPTY, IS_NOT_EMPTY, IS_NOT_NULL, IS_NULL, JOIN, JOIN_FETCH, KEY, LEADING, LEFT, LEFT_JOIN, LEFT_JOIN_FETCH, LEFT_OUTER_JOIN, LEFT_OUTER_JOIN_FETCH, LENGTH, LIKE, LOCATE, LOWER, LOWER_THAN, LOWER_THAN_OR_EQUAL, MAX, MEMBER, MEMBER_OF, MIN, MINUS, MOD, MULTIPLICATION, NAMED_PARAMETER, NEW, NOT, NOT_BETWEEN, NOT_EXISTS, NOT_IN, NOT_LIKE, NOT_MEMBER, NOT_MEMBER_OF, NULL, NULLIF, OBJECT, OF, OR, ORDER_BY, OUTER, PLUS, POSITION, POSITIONAL_PARAMETER, QUOTE, SELECT, SET, SIZE, SOME, SQRT, SUBSTRING, SUM, THEN, TRAILING, TREAT, TRIM, TRUE, TYPE, UNKNOWN, UPDATE, UPPER, VALUE, WHEN, WHERE
 
Constructor Summary
CollectionMemberExpression(AbstractExpression parent, AbstractExpression expression)
          Creates a new CollectionMemberExpression.
 
Method Summary
 void accept(ExpressionVisitor visitor)
          Visits this Expression by the given visitor.
 void acceptChildren(ExpressionVisitor visitor)
          Visits the children of this Expression.
(package private)  void addChildrenTo(java.util.Collection<Expression> children)
          Adds the children of this Expression to the given collection.
(package private)  void addOrderedChildrenTo(java.util.List<StringExpression> children)
          Adds the StringExpressions representing this Expression.
 Expression getCollectionValuedPathExpression()
          Returns the Expression representing the collection-valued path expression.
 Expression getEntityExpression()
          Returns the Expression representing the entity expression.
 java.lang.String getIdentifier()
          Returns the identifier for this expression that may include NOT and OF if it was parsed.
 JPQLQueryBNF getQueryBNF()
          Returns the BNF of this Expression.
 boolean hasCollectionValuedPathExpression()
          Determines whether the collection-valued path expression was parsed.
 boolean hasEntityExpression()
          Determines whether the entity expression was parsed.
 boolean hasNot()
          Determines whether the identifier NOT was parsed.
 boolean hasOf()
          Determines whether the identifier OF was parsed.
 boolean hasSpaceAfterMember()
          Determines whether a whitespace was found after MEMBER.
 boolean hasSpaceAfterOf()
          Determines whether a whitespace was found after OF.
(package private)  void parse(WordParser wordParser, boolean tolerant)
          Parses the query by starting at the current position, which is part of the given WordParser.
(package private)  void toParsedText(java.lang.StringBuilder writer, boolean includeVirtual)
          Generates a string representation of this Expression.
 
Methods inherited from class org.eclipse.persistence.jpa.internal.jpql.parser.AbstractExpression
buildExpressionFromFallingBack, buildNullExpression, buildStringExpression, buildStringExpression, buildUnknownExpression, children, expressionFactory, expressionFactoryForIdentifier, findQueryBNF, getChildren, getJPAVersion, getParent, getRoot, getText, handleAggregate, identifierRole, identifiers, identifiers, identifierVersion, isAncestor, isIdentifier, isNull, isParsingComplete, isTolerant, isUnknown, isVirtual, orderedChildren, parse, parseSingleExpression, populatePosition, queryBNF, readdLeadingSpaces, rebuildActualText, rebuildParsedText, setParent, setText, shouldParseWithFactoryFirst, shouldSkipLiteral, toActualText, toParsedText, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

collectionValuedPathExpression

private AbstractExpression collectionValuedPathExpression
The Expression representing the collection-valued path expression.

entityExpression

private AbstractExpression entityExpression
The Expression representing the entity expression.

hasNot

private boolean hasNot
Determines whether the identifier NOT was parsed.

hasOf

private boolean hasOf
Determines whether the identifier OF was parsed.

hasSpaceAfterMember

private boolean hasSpaceAfterMember
Determines whether a whitespace was parsed after MEMBER.

hasSpaceAfterOf

private boolean hasSpaceAfterOf
Determines whether a whitespace was parsed after OF.
Constructor Detail

CollectionMemberExpression

CollectionMemberExpression(AbstractExpression parent,
                           AbstractExpression expression)
Creates a new CollectionMemberExpression.
Parameters:
parent - The parent of this expression
expression - The entity expression that was parsed before parsing this one
Method Detail

accept

public void accept(ExpressionVisitor visitor)
Visits this Expression by the given visitor.
Parameters:
visitor - The visitor to visit this object

acceptChildren

public void acceptChildren(ExpressionVisitor visitor)
Visits the children of this Expression. This method can be used to optimize traversing the children since a new list is not created every time Expression.children() or Expression.getChildren() is called.

This does not traverse the Expression sub-hierarchy, use an subclass of AbstractTraverseChildrenVisitor in order to traverse the entire sub-hierarchy.

Parameters:
visitor - The visitor to visit the children of this object.

addChildrenTo

void addChildrenTo(java.util.Collection<Expression> children)
Adds the children of this Expression to the given collection.
Overrides:
addChildrenTo in class AbstractExpression
Parameters:
children - The collection used to store the children

addOrderedChildrenTo

void addOrderedChildrenTo(java.util.List<StringExpression> children)
Adds the StringExpressions representing this Expression.
Overrides:
addOrderedChildrenTo in class AbstractExpression
Parameters:
children - The list used to store the string representation of this Expression

getCollectionValuedPathExpression

public Expression getCollectionValuedPathExpression()
Returns the Expression representing the collection-valued path expression.
Returns:
The expression that was parsed representing the collection valued path expression

getEntityExpression

public Expression getEntityExpression()
Returns the Expression representing the entity expression.
Returns:
The expression that was parsed representing the entity expression

getIdentifier

public java.lang.String getIdentifier()
Returns the identifier for this expression that may include NOT and OF if it was parsed.
Returns:
Either MEMBER, NOT MEMBER, NOT MEMBER OF or MEMBER OF

getQueryBNF

public JPQLQueryBNF getQueryBNF()
Returns the BNF of this Expression.
Specified by:
getQueryBNF in class AbstractExpression
Returns:
The JPQLQueryBNF, which represents the grammar of this Expression

hasCollectionValuedPathExpression

public boolean hasCollectionValuedPathExpression()
Determines whether the collection-valued path expression was parsed.
Returns:
true if the collection-valued path expression was parsed; false otherwise

hasEntityExpression

public boolean hasEntityExpression()
Determines whether the entity expression was parsed.
Returns:
true if the entity expression was parsed; false otherwise

hasNot

public boolean hasNot()
Determines whether the identifier NOT was parsed.
Returns:
true if the identifier NOT was parsed; false otherwise

hasOf

public boolean hasOf()
Determines whether the identifier OF was parsed.
Returns:
true if the identifier OF was parsed; false otherwise

hasSpaceAfterMember

public boolean hasSpaceAfterMember()
Determines whether a whitespace was found after MEMBER.
Returns:
true if there was a whitespace after MEMBER; false otherwise

hasSpaceAfterOf

public boolean hasSpaceAfterOf()
Determines whether a whitespace was found after OF.
Returns:
true if there was a whitespace after OF; false otherwise

parse

void parse(WordParser wordParser,
           boolean tolerant)
Parses the query by starting at the current position, which is part of the given WordParser.
Specified by:
parse in class AbstractExpression
Parameters:
wordParser - The text to parse based on the current position of the cursor
tolerant - Determines whether the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries

toParsedText

void toParsedText(java.lang.StringBuilder writer,
                  boolean includeVirtual)
Generates a string representation of this Expression.
Specified by:
toParsedText in class AbstractExpression
Parameters:
writer - The buffer used to append this Expression's string representation
includeVirtual - Determines whether to include any characters that are considered virtual, i.e. that was parsed when the query is incomplete and is needed for functionality like content assist

Copyright © 1998, 2012, Oracle. All Rights Reserved.