Class JPQLExpression
java.lang.Object
org.eclipse.persistence.jpa.jpql.parser.AbstractExpression
org.eclipse.persistence.jpa.jpql.parser.JPQLExpression
- All Implemented Interfaces:
Expression
A
JPQLExpression
is the root of the parsed tree representation of a JPQL query. The
query is parsed based on what was registered in the JPQLGrammar
's ExpressionRegistry
.
A JPQL statement may be either a SELECT statement, an UPDATE statement, or a DELETE FROM statement.
BNF:
QL_statement ::= select_statement
|
update_statement
|
delete_statement
It is possible to parse a portion of a JPQL query. The ID of the JPQLQueryBNF
is used to
parse that portion and getQueryStatement()
then returns only the parsed tree representation
of that JPQL fragment.
- 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
ConstructorDescriptionJPQLExpression
(CharSequence query, JPQLGrammar jpqlGrammar) Creates a newJPQLExpression
, which is the root of the JPQL parsed tree.JPQLExpression
(CharSequence query, JPQLGrammar jpqlGrammar, boolean tolerant) Creates a newJPQLExpression
, which is the root of the JPQL parsed tree.JPQLExpression
(CharSequence jpqlFragment, JPQLGrammar jpqlGrammar, String queryBNFId, boolean tolerant) Creates a newJPQLExpression
that will parse the given fragment of a JPQL query. -
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.buildPosition
(String actualQuery, int position) Creates a map of the position of the cursor within eachExpression
of the parsed tree.getExpression
(String actualQuery, int position) Returns the deepestExpression
for the given position.Returns theJPQLGrammar
that defines how the JPQL query was parsed.Returns the version of the Java Persistence to support.Returns the BNF of thisExpression
.Returns theExpression
representing the query, which is either a SELECT, a DELETE or an UPDATE clause.Returns theExpression
that may contain a portion of the query that could not be parsed, this happens when the query is either incomplete or malformed.boolean
Determines whether a query was parsed.boolean
Determines whether the query that got parsed had some malformed or unknown information.protected boolean
Determines if the parser is in tolerant mode or is in fast mode.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, findQueryBNF, getExpressionFactory, getExpressionRegistry, getIdentifierVersion, getLength, getOffset, getParent, getQueryBNF, getRoot, getText, handleAggregate, handleCollection, isAncestor, isIdentifier, isNull, isParsingComplete, isUnknown, isVirtual, orderedChildren, parse, parseUsingExpressionFactory, populatePosition, rebuildActualText, rebuildParsedText, setParent, setText, shouldParseWithFactoryFirst, shouldSkipLiteral, toActualText, toParsedText, toString
-
Constructor Details
-
JPQLExpression
Creates a newJPQLExpression
, which is the root of the JPQL parsed tree.- Parameters:
query
- The string representation of the JPQL query to parsejpqlGrammar
- The JPQL grammar that defines how to parse a JPQL query
-
JPQLExpression
Creates a newJPQLExpression
, which is the root of the JPQL parsed tree.- Parameters:
query
- The string representation of the JPQL query to parsejpqlGrammar
- The JPQL grammar that defines how to parse a JPQL querytolerant
- Determines if the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries
-
JPQLExpression
public JPQLExpression(CharSequence jpqlFragment, JPQLGrammar jpqlGrammar, String queryBNFId, boolean tolerant) Creates a newJPQLExpression
that will parse the given fragment of a JPQL query. This meansgetQueryStatement()
will not return a query statement (select, delete or update) but only the parsed tree representation of the fragment if the query BNF can pare it. If the fragment of the JPQL query could not be parsed using the givenJPQLQueryBNF
, thengetUnknownEndingStatement()
will contain the non-parsable fragment.- Parameters:
jpqlFragment
- A fragment of a JPQL query, which is a portion of a complete JPQL queryjpqlGrammar
- The JPQL grammar that defines how to parse a JPQL queryqueryBNFId
- The unique identifier of theJPQLQueryBNF
tolerant
- Determines if the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries- Since:
- 2.4
-
-
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
-
buildPosition
Creates a map of the position of the cursor within eachExpression
of the parsed tree.- Parameters:
actualQuery
- The actual query is a string representation of the query that may contain extra whitespaceposition
- The position of the cursor in the actual query, which is used to retrieve the deepestExpression
. The position will be adjusted to fit into the beautified version of the query- Returns:
- A new
QueryPosition
-
getExpression
Returns the deepestExpression
for the given position.- Parameters:
actualQuery
- The actual query is the text version of the query that may contain extra whitespace and different formatting than the trim down version generated by the parsed treeposition
- The position in the actual query used to retrieve theExpression
- Returns:
- The
Expression
located at the given position in the given query
-
getGrammar
Description copied from interface:Expression
Returns theJPQLGrammar
that defines how the JPQL query was parsed.- Specified by:
getGrammar
in interfaceExpression
- Overrides:
getGrammar
in classAbstractExpression
- Returns:
- The
JPQLGrammar
that was used to parse thisExpression
-
getJPAVersion
Description copied from class:AbstractExpression
Returns the version of the Java Persistence to support.- Overrides:
getJPAVersion
in classAbstractExpression
- Returns:
- The JPA version supported by the grammar
- See Also:
-
getQueryBNF
Description copied from interface:Expression
Returns the BNF of thisExpression
.- Returns:
- The
JPQLQueryBNF
, which represents the grammar of thisExpression
-
getQueryStatement
Returns theExpression
representing the query, which is either a SELECT, a DELETE or an UPDATE clause.- Returns:
- The expression representing the Java Persistence query
-
getUnknownEndingStatement
Returns theExpression
that may contain a portion of the query that could not be parsed, this happens when the query is either incomplete or malformed.- Returns:
- The expression used when the ending of the query is unknown or malformed
-
hasQueryStatement
public boolean hasQueryStatement()Determines whether a query was parsed. The query may be incomplete but it started with one of the three clauses (SELECT, DELETE FROM, or UPDATE).- Returns:
true
the query was parsed;false
otherwise
-
hasUnknownEndingStatement
public boolean hasUnknownEndingStatement()Determines whether the query that got parsed had some malformed or unknown information.- Returns:
true
if the query could not be parsed correctly because it is either incomplete or malformed
-
isTolerant
protected boolean isTolerant()Description copied from class:AbstractExpression
Determines if the parser is in tolerant mode or is in fast mode. When the tolerant is turned on, it means the parser will attempt to parse incomplete or invalid queries.- Overrides:
isTolerant
in classAbstractExpression
- Returns:
true
if the parsing system should parse invalid or incomplete queries;false
when the query is well-formed and valid
-
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
-