Class CollectionMemberExpression
java.lang.Object
org.eclipse.persistence.jpa.jpql.parser.AbstractExpression
org.eclipse.persistence.jpa.jpql.parser.CollectionMemberExpression
- All Implemented Interfaces:
Expression
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.5
-
Field Summary
Fields inherited from class org.eclipse.persistence.jpa.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.jpql.parser.Expression
ABS, ALL, AND, ANY, AS, AS_OF, ASC, AVG, BETWEEN, BIT_LENGTH, BOTH, CASE, CAST, CEILING, CHAR_LENGTH, CHARACTER_LENGTH, CLASS, COALESCE, COLUMN, CONCAT, CONNECT_BY, COUNT, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, DATE, DATETIME, DELETE, DELETE_FROM, DESC, DIFFERENT, DISTINCT, DIVISION, ELSE, EMPTY, END, ENTRY, EQUAL, ESCAPE, EXCEPT, EXISTS, EXP, EXTRACT, FALSE, FETCH, FIRST, FLOOR, FROM, FUNC, FUNCTION, GREATER_THAN, GREATER_THAN_OR_EQUAL, GROUP_BY, HAVING, IN, INDEX, INNER, INNER_JOIN, INNER_JOIN_FETCH, INTERSECT, IS, IS_EMPTY, IS_NOT_EMPTY, IS_NOT_NULL, IS_NULL, JOIN, JOIN_FETCH, KEY, LAST, LEADING, LEFT, LEFT_JOIN, LEFT_JOIN_FETCH, LEFT_OUTER_JOIN, LEFT_OUTER_JOIN_FETCH, LENGTH, LIKE, LN, LOCAL, LOCATE, LOWER, LOWER_THAN, LOWER_THAN_OR_EQUAL, MAX, MEMBER, MEMBER_OF, MIN, MINUS, MOD, MULTIPLICATION, NAMED_PARAMETER, NEW, NOT, NOT_BETWEEN, NOT_EQUAL, NOT_EXISTS, NOT_IN, NOT_LIKE, NOT_MEMBER, NOT_MEMBER_OF, NULL, NULLIF, NULLS, NULLS_FIRST, NULLS_LAST, OBJECT, OF, ON, OPERATOR, OR, ORDER_BY, ORDER_SIBLINGS_BY, OUTER, PLUS, POSITION, POSITIONAL_PARAMETER, POWER, QUOTE, REGEXP, ROUND, SCN, SELECT, SET, SIGN, SIZE, SOME, SQL, SQRT, START_WITH, SUBSTRING, SUM, TABLE, THEN, TIME, TIMESTAMP, TRAILING, TREAT, TRIM, TRUE, TYPE, UNION, UNKNOWN, UPDATE, UPPER, VALUE, WHEN, WHERE
-
Constructor Summary
ConstructorDescriptionCollectionMemberExpression
(AbstractExpression parent, AbstractExpression expression) Creates a newCollectionMemberExpression
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
accept
(ExpressionVisitor visitor) Visits thisExpression
by the givenvisitor
.void
acceptChildren
(ExpressionVisitor visitor) Visits the children of thisExpression
.protected void
addChildrenTo
(Collection<Expression> children) Adds the children of thisAbstractExpression
to the given collection.protected void
addOrderedChildrenTo
(List<Expression> children) Adds the children of thisAbstractExpression
to the given list.findQueryBNF
(Expression expression) Retrieves theJPQLQueryBNF
that represents the fragment of thisExpression
that was used when parsing the givenExpression
.Returns the actual MEMBER identifier found in the string representation of the JPQL query, which has the actual case that was used.Returns the actual NOT identifier found in the string representation of the JPQL query, which has the actual case that was used.Returns the actual OF identifier found in the string representation of the JPQL query, which has the actual case that was used.Returns theExpression
representing the collection-valued path expression.Returns theExpression
representing the entity expression.Returns the identifier for this expression that may include NOT and OF if it was parsed.Returns the BNF of thisExpression
.boolean
Determines whether the collection-valued path expression was parsed.boolean
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
Determines whether a whitespace was found after MEMBER.boolean
Determines whether a whitespace was found after OF.protected void
parse
(WordParser wordParser, boolean tolerant) Parses the query by starting at the current position, which is part of the givenWordParser
.protected void
toParsedText
(StringBuilder writer, boolean actual) Generates a string representation of thisExpression
, including its children, if it has any.Methods inherited from class org.eclipse.persistence.jpa.jpql.parser.AbstractExpression
acceptUnknownVisitor, acceptUnknownVisitor, buildExpressionFromFallingBack, buildNullExpression, buildStringExpression, buildStringExpression, buildUnknownExpression, calculatePosition, children, findFallBackExpressionFactory, getExpressionFactory, getExpressionRegistry, getGrammar, getIdentifierVersion, getJPAVersion, getLength, getOffset, getParent, getQueryBNF, getRoot, getText, handleAggregate, handleCollection, isAncestor, isIdentifier, isNull, isParsingComplete, isTolerant, isUnknown, isVirtual, orderedChildren, parse, parseUsingExpressionFactory, populatePosition, rebuildActualText, rebuildParsedText, setParent, setText, shouldParseWithFactoryFirst, shouldSkipLiteral, toActualText, toParsedText, toString
-
Constructor Details
-
CollectionMemberExpression
Creates a newCollectionMemberExpression
.- Parameters:
parent
- The parent of this expressionexpression
- The entity expression that was parsed before parsing this one
-
-
Method Details
-
accept
Description copied from interface:Expression
Visits thisExpression
by the givenvisitor
.- Parameters:
visitor
- TheExpressionVisitor
to visit this object
-
acceptChildren
Description copied from interface:Expression
Visits the children of thisExpression
. This method can be used to optimize traversing the children since a new list is not created every timeExpression.children()
is called.This does not traverse the
Expression
sub-hierarchy, use a subclass ofAbstractTraverseChildrenVisitor
in order to traverse the entire sub-hierarchy.- Parameters:
visitor
- Thevisitor
to visit the children of this object.
-
addChildrenTo
Description copied from class:AbstractExpression
Adds the children of thisAbstractExpression
to the given collection.- Overrides:
addChildrenTo
in classAbstractExpression
- Parameters:
children
- The collection used to store the children
-
addOrderedChildrenTo
Description copied from class:AbstractExpression
Adds the children of thisAbstractExpression
to the given list.- Overrides:
addOrderedChildrenTo
in classAbstractExpression
- Parameters:
children
- The list used to store the string representation of thisAbstractExpression
-
findQueryBNF
Description copied from interface:Expression
Retrieves theJPQLQueryBNF
that represents the fragment of thisExpression
that was used when parsing the givenExpression
.- Specified by:
findQueryBNF
in interfaceExpression
- Overrides:
findQueryBNF
in classAbstractExpression
- Parameters:
expression
- TheExpression
that is a descendant of this one- Returns:
- The
JPQLQueryBNF
that was used to parse the given expression
-
getActualMemberIdentifier
Returns the actual MEMBER identifier found in the string representation of the JPQL query, which has the actual case that was used.- Returns:
- The MEMBER identifier that was actually parsed
-
getActualNotIdentifier
Returns the actual NOT identifier found in the string representation of the JPQL query, which has the actual case that was used.- Returns:
- The NOT identifier that was actually parsed, or an empty string if it was not parsed
-
getActualOfIdentifier
Returns the actual OF identifier found in the string representation of the JPQL query, which has the actual case that was used.- Returns:
- The OF identifier that was actually parsed, or an empty string if it was not parsed
-
getCollectionValuedPathExpression
Returns theExpression
representing the collection-valued path expression.- Returns:
- The expression that was parsed representing the collection valued path expression
-
getEntityExpression
Returns theExpression
representing the entity expression.- Returns:
- The expression that was parsed representing the entity expression
-
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
Description copied from interface:Expression
Returns the BNF of thisExpression
.- Returns:
- The
JPQLQueryBNF
, which represents the grammar of thisExpression
-
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
Description copied from class:AbstractExpression
Parses the query by starting at the current position, which is part of the givenWordParser
.- Specified by:
parse
in classAbstractExpression
- Parameters:
wordParser
- The text to parse based on the current position of the cursortolerant
- Determines whether the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries
-
toParsedText
Description copied from class:AbstractExpression
Generates a string representation of thisExpression
, including its children, if it has any.- Specified by:
toParsedText
in classAbstractExpression
- Parameters:
writer
- The buffer used to append thisExpression
's string representationactual
- Determines whether the string representation should represent what was parsed, i.e. include any "virtual" whitespace (such as ending whitespace) and the actual case of the JPQL identifiers
-