org.eclipse.persistence.jpa.jpql.tools.model

Class AbstractJPQLQueryBuilder

java.lang.Object

org.eclipse.persistence.jpa.jpql.tools.model.AbstractJPQLQueryBuilder

All Implemented Interfaces:

IJPQLQueryBuilder

Direct Known Subclasses:

EclipseLinkJPQLQueryBuilder, JPQLQueryBuilder1_0, JPQLQueryBuilder2_0, JPQLQueryBuilder2_1

public abstract class AbstractJPQLQueryBuilder
extends java.lang.Object
implements IJPQLQueryBuilder

An abstract implementation of IJPQLQueryBuilder that parses a JPQL query or any JPQL fragments and creates the StateObject representation by delegating the creation to an instance of BasicStateObjectBuilder.

Since:

2.4

Version:

2.4

Author:

Pascal Filion

See Also:

DefaultJPQLQueryBuilder, EclipseLinkJPQLQueryBuilder

Method Summary

Modifier and Type	Method and Description
ICaseExpressionStateObjectBuilder	buildCaseExpressionStateObjectBuilder(StateObject parent) Creates a builder that can create a CASE expression programmatically.
JPQLQueryStateObject	buildStateObject(IManagedTypeProvider provider, java.lang.CharSequence jpqlQuery, boolean tolerant) Creates a state model representation of a JPQL query that can be edited.
JPQLQueryStateObject	buildStateObject(IManagedTypeProvider provider, java.lang.CharSequence jpqlQuery, java.lang.String queryBNFId, boolean tolerant) Creates a state model representation of a JPQL query that can be edited.
StateObject	buildStateObject(StateObject parent, java.lang.CharSequence jpqlFragment, java.lang.String queryBNFId) Creates a StateObject representation of the given JPQL fragment.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.eclipse.persistence.jpa.jpql.tools.model.IJPQLQueryBuilder

buildStateObjectBuilder, buildStateObjectBuilder, buildStateObjectBuilder, buildStateObjectBuilder, getGrammar

Method Detail

buildCaseExpressionStateObjectBuilder

public ICaseExpressionStateObjectBuilder buildCaseExpressionStateObjectBuilder(StateObject parent)

Creates a builder that can create a CASE expression programmatically. Once the expression is complete, ICaseExpressionStateObjectBuilder.buildStateObject() will return the result.

Specified by:

buildCaseExpressionStateObjectBuilder in interface IJPQLQueryBuilder

Parameters:

parent - The StateObject that will be the parent of the newly created model

Returns:

The builder of a CASE expression

buildStateObject

public JPQLQueryStateObject buildStateObject(IManagedTypeProvider provider,
                                             java.lang.CharSequence jpqlQuery,
                                             boolean tolerant)

Creates a state model representation of a JPQL query that can be edited.

Specified by:

buildStateObject in interface IJPQLQueryBuilder

Parameters:

provider - The provider of managed types

jpqlQuery - The JPQL query to parse into a StateObject model

tolerant - Determines if the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries

Returns:

The root of the StateObject model that represents the edited form of the JPQL query

buildStateObject

public JPQLQueryStateObject buildStateObject(IManagedTypeProvider provider,
                                             java.lang.CharSequence jpqlQuery,
                                             java.lang.String queryBNFId,
                                             boolean tolerant)

Creates a state model representation of a JPQL query that can be edited.

Specified by:

buildStateObject in interface IJPQLQueryBuilder

Parameters:

provider - The provider of managed types

jpqlQuery - The JPQL query to parse into a StateObject model

queryBNFId - The unique identifier of the query BNF that will be used to parse the fragment

tolerant - Determines if the parsing system should be tolerant, meaning if it should try to parse invalid or incomplete queries

Returns:

The root of the StateObject model that represents the edited form of the JPQL query

buildStateObject

public StateObject buildStateObject(StateObject parent,
                                    java.lang.CharSequence jpqlFragment,
                                    java.lang.String queryBNFId)

Creates a StateObject representation of the given JPQL fragment. In order to properly parse the fragment, the given unique identifier of the JPQLQueryBNF will determine how to parse it.

It is possible the given JPQL fragment has more than one expression, in this case, parsing should stop at the first comma (x, y) or space (x y) where x and y are two separate expressions.

Specified by:

buildStateObject in interface IJPQLQueryBuilder

Parameters:

parent - The StateObject that will be the parent of the newly created model

jpqlFragment - A portion of a JPQL query that will be parsed and the StateObject representation will be created

queryBNFId - The unique identifier of the query BNF that will be used to parse the fragment

Returns:

The StateObject representation of the given JPQL fragment