org.eclipse.incquery.runtime.api

Class GenericQuerySpecification<Matcher extends GenericPatternMatcher>

java.lang.Object

org.eclipse.incquery.runtime.api.impl.BaseQuerySpecification<Matcher>

org.eclipse.incquery.runtime.api.GenericQuerySpecification<Matcher>

All Implemented Interfaces:

IQuerySpecification<Matcher>, PQueryHeader

Direct Known Subclasses:

GenericQuerySpecification, GenericReferencedQuerySpecification, GenericTracedQuerySpecification

public abstract class GenericQuerySpecification<Matcher extends GenericPatternMatcher>
extends BaseQuerySpecification<Matcher>

This is a generic query specification for IncQuery pattern matchers, for "interpretative" query execution. Should be subclassed by query specification implementations specific to query languages.

When available, consider using the pattern-specific generated matcher API instead.

The created matcher will be of type GenericPatternMatcher. Matches of the pattern will be represented as GenericPatternMatch.

Note for overriding (if you have your own query language or ): Derived classes should use defaultInstantiate(IncQueryEngine) for implementing BaseQuerySpecification.instantiate(IncQueryEngine) if they use GenericPatternMatcher proper.

Since:

0.9

Author:

Bergmann Gábor

See Also:

GenericPatternMatcher, GenericPatternMatch, GenericMatchProcessor

Constructor Summary

Constructors

Constructor and Description
GenericQuerySpecification(PQuery wrappedPQuery) Instantiates query specification for the given internal query representation.

Method Summary

Modifier and Type	Method and Description
GenericPatternMatch	newEmptyMatch() Returns an empty, mutable Match compatible with matchers of this query.
GenericPatternMatch	newMatch(java.lang.Object... parameters) Returns a new (partial) Match object compatible with matchers of this query.

Methods inherited from class org.eclipse.incquery.runtime.api.impl.BaseQuerySpecification

getAllAnnotations, getAnnotationsByName, getFirstAnnotationByName, getFullyQualifiedName, getInternalQueryRepresentation, getMatcher, getMatcher, getParameterNames, getParameters, getPositionOfParameter

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.incquery.runtime.api.IQuerySpecification

getPreferredScopeClass

Constructor Detail

GenericQuerySpecification

public GenericQuerySpecification(PQuery wrappedPQuery)

Instantiates query specification for the given internal query representation.

Method Detail

newEmptyMatch

public GenericPatternMatch newEmptyMatch()

Description copied from interface: IQuerySpecification

Returns an empty, mutable Match compatible with matchers of this query. Fields of the mutable match can be filled to create a partial match, usable as matcher input. This can be used to call the matcher with a partial match even if the specific class of the matcher or the match is unknown.

Returns:

the empty match

newMatch

public GenericPatternMatch newMatch(java.lang.Object... parameters)

Description copied from interface: IQuerySpecification

Returns a new (partial) Match object compatible with matchers of this query. This can be used e.g. to call the matcher with a partial match.

The returned match will be immutable. Use IQuerySpecification.newEmptyMatch() to obtain a mutable match object.

Parameters:

parameters - the fixed value of pattern parameters, or null if not bound.

Returns:

the (partial) match object.