org.eclipse.incquery.runtime.matchers.psystem.queries

Class BasePQuery

java.lang.Object

org.eclipse.incquery.runtime.matchers.psystem.queries.BasePQuery

All Implemented Interfaces:

PQuery, PQueryHeader

Direct Known Subclasses:

BaseGeneratedEMFPQuery, GenericEMFPatternPQuery

public abstract class BasePQuery
extends java.lang.Object
implements PQuery

Default implementation of PQuery.

Author:

Bergmann Gabor

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.incquery.runtime.matchers.psystem.queries.PQuery

PQuery.PQueryStatus

Constructor Summary

Constructors

Constructor and Description
BasePQuery()

Method Summary

Modifier and Type	Method and Description
void	checkMutability() Before a modification operation is executed, a mutability check is performed (via the PQuery.getStatus() implementation, and in case of problems an IllegalStateException is thrown.
void	ensureInitialized() If the query definition is uninitialized, initializes it.
void	ensureInitializedSneaky()
java.util.List<PAnnotation>	getAllAnnotations() Returns the list of annotations specified for this query
java.util.Set<PQuery>	getAllReferredQueries() Returns all queries required to evaluate this query (transitively).
java.util.List<PAnnotation>	getAnnotationsByName(java.lang.String annotationName) Returns the list of annotations with a specified name
java.util.Set<PQuery>	getDirectReferredQueries() Returns all queries directly referred in the constraints.
PDisjunction	getDisjunctBodies() Returns all bodies associated with the query in their canonical form.
QueryEvaluationHint	getEvaluationHints() Optional hints regarding the query evaluation strategy, to be interpreted by the query engine.
PAnnotation	getFirstAnnotationByName(java.lang.String annotationName) Returns the first annotation with a specified name
java.util.List<java.lang.String>	getParameterNames() Return the list of parameter names
java.lang.Integer	getPositionOfParameter(java.lang.String parameterName) Returns the index of a named parameter
java.util.List<PProblem>	getPProblems() Returns a list describing the problems that were found in this query.
PQuery.PQueryStatus	getStatus() Returns the initialization status of the definition
boolean	isMutable() An option to check mutability of the query.
java.util.List<java.lang.Object>	publishedAs() Returns the end-user query specification API objects that wrap this query.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.incquery.runtime.matchers.psystem.queries.PQueryHeader

getFullyQualifiedName, getParameters

Constructor Detail

BasePQuery

public BasePQuery()

Method Detail

getPositionOfParameter

public java.lang.Integer getPositionOfParameter(java.lang.String parameterName)

Description copied from interface: PQueryHeader

Returns the index of a named parameter

Specified by:

getPositionOfParameter in interface PQueryHeader

Returns:

the index, or null of no such parameter is available

getStatus

public PQuery.PQueryStatus getStatus()

Description copied from interface: PQuery

Returns the initialization status of the definition

Specified by:

getStatus in interface PQuery

getPProblems

public java.util.List<PProblem> getPProblems()

Description copied from interface: PQuery

Returns a list describing the problems that were found in this query.

TODO: formulate invariant connecting PQuery.getPProblems() and PQuery.getStatus().

Specified by:

getPProblems in interface PQuery

Returns:

a non-null, but possibly empty list of problems

isMutable

public boolean isMutable()

Description copied from interface: PQuery

An option to check mutability of the query. It can be used to avoid getting an IllegalStateException by the execution of PQuery.checkMutability().

Specified by:

isMutable in interface PQuery

Returns:

true if the query specification is still editable

checkMutability

public void checkMutability()
                     throws java.lang.IllegalStateException

Description copied from interface: PQuery

Before a modification operation is executed, a mutability check is performed (via the PQuery.getStatus() implementation, and in case of problems an IllegalStateException is thrown.

Specified by:

checkMutability in interface PQuery

Throws:

java.lang.IllegalStateException

getEvaluationHints

public QueryEvaluationHint getEvaluationHints()

Description copied from interface: PQuery

Optional hints regarding the query evaluation strategy, to be interpreted by the query engine.

To ensure the possibility of external overrides, the evaluation engine should not directly consult this field, but use an IQueryBackendHintProvider instead.

Specified by:

getEvaluationHints in interface PQuery

getAllAnnotations

public java.util.List<PAnnotation> getAllAnnotations()

Description copied from interface: PQueryHeader

Returns the list of annotations specified for this query

Specified by:

getAllAnnotations in interface PQueryHeader

Returns:

a non-null, but possibly empty list of annotations

getAnnotationsByName

public java.util.List<PAnnotation> getAnnotationsByName(java.lang.String annotationName)

Description copied from interface: PQueryHeader

Returns the list of annotations with a specified name

Specified by:

getAnnotationsByName in interface PQueryHeader

Returns:

a non-null, but possibly empty list of annotations

getFirstAnnotationByName

public PAnnotation getFirstAnnotationByName(java.lang.String annotationName)

Description copied from interface: PQueryHeader

Returns the first annotation with a specified name

Specified by:

getFirstAnnotationByName in interface PQueryHeader

Returns:

the found annotation, or null if non is available

getParameterNames

public java.util.List<java.lang.String> getParameterNames()

Description copied from interface: PQueryHeader

Return the list of parameter names

Specified by:

getParameterNames in interface PQueryHeader

Returns:

a non-null, but possibly empty list of parameter names

getDirectReferredQueries

public java.util.Set<PQuery> getDirectReferredQueries()

Description copied from interface: PQuery

Returns all queries directly referred in the constraints. They are all required to evaluate this query

Specified by:

getDirectReferredQueries in interface PQuery

Returns:

a non-null, but possibly empty list of query definitions

getAllReferredQueries

public java.util.Set<PQuery> getAllReferredQueries()

Description copied from interface: PQuery

Returns all queries required to evaluate this query (transitively).

Specified by:

getAllReferredQueries in interface PQuery

Returns:

a non-null, but possibly empty list of query definitions

publishedAs

public java.util.List<java.lang.Object> publishedAs()

Description copied from interface: PQuery

Returns the end-user query specification API objects that wrap this query.

Intended for traceability and debug purposes, not part of normal operation. Returned list is intended to be appended during query specification construction time.

Specified by:

publishedAs in interface PQuery

Returns:

a non-null, but possibly empty list of query specification objects;

getDisjunctBodies

public PDisjunction getDisjunctBodies()

Description copied from interface: PQuery

Returns all bodies associated with the query in their canonical form. If called multiple times, the same set with the same contents will be returned.

Specified by:

getDisjunctBodies in interface PQuery

ensureInitialized

public final void ensureInitialized()
                             throws QueryInitializationException

Description copied from interface: PQuery

If the query definition is uninitialized, initializes it.

Specified by:

ensureInitialized in interface PQuery

Throws:

QueryInitializationException - if initialization of query specification fails

ensureInitializedSneaky

public final void ensureInitializedSneaky()