org.eclipse.persistence.jpa.jpql.tools

Class DefaultJPQLQueryHelper

java.lang.Object

org.eclipse.persistence.jpa.jpql.tools.AbstractJPQLQueryHelper

org.eclipse.persistence.jpa.jpql.tools.DefaultJPQLQueryHelper

public class DefaultJPQLQueryHelper
extends AbstractJPQLQueryHelper

This helper can perform the following operations over a JPQL query:

• Calculates the result type of a query: AbstractJPQLQueryHelper.getResultType();
• Calculates the type of an input parameter: AbstractJPQLQueryHelper.getParameterType(String).
• Calculates the possible choices to complete the query from a given position (used for content assist): AbstractJPQLQueryHelper.buildContentAssistProposals(int).
• Validates the query by introspecting it grammatically and semantically:
  • AbstractJPQLQueryHelper.validate(),
  • AbstractJPQLQueryHelper.validateGrammar(),
  • AbstractJPQLQueryHelper.validateSemantic().
• Refactoring support:
  • buildBasicRefactoringTool() provides support for generating the delta of the refactoring operation through a collection of TextEdit objects.
  • buildRefactoringTool() provides support for refactoring the JPQL query through the editable StateObject and once all refactoring operations have been executed, the IJPQLQueryFormatter will generate a new string representation of the JPQL query.

This helper should be used when the JPQL query is written using the JPQL grammar defined in the Java Persistence functional specification 1.0 or 2.x.

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.

Since:

2.3

Version:

2.5

Author:

Pascal Filion

Constructor Summary

Constructors

Constructor and Description
DefaultJPQLQueryHelper(JPQLGrammar jpqlGrammar) Creates a new DefaultJPQLQueryHelper.
DefaultJPQLQueryHelper(JPQLQueryContext queryContext) Creates a new JPQLQueryHelper.

Method Summary

Modifier and Type	Method and Description
BasicRefactoringTool	buildBasicRefactoringTool() Creates the concrete instance of the tool that can refactor the content of a JPQL query.
RefactoringTool	buildRefactoringTool() Creates the concrete instance of the tool that can refactor the content of a JPQL query.

Methods inherited from class org.eclipse.persistence.jpa.jpql.tools.AbstractJPQLQueryHelper

buildContentAssistProposals, buildContentAssistProposals, dispose, getGrammar, getJPQLExpression, getParameterType, getParsedJPQLQuery, getProvider, getQuery, getQueryContext, getResultType, getType, getTypeHelper, getTypeRepository, setJPQLExpression, setQuery, validate, validate, validateGrammar, validateGrammar, validateSemantic, validateSemantic

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJPQLQueryHelper

public DefaultJPQLQueryHelper(JPQLGrammar jpqlGrammar)

Creates a new DefaultJPQLQueryHelper.

Parameters:

jpqlGrammar - The JPQLGrammar that will determine how to parse JPQL queries

DefaultJPQLQueryHelper

public DefaultJPQLQueryHelper(JPQLQueryContext queryContext)

Creates a new JPQLQueryHelper.

Parameters:

queryContext - The context used to query information about the JPQL query

Method Detail

buildBasicRefactoringTool

public BasicRefactoringTool buildBasicRefactoringTool()

Creates the concrete instance of the tool that can refactor the content of a JPQL query. This version simply provides the delta of the refactoring operations.

Specified by:

buildBasicRefactoringTool in class AbstractJPQLQueryHelper

Returns:

The concrete instance of RefactoringTool

See Also:

AbstractJPQLQueryHelper.buildRefactoringTool()

buildRefactoringTool

public RefactoringTool buildRefactoringTool()

Creates the concrete instance of the tool that can refactor the content of a JPQL query. This version provides a way to manipulate the editable version of the JPQL query (StateObject and simply outputs the result of the refactoring operations, i.e. the updated JPQL query).

Specified by:

buildRefactoringTool in class AbstractJPQLQueryHelper

Returns:

The concrete instance of RefactoringTool

See Also:

AbstractJPQLQueryHelper.buildBasicRefactoringTool()