public final class CaseExpression extends AbstractExpression
general_case_expression ::= CASE when_clause {when_clause}* ELSE scalar_expression END
or
simple_case_expression ::= CASE case_operand simple_when_clause {simple_when_clause}* ELSE scalar_expression END
COMMA, DOT, DOUBLE_QUOTE, LEFT_CURLY_BRACKET, LEFT_PARENTHESIS, NOT_DEFINED, RIGHT_CURLY_BRACKET, RIGHT_PARENTHESIS, SINGLE_QUOTE, SPACE, UNDERSCORE
ABS, ALL, AND, ANY, AS, AS_OF, ASC, AVG, BETWEEN, BIT_LENGTH, BOTH, CASE, CAST, CHAR_LENGTH, CHARACTER_LENGTH, CLASS, COALESCE, COLUMN, CONCAT, CONNECT_BY, COUNT, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, DELETE, DELETE_FROM, DESC, DIFFERENT, DISTINCT, DIVISION, ELSE, EMPTY, END, ENTRY, EQUAL, ESCAPE, EXCEPT, EXISTS, EXTRACT, FALSE, FETCH, FIRST, 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, 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, QUOTE, REGEXP, SCN, SELECT, SET, SIZE, SOME, SQL, SQRT, START_WITH, SUBSTRING, SUM, TABLE, THEN, TIMESTAMP, TRAILING, TREAT, TRIM, TRUE, TYPE, UNION, UNKNOWN, UPDATE, UPPER, VALUE, WHEN, WHERE
Constructor and Description |
---|
CaseExpression(AbstractExpression parent)
Creates a new
CaseExpression . |
Modifier and Type | Method and Description |
---|---|
void |
accept(ExpressionVisitor visitor)
Visits this
Expression by the given visitor . |
void |
acceptChildren(ExpressionVisitor visitor)
Visits the children of this
Expression . |
protected void |
addChildrenTo(java.util.Collection<Expression> children)
Adds the children of this
AbstractExpression to the given collection. |
protected void |
addOrderedChildrenTo(java.util.List<Expression> children)
Adds the children of this
AbstractExpression to the given list. |
JPQLQueryBNF |
findQueryBNF(Expression expression)
Retrieves the
JPQLQueryBNF that represents the fragment of this Expression
that was used when parsing the given Expression . |
java.lang.String |
getActualCaseIdentifier()
Returns the actual CASE identifier found in the string representation of the JPQL
query, which has the actual case that was used.
|
java.lang.String |
getActualElseIdentifier()
Returns the actual ELSE identifier found in the string representation of the JPQL
query, which has the actual case that was used.
|
java.lang.String |
getActualEndIdentifier()
Returns the actual END identifier found in the string representation of the JPQL query,
which has the actual case that was used.
|
Expression |
getCaseOperand()
Returns the
Expression that represents the CASE operand. |
AbstractExpression |
getElseExpression()
Returns the
Expression that represents the ELSE operand. |
JPQLQueryBNF |
getQueryBNF()
Returns the BNF of this
Expression . |
AbstractExpression |
getWhenClauses()
Returns the
Expression that represents the WHEN clauses. |
boolean |
hasCaseOperand()
Determines whether the CASE operand was parsed.
|
boolean |
hasElse()
Determines whether the identifier ELSE was parsed.
|
boolean |
hasElseExpression()
Determines whether the ELSE expression was parsed.
|
boolean |
hasEnd()
Determines whether the identifier END was parsed.
|
boolean |
hasSpaceAfterCase()
Determines whether a whitespace was parsed after CASE.
|
boolean |
hasSpaceAfterCaseOperand()
Determines whether a whitespace was parsed after the case operand.
|
boolean |
hasSpaceAfterElse()
Determines whether a whitespace was parsed after ELSE.
|
boolean |
hasSpaceAfterElseExpression()
Determines whether a whitespace was parsed after the else expression.
|
boolean |
hasSpaceAfterWhenClauses()
Determines whether a whitespace was parsed after the WHEN clause.
|
boolean |
hasWhenClauses()
Determines whether the WHEN clauses were parsed.
|
protected boolean |
isParsingComplete(WordParser wordParser,
java.lang.String word,
Expression expression)
Determines whether the parsing is complete based on what is left in the given text.
|
protected void |
parse(WordParser wordParser,
boolean tolerant)
Parses the query by starting at the current position, which is part of the given
WordParser . |
protected void |
toParsedText(java.lang.StringBuilder writer,
boolean actual)
Generates a string representation of this
Expression , including its children,
if it has any. |
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, isTolerant, isUnknown, isVirtual, orderedChildren, parse, parseUsingExpressionFactory, populatePosition, rebuildActualText, rebuildParsedText, setParent, setText, shouldParseWithFactoryFirst, shouldSkipLiteral, toActualText, toParsedText, toString
public CaseExpression(AbstractExpression parent)
CaseExpression
.parent
- The parent of this expressionpublic void accept(ExpressionVisitor visitor)
Expression
by the given visitor
.visitor
- The ExpressionVisitor
to visit this objectpublic void acceptChildren(ExpressionVisitor visitor)
Expression
. This method can be used to optimize traversing
the children since a new list is not created every time Expression.children()
is called.
This does not traverse the Expression
sub-hierarchy, use a subclass of
AbstractTraverseChildrenVisitor
in order to traverse the entire sub-hierarchy.
visitor
- The visitor
to visit the children of this object.protected void addChildrenTo(java.util.Collection<Expression> children)
AbstractExpression
to the given collection.addChildrenTo
in class AbstractExpression
children
- The collection used to store the childrenprotected void addOrderedChildrenTo(java.util.List<Expression> children)
AbstractExpression
to the given list.addOrderedChildrenTo
in class AbstractExpression
children
- The list used to store the string representation of this AbstractExpression
public JPQLQueryBNF findQueryBNF(Expression expression)
JPQLQueryBNF
that represents the fragment of this Expression
that was used when parsing the given Expression
.findQueryBNF
in interface Expression
findQueryBNF
in class AbstractExpression
expression
- The Expression
that is a descendant of this oneJPQLQueryBNF
that was used to parse the given expressionpublic java.lang.String getActualCaseIdentifier()
public java.lang.String getActualElseIdentifier()
public java.lang.String getActualEndIdentifier()
public Expression getCaseOperand()
Expression
that represents the CASE operand.public AbstractExpression getElseExpression()
Expression
that represents the ELSE operand.public JPQLQueryBNF getQueryBNF()
Expression
.JPQLQueryBNF
, which represents the grammar of this Expression
public AbstractExpression getWhenClauses()
Expression
that represents the WHEN clauses.public boolean hasCaseOperand()
true
if the CASE operand was parsed; false
otherwisepublic boolean hasElse()
true
if the identifier ELSE was parsed; false
otherwisepublic boolean hasElseExpression()
true
if the ELSE expression was parsed; false
otherwisepublic boolean hasEnd()
true
if the identifier END was parsed; false
otherwisepublic boolean hasSpaceAfterCase()
true
if there was a whitespace after CASE; false
otherwisepublic boolean hasSpaceAfterCaseOperand()
true
if there was a whitespace after the case operand; false
otherwisepublic boolean hasSpaceAfterElse()
true
if there was a whitespace after ELSE; false
otherwisepublic boolean hasSpaceAfterElseExpression()
true
if there was a whitespace after the else expression;
false
otherwisepublic boolean hasSpaceAfterWhenClauses()
true
if there was a whitespace after false
otherwisepublic boolean hasWhenClauses()
true
if the WHEN clauses were parsed;
false
otherwiseprotected boolean isParsingComplete(WordParser wordParser, java.lang.String word, Expression expression)
isParsingComplete
in class AbstractExpression
wordParser
- The text to parse based on the current position of the cursorword
- The word that was retrieved from the given text, which is the first word in the textexpression
- The Expression
that has already been parsedtrue
if the text no longer can't be parsed by the current expression;
false
if more can be parsedprotected void parse(WordParser wordParser, boolean tolerant)
WordParser
.parse
in class AbstractExpression
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 queriesprotected void toParsedText(java.lang.StringBuilder writer, boolean actual)
Expression
, including its children,
if it has any.toParsedText
in class AbstractExpression
writer
- The buffer used to append this Expression
'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