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
ABSfunction 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.ThisStateObjectrepresents 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.ThisStateObjectVisitortraverses the entire hierarchy of the JPQL parsed tree by going down into each of the children of any givenStateObject.ThisStateObjectVisitortraverses up the hierarchy.This expression handles parsing the identifier followed by an expression encapsulated within parenthesis.This state object represents the abstract definition of aFROMclause, which is either theFROMclause of the query or of a sub-query expression.AbstractListHolderStateObject<T extends StateObject>The abstraction definition of aStateObjectthat holds onto a list of children, the methods defined inListHolderStateObjectare 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 aSELECTclause, which is either theSELECTclause of the top-level query or of a subquery.This state object represents the select statement, which has at least aSELECTclause and aFROMclause.ThisStateObjectrepresents 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.ThisStateObjectVisitortraverses the entire hierarchy of the JPQL parsed tree by going down into each of the children of any givenStateObject.ThisStateObjectVisitortraverses up the hierarchy.This state object takes care of parsing an expression that encapsulates three expressions separated by a comma.TODO:In theSELECTclause the result of a query may be the result of an aggregate function applied to a path expression.AnALLconditional expression is a predicate that istrueif the comparison operation istruefor all values in the result of the subquery or the result of the subquery is empty.TheANDlogical 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.ACASEpredicate is used to calculate a condition and when it'strue, itsTHENexpression will be executed.ThisChangeSupportis 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).ACOALESCEexpression returnsnullif all its arguments evaluate tonull, and the value of the first non-nullargument otherwise.ThisStateObjectis a temporary object used to store a list ofStateObjects.An identification variable declared by acollection_member_declarationranges 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 compoundStateObjecthas a left and right expressions combined by an identifier.TheCONCATfunction returns a string that is a concatenation of its arguments.In theSELECTclause a constructor may be used in theSELECTlist to return one or more Java instances.One of the aggregate functions.ThisDateTimeStateObjectrepresents a date or time.This defines the declaration portion of a query, which is theFROMclause of a query.This is theDELETEclause of theDELETEstatement.Bulk delete operation apply to entities of a single entity class (together with its subclasses, if any).TODO:The interface is used to traverse theStateObjecthierarchy 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.ThisStateObjectwraps the name of an entity type.ThisStateObjectwraps the name of anEnumconstant.AnEXISTSexpression is a predicate that istrueonly if the result of the subquery consists of one or more values and that isfalseotherwise.TheFROMclause of a query defines the domain of the query by declaring identification variables.TheGROUP BYconstruct enables the aggregation of values according to the properties of an entity class.TheHAVINGconstruct 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 theFROMclause of a query.This state object represents a single identification variable, which is identifying TODO.TheINDEXfunction 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.AJOINenables the fetching of an association as a side effect of the execution of a query.This is the root of theStateObjecthierarchy that represents a JPQL query.This object represents an identification variable that maps the keys of aMap.The expression representing some keywords:TRUE,FALSEorNULL.TheLENGTHfunction returns the length of the string in characters as an integer.TheLIKEcondition is used to specify a search for a pattern.AListHolderStateObjectis aStateObjecthaving a list of children and this gives access to some operation over the list.TheLOCATEfunction 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 theANDor theORoperator.TheLOWERfunction 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 aNULLvalue.NULLIFreturns 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 theSELECTclause may optionally be qualified by theOBJECToperator.TheORDER BYclause allows the objects or values that are returned by the query to be ordered.AnORDER BYitem must be one of the following: Astate_field_path_expressionthat evaluates to an orderable state field of an entity or embeddable class abstract schema type designated in theSELECTclause by one of the following: A general_identification_variable A single_valued_object_path_expression Astate_field_path_expressionthat evaluates to the same state field of the same entity or embeddable abstract schema type as astate_field_path_expressionin the SELECT clause Aresult_variablethat refers to an orderable item in theSELECTclause for which the sameresult_variablehas been specified.TheORlogical 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.TheSELECTstatement 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 aSELECTclause and aFROMclause.TheFROMclause 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 aSELECTclause and aFROMclause.ThisStateObjectsimply holds onto a string.TheSIZEfunction returns an integer value, the number of elements of the collection.TheSQRTfunction 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.AStateObjectis an editable representation of a JPQL query.The visitor is used to traverse theStateObjecthierarchy 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 theSUBSTRINGfunction 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.TheTRIMfunction trims the specified character from a string.An entity type expression can be used to restrict query polymorphism.ThisStateObjectholds onto an unknown portion of a JPQL query that could not be parsed.This is theUPDATEclause of theUPDATEstatement.Thenew_valuespecified for an update operation must be compatible in type with the field to which it is assigned.TheUPDATEclause of a query consists of a conditional expression used to select objects or values that satisfy the expression.TheUPPERfunction 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.AWHENpredicate is used to calculate a condition and when it's true, itsTHENwill be executed.TheWHEREclause of a query consists of a conditional expression used to select objects or values that satisfy the expression.