|
EclipseLink 2.4.2, build 'v20130514-5956486' API Reference | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.persistence.jpa.jpql.JPQLQueryContext
public abstract class JPQLQueryContext
This context is used to store information related to the JPQL query.
IQuery
externalQuery = ...;
JPQLQueryContext context = new JPQLQueryContext(DefaultJPQLGrammar.instance());
context.setQuery(query);
If the JPQL query is already parsed, then the context can use it and it needs to be set before
setting the IQuery
:
JPQLExpression
jpqlExpression = ...;
JPQLQueryContext context = new JPQLQueryContext(DefaultJPQLGrammar.instance());
context.setJPQLExpression(jpqlExpression);
context.setQuery(query);
Provisional API: This interface is part of an interim API that is still under development and expected to change significantly before reaching stability. It is available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.
Nested Class Summary | |
---|---|
protected class |
JPQLQueryContext.InputParameterVisitor
This visitor is responsible to find the InputParameters with a certain
parameter name. |
protected static class |
JPQLQueryContext.QueryExpressionVisitor
This visitor is responsible to retrieve the Expression that is the beginning of a
query. |
Field Summary | |
---|---|
protected JPQLQueryContext |
currentContext
The current JPQLQueryContext is the context used for the current query or subquery. |
protected JPQLQueryContext |
parent
When this context is a sub-context used for a subquery, then this is the context for the parent query. |
Constructor Summary | |
---|---|
|
JPQLQueryContext(JPQLGrammar jpqlGrammar)
Creates a new JPQLQueryContext . |
protected |
JPQLQueryContext(JPQLQueryContext parent,
Expression currentQuery)
Creates a new sub- JPQLQueryContext . |
Method Summary | |
---|---|
protected DeclarationResolver |
buildDeclarationResolver()
|
protected DeclarationResolver |
buildDeclarationResolver(DeclarationResolver parent)
|
protected JPQLQueryContext.InputParameterVisitor |
buildInputParameter()
|
protected abstract JPQLQueryContext |
buildJPQLQueryContext(JPQLQueryContext currentContext,
Expression currentQuery)
|
protected abstract LiteralVisitor |
buildLiteralVisitor()
|
protected ParameterTypeVisitor |
buildParameterTypeVisitor()
|
protected JPQLQueryContext.QueryExpressionVisitor |
buildQueryExpressionVisitor()
|
protected abstract ResolverBuilder |
buildResolverBuilder()
|
void |
convertUnqualifiedDeclaration(DeclarationResolver.Declaration declaration)
Converts the given DeclarationResolver.Declaration from being set as a range variable declaration to
a path expression declaration. |
void |
dispose()
Disposes the internal data. |
void |
disposeSubqueryContext()
Disposes this context, which is the current context being used by a subquery. |
java.util.Collection<InputParameter> |
findInputParameters(java.lang.String parameterName)
Retrieves all the InputParameters with the given parameter name. |
Expression |
getActualCurrentQuery()
Returns the current Expression being manipulated, which is either the top-level query
or a subquery. |
DeclarationResolver |
getActualDeclarationResolver()
Returns the DeclarationResolver of this context and not from the current query's
declaration. |
JPQLQueryContext |
getCurrentContext()
Returns the current JPQLQueryContext , i.e. the context of the query being manipulated,
which can either be the top-level query or a subquery. |
Expression |
getCurrentQuery()
Returns the current Expression being manipulated, which is either the top-level query
or a subquery. |
DeclarationResolver |
getDeclarationResolver()
Returns the DeclarationResolver of the current query's declaration. |
DeclarationResolver |
getDeclarationResolver(Expression expression)
Returns the DeclarationResolver of the current query's declaration. |
protected DeclarationResolver |
getDeclarationResolverImp()
Returns the DeclarationResolver of the current query's declaration. |
java.util.List<DeclarationResolver.Declaration> |
getDeclarations()
Returns the ordered list of Declarations . |
IType |
getEnumType(java.lang.String enumTypeName)
Returns the IType representing the possible given enum type. |
ExpressionRegistry |
getExpressionRegistry()
Returns the registry containing the JPQLQueryBNFs and the ExpressionFactories that are used to properly parse a JPQL query. |
JPQLGrammar |
getGrammar()
Returns the JPQL grammar that will be used to define how to parse a JPQL query. |
protected JPQLQueryContext.InputParameterVisitor |
getInputParameterVisitor()
|
java.util.Collection<Join> |
getJoins(java.lang.String variableName)
Returns the parsed representation of a JOIN and JOIN FETCH that were defined in the same declaration than the given range identification variable name. |
JPAVersion |
getJPAVersion()
Returns the version of the Java Persistence to support, which dictates which version of the JPQL grammar to support. |
JPQLExpression |
getJPQLExpression()
Returns the parsed tree representation of the JPQL query. |
java.lang.String |
getJPQLQuery()
Returns the string representation of the JPQL query. |
protected LiteralVisitor |
getLiteralVisitor()
|
IMapping |
getMapping(Expression expression)
Returns the IMapping for the field represented by the given Expression . |
IType |
getParameterType(InputParameter inputParameter)
Retrieves, if it can be determined, the type of the given InputParameter . |
protected ParameterTypeVisitor |
getParameterTypeVisitor()
|
JPQLQueryContext |
getParent()
Returns the parent context if the current context is not the root context. |
IManagedTypeProvider |
getProvider()
Retrieves the provider of managed types. |
IQuery |
getQuery()
Returns the external form of the JPQL query. |
Expression |
getQueryExpression(Expression expression)
Retrieves the Expression representing the query statement (either the top-level query
JPQLExpression or the subquery SimpleSelectStatement ) owning the given Expression . |
protected JPQLQueryContext.QueryExpressionVisitor |
getQueryExpressionVisitor()
|
Resolver |
getResolver(Expression expression)
Creates or retrieved the cached Resolver for the given Expression . |
Resolver |
getResolver(java.lang.String variableName)
Retrieves the Resolver mapped with the given identification variable. |
protected ResolverBuilder |
getResolverBuilder()
|
java.util.Set<java.lang.String> |
getResultVariables()
Returns the variables that got defined in the select expression. |
IType |
getType(java.lang.Class<?> type)
Retrieves the external type for the given Java type. |
IType |
getType(Expression expression)
Returns the IType of the given Expression . |
IType |
getType(java.lang.String typeName)
Retrieves the external class with the given fully qualified class name. |
ITypeDeclaration |
getTypeDeclaration(Expression expression)
Returns the ITypeDeclaration of the field handled by this Resolver . |
TypeHelper |
getTypeHelper()
Returns a helper that gives access to the most common types . |
ITypeRepository |
getTypeRepository()
Returns the type repository for the application. |
boolean |
hasJoins()
Determines whether the JPQL expression has JOIN expressions. |
protected void |
initialize(JPQLGrammar jpqlGrammar)
Initializes this JPQLQueryContext . |
protected void |
initializeRoot()
|
boolean |
isCollectionIdentificationVariable(java.lang.String variableName)
Determines whether the given identification variable is defining a join or a collection member declaration expressions. |
boolean |
isRangeIdentificationVariable(java.lang.String variableName)
Determines whether the given variable name is an identification variable name used to define an abstract schema name. |
boolean |
isResultVariable(java.lang.String variable)
Determines if the given variable is a result variable. |
boolean |
isSubquery()
Determines whether this JPQLQueryContext currently holds the information of a subquery
or for the top-level query. |
java.lang.String |
literal(Expression expression,
LiteralType type)
Retrieves the "literal" from the given Expression . |
void |
newSubqueryContext(Expression currentQuery)
Changes the state of this context to use the given subquery. |
void |
setJPQLExpression(JPQLExpression jpqlExpression)
Sets the parsed tree representation of the JPQL query. |
void |
setQuery(IQuery query)
Sets the external form of the JPQL query, which will be parsed and information will be extracted for later access. |
protected void |
store(JPQLQueryContext parent,
Expression currentQuery)
Stores the information contained in the given parent into this one. |
java.lang.String |
toString()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected JPQLQueryContext currentContext
JPQLQueryContext
is the context used for the current query or subquery.
If the current context is not the global context, then its parent is non null
.
protected JPQLQueryContext parent
Constructor Detail |
---|
public JPQLQueryContext(JPQLGrammar jpqlGrammar)
JPQLQueryContext
.
jpqlGrammar
- The JPQLGrammar
defines how to parse a JPQL queryprotected JPQLQueryContext(JPQLQueryContext parent, Expression currentQuery)
JPQLQueryContext
.
parent
- The parent contextcurrentQuery
- The parsed tree representation of the subqueryMethod Detail |
---|
protected DeclarationResolver buildDeclarationResolver()
protected DeclarationResolver buildDeclarationResolver(DeclarationResolver parent)
protected JPQLQueryContext.InputParameterVisitor buildInputParameter()
protected abstract JPQLQueryContext buildJPQLQueryContext(JPQLQueryContext currentContext, Expression currentQuery)
protected abstract LiteralVisitor buildLiteralVisitor()
protected ParameterTypeVisitor buildParameterTypeVisitor()
protected JPQLQueryContext.QueryExpressionVisitor buildQueryExpressionVisitor()
protected abstract ResolverBuilder buildResolverBuilder()
public void convertUnqualifiedDeclaration(DeclarationResolver.Declaration declaration)
DeclarationResolver.Declaration
from being set as a range variable declaration to
a path expression declaration.
In this query "UPDATE Employee SET firstName = 'MODIFIED' WHERE (SELECT COUNT(m) FROM
managedEmployees m) > 0
" managedEmployees is an unqualified collection-valued
path expression (employee.managedEmployees
).
declaration
- The DeclarationResolver.Declaration
that was parsed to range over an abstract schema
name but is actually ranging over a path expressionpublic void dispose()
public void disposeSubqueryContext()
public java.util.Collection<InputParameter> findInputParameters(java.lang.String parameterName)
InputParameters
with the given parameter name.
parameterName
- The parameter used to find the InputParameters
with the same value
InputParameters
that has the given parameter or an
empty collectionpublic Expression getActualCurrentQuery()
Expression
being manipulated, which is either the top-level query
or a subquery.
public DeclarationResolver getActualDeclarationResolver()
DeclarationResolver
of this context and not from the current query's
declaration.
DeclarationResolver
for this contextpublic JPQLQueryContext getCurrentContext()
JPQLQueryContext
, i.e. the context of the query being manipulated,
which can either be the top-level query or a subquery.
public Expression getCurrentQuery()
Expression
being manipulated, which is either the top-level query
or a subquery.
public DeclarationResolver getDeclarationResolver()
DeclarationResolver
of the current query's declaration. For a
SELECT query, it contains the information defined in the FROM clause. For
DELETE and UPDATE queries, it contains a single range declaration variable. If
the current query is a subquery, then it contains the information defined in the
FROM
clause.
DeclarationResolver
for the current query being visitedpublic DeclarationResolver getDeclarationResolver(Expression expression)
DeclarationResolver
of the current query's declaration. For a
SELECT query, it contains the information defined in the FROM clause. For
DELETE and UPDATE queries, it contains a single range variable declaration. If
the current query is a subquery, then it contains the information defined in the subquery
FROM
clause.
expression
- The Expression
that will be used to retrieve its query expression,
i.e. either JPQLExpression
or SimpleSelectStatement
DeclarationResolver
for the current query being visitedprotected DeclarationResolver getDeclarationResolverImp()
DeclarationResolver
of the current query's declaration.
DeclarationResolver
for the current query being visitedpublic java.util.List<DeclarationResolver.Declaration> getDeclarations()
Declarations
.
Declarations
of the current query that was parsedpublic IType getEnumType(java.lang.String enumTypeName)
IType
representing the possible given enum type. If the type name
enumTypeName
- The fully qualified enum type with the constant
public ExpressionRegistry getExpressionRegistry()
JPQLQueryBNFs
and the ExpressionFactories
that are used to properly parse a JPQL query.
public JPQLGrammar getGrammar()
Expression
protected JPQLQueryContext.InputParameterVisitor getInputParameterVisitor()
public java.util.Collection<Join> getJoins(java.lang.String variableName)
variableName
- The name of the identification variable that should be used to define an
abstract schema name
public JPAVersion getJPAVersion()
public JPQLExpression getJPQLExpression()
public java.lang.String getJPQLQuery()
protected LiteralVisitor getLiteralVisitor()
public IMapping getMapping(Expression expression)
IMapping
for the field represented by the given Expression
.
expression
- The Expression
representing a state field path expression or a
collection-valued path expression
IMapping
or null
if none existspublic IType getParameterType(InputParameter inputParameter)
InputParameter
. The type
will be guessed based on its location within expression.
Note: Both named and positional input parameter can be used.
inputParameter
- The InputParameter
to retrieve its type
null
if the type could
not be determinedprotected ParameterTypeVisitor getParameterTypeVisitor()
public JPQLQueryContext getParent()
null
if the current context is the rootpublic IManagedTypeProvider getProvider()
public IQuery getQuery()
public Expression getQueryExpression(Expression expression)
Expression
representing the query statement (either the top-level query
JPQLExpression
or the subquery SimpleSelectStatement
) owning the given Expression
.
expression
- A child of the "root" Expression
to retrieve
Expression
protected JPQLQueryContext.QueryExpressionVisitor getQueryExpressionVisitor()
public Resolver getResolver(Expression expression)
Resolver
for the given Expression
. The
Resolver
can return the IType
and ITypeDeclaration
of the Expression
and either the IManagedType
or the IMapping
.
expression
- The Expression
for which its Resolver
will be retrieved
Resolver
for the given Expression
public Resolver getResolver(java.lang.String variableName)
Resolver
mapped with the given identification variable. If the
identification is not defined in the declaration traversed by this resolver, than the search
will traverse the parent hierarchy.
variableName
- The identification variable that maps a Resolver
Resolver
mapped with the given identification variableprotected ResolverBuilder getResolverBuilder()
public java.util.Set<java.lang.String> getResultVariables()
public IType getType(java.lang.Class<?> type)
type
- The Java type to wrap with an external form
public IType getType(Expression expression)
IType
of the given Expression
.
expression
- The Expression
for which its type will be calculated
IType
that was resolved by this Resolver
or the
IType
for IType.UNRESOLVABLE_TYPE
if it could not be resolvedpublic IType getType(java.lang.String typeName)
typeName
- The fully qualified class name of the class to retrieve
public ITypeDeclaration getTypeDeclaration(Expression expression)
ITypeDeclaration
of the field handled by this Resolver
.
expression
- The Expression
for which its type declaration will be calculated
ITypeDeclaration
that was resolved by this Resolver
or the
ITypeDeclaration
for IType.UNRESOLVABLE_TYPE
if it could not be resolvedpublic TypeHelper getTypeHelper()
types
.
IType
public ITypeRepository getTypeRepository()
ITypes
public boolean hasJoins()
true
if the query or subquery being traversed contains JOIN
expressions; false
otherwiseprotected void initialize(JPQLGrammar jpqlGrammar)
JPQLQueryContext
.
jpqlGrammar
- The grammar that defines how to parse a JPQL queryprotected void initializeRoot()
public boolean isCollectionIdentificationVariable(java.lang.String variableName)
variableName
- The identification variable to check for what it maps
true
if the given identification variable maps a collection-valued field
defined in a JOIN
or IN
expression; false
if it's not
defined or it's mapping an abstract schema namepublic boolean isRangeIdentificationVariable(java.lang.String variableName)
variableName
- The name of the variable to verify if it's defined in a range variable
declaration in the current query or any parent query
true
if the variable name is mapping an abstract schema name; false
if it's defined in a collection member declarationpublic boolean isResultVariable(java.lang.String variable)
variable
- The variable to check if it's a result variable
true
if the given variable is defined as a result variable; false
otherwisepublic boolean isSubquery()
JPQLQueryContext
currently holds the information of a subquery
or for the top-level query.
true
if the current context is for a subquery; false
for the
top-level querypublic java.lang.String literal(Expression expression, LiteralType type)
Expression
. The literal to retrieve depends on
the given type
. The literal is basically a string value like an
identification variable name, an input parameter, a path expression, an abstract schema name,
etc.
expression
- The Expression
to visittype
- The LiteralType
helps to determine what to retrieve from the visited
Expression
Expression
or an empty string if the given Expression
and the LiteralType
do not matchpublic void newSubqueryContext(Expression currentQuery)
currentQuery
- The parsed tree representation of the subquery that will become the
current querydisposeSubqueryContext()
public void setJPQLExpression(JPQLExpression jpqlExpression)
setQuery(IQuery)
because the JPQL query is automatically parsed by that method.
jpqlExpression
- The parsed representation of the JPQL query to manipulatesetQuery(IQuery)
public void setQuery(IQuery query)
query
- The external form of the JPQL querysetJPQLExpression(JPQLExpression)
protected void store(JPQLQueryContext parent, Expression currentQuery)
parent
- The parent context, which is the context of the parent querycurrentQuery
- The subquery becoming the current querypublic java.lang.String toString()
toString
in class java.lang.Object
|
EclipseLink 2.4.2, build 'v20130514-5956486' API Reference | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |