Package org.eclipse.persistence.jpa.jpql.tools.model.query
package org.eclipse.persistence.jpa.jpql.tools.model.query
This package contains the
StateObject
classes that represents a JPQL query.-
ClassDescriptionThe
ABS
function removes the minus sign from a specified argument and returns the absolute value, which is always a positive number or zero.Conditional expressions are composed of other conditional expressions, comparison operations, logical operations, path expressions that evaluate to boolean values, boolean literals, and boolean input parameters.ThisStateObject
represents a JPQL expression that has a JPQL identifier followed by two an encapsulated expression with parenthesis, the two expression are separated by a comma.The abstract definition ofEclipseLinkStateObjectVisitor
, which implements all the methods but does nothing.ThisStateObjectVisitor
traverses the entire hierarchy of the JPQL parsed tree by going down into each of the children of any givenStateObject
.ThisStateObjectVisitor
traverses up the hierarchy.This expression handles parsing the identifier followed by an expression encapsulated within parenthesis.This state object represents the abstract definition of aFROM
clause, which is either theFROM
clause of the query or of a sub-query expression.AbstractListHolderStateObject<T extends StateObject>The abstraction definition of aStateObject
that holds onto a list of children, the methods defined inListHolderStateObject
are automatically handled here.The abstract definition of a modify statement.An identification variable followed by the navigation operator (.) and a state field or association field is a path expression.An abstract schema name designates the abstract schema type over which the query ranges.This state object represents the abstract definition of aSELECT
clause, which is either theSELECT
clause of the top-level query or of a subquery.This state object represents the select statement, which has at least aSELECT
clause and aFROM
clause.ThisStateObject
represents a JPQL expression that has a JPQL identifier followed by an encapsulated expression with parenthesis.The abstract definition of aStateObject
.The abstract definition ofStateObjectVisitor
, which implements all the methods but does nothing.ThisStateObjectVisitor
traverses the entire hierarchy of the JPQL parsed tree by going down into each of the children of any givenStateObject
.ThisStateObjectVisitor
traverses up the hierarchy.This state object takes care of parsing an expression that encapsulates three expressions separated by a comma.TODO:In theSELECT
clause the result of a query may be the result of an aggregate function applied to a path expression.AnALL
conditional expression is a predicate that istrue
if the comparison operation istrue
for all values in the result of the subquery or the result of the subquery is empty.TheAND
logical operator chains multiple criteria together.This visitor allows a subclass to simply overrideAnonymousStateObjectVisitor.visit(StateObject)
and perform the same task for all visitedItateObjects
.This visitor allows a subclass to simply overrideAnonymousStateObjectVisitor.visit(StateObject)
and perform the same task for all visitedItateObjects
.This expression represents an arithmetic expression, which means the first and second expressions are aggregated with an arithmetic sign.This state object simply adds a plus or minus sign to the arithmetic primary expression.One of the aggregate functions.This wraps an invalid portion of the JPQL query that could not be parsed.Used in conditional expression to determine whether the result of an expression falls within an inclusive range of values.ACASE
predicate is used to calculate a condition and when it'strue
, itsTHEN
expression will be executed.ThisChangeSupport
is responsible to notifies registered listeners upon changes made to aStateObject
, those changes are either a property has changed (IPropertyChangeListener
) or the content of a list has changed (IListChangeListener
).ACOALESCE
expression returnsnull
if all its arguments evaluate tonull
, and the value of the first non-null
argument otherwise.ThisStateObject
is a temporary object used to store a list ofStateObjects
.An identification variable declared by acollection_member_declaration
ranges over values of a collection obtained by navigation using a path expression.This expression tests whether the designated value is a member of the collection specified by the collection-valued path expression.A collection-valued field is designated by the name of an association field in a one-to-many or a many-to-many relationship or by the name of an element collection field.Only the values of like types are permitted to be compared.A compoundStateObject
has a left and right expressions combined by an identifier.TheCONCAT
function returns a string that is a concatenation of its arguments.In theSELECT
clause a constructor may be used in theSELECT
list to return one or more Java instances.One of the aggregate functions.ThisDateTimeStateObject
represents a date or time.This defines the declaration portion of a query, which is theFROM
clause of a query.This is theDELETE
clause of theDELETE
statement.Bulk delete operation apply to entities of a single entity class (together with its subclasses, if any).TODO:The interface is used to traverse theStateObject
hierarchy that represents a JPQL query as well as what EclipseLink adds on top of the basic grammar.This expression tests whether or not the collection designated by the collection-valued path expression is empty (i.e, has no elements).This object represents an identification variable that is wrapped by a function.ThisStateObject
wraps the name of an entity type.ThisStateObject
wraps the name of anEnum
constant.AnEXISTS
expression is a predicate that istrue
only if the result of the subquery consists of one or more values and that isfalse
otherwise.TheFROM
clause of a query defines the domain of the query by declaring identification variables.TheGROUP BY
construct enables the aggregation of values according to the properties of an entity class.TheHAVING
construct enables conditions to be specified that further restrict the query result as restrictions upon the groups.An identification variable is a valid identifier declared in theFROM
clause of a query.This state object represents a single identification variable, which is identifying TODO.TheINDEX
function returns an integer value corresponding to the position of its argument in an ordered list.The state field path expression must have a string, numeric, or enum value.Either positional or named parameters may be used.AJOIN
enables the fetching of an association as a side effect of the execution of a query.This is the root of theStateObject
hierarchy that represents a JPQL query.This object represents an identification variable that maps the keys of aMap
.The expression representing some keywords:TRUE
,FALSE
orNULL
.TheLENGTH
function returns the length of the string in characters as an integer.TheLIKE
condition is used to specify a search for a pattern.AListHolderStateObject
is aStateObject
having a list of children and this gives access to some operation over the list.TheLOCATE
function returns the position of a given string within a string, starting the search at a specified position.This expression represents a logical expression, which means the first and second expressions are aggregated with either theAND
or theOR
operator.TheLOWER
function converts a string to lower case and it returns a string.One of the aggregate functions.One of the aggregate functions.The modulo operation finds the remainder of division of one number by another.TODO:A null comparison tests whether or not the single-valued path expression or input parameter is aNULL
value.NULLIF
returns the first expression if the two expressions are not equal.Exact numeric literals support the use of Java integer literal syntax as well as SQL exact numeric literal syntax.Stand-alone identification variables in theSELECT
clause may optionally be qualified by theOBJECT
operator.TheORDER BY
clause allows the objects or values that are returned by the query to be ordered.AnORDER BY
item must be one of the following: Astate_field_path_expression
that evaluates to an orderable state field of an entity or embeddable class abstract schema type designated in theSELECT
clause by one of the following: A general_identification_variable A single_valued_object_path_expression Astate_field_path_expression
that evaluates to the same state field of the same entity or embeddable abstract schema type as astate_field_path_expression
in the SELECT clause Aresult_variable
that refers to an orderable item in theSELECT
clause for which the sameresult_variable
has been specified.TheOR
logical operator chains multiple criteria together.Range variable declarations allow the developer to designate a "root" for objects which may not be reachable by navigation.A result variable may be used to name a select item in the query result.TheSELECT
statement queries data from entities, which determines the type of the objects or values to be selected.This state object represents a select statement, which has at least aSELECT
clause and aFROM
clause.TheFROM
clause of a sub-query defines the domain of the sub-query by declaring identification variables.The SELECT statement queries data from entities.This state object represents a subquery, which has at least aSELECT
clause and aFROM
clause.ThisStateObject
simply holds onto a string.TheSIZE
function returns an integer value, the number of elements of the collection.TheSQRT
function takes a numeric argument and returns aDouble
.A single-valued association field is designated by the name of an association-field in a one-to-one or many-to-one relationship.AStateObject
is an editable representation of a JPQL query.The visitor is used to traverse theStateObject
hierarchy that represents a JPQL query.A string literal is enclosed in single quotes.This expression wraps a sub-expression within parenthesis.The second and third arguments of theSUBSTRING
function denote the starting position and length of the substring to be returned.TODO:One of the aggregate functions.Returns an expression that allows to treat its base as if it were a subclass of the class returned by the base.TheTRIM
function trims the specified character from a string.An entity type expression can be used to restrict query polymorphism.ThisStateObject
holds onto an unknown portion of a JPQL query that could not be parsed.This is theUPDATE
clause of theUPDATE
statement.Thenew_value
specified for an update operation must be compatible in type with the field to which it is assigned.TheUPDATE
clause of a query consists of a conditional expression used to select objects or values that satisfy the expression.TheUPPER
function converts a string to upper case and it returns a string.This object represents an identification variable that maps the values of aMap
.This defines a variable declaration, which has a "root" object and an identification variable.AWHEN
predicate is used to calculate a condition and when it's true, itsTHEN
will be executed.TheWHERE
clause of a query consists of a conditional expression used to select objects or values that satisfy the expression.