public class TraceMatcher extends BaseMatcher<TraceMatch>
Use the pattern matcher on a given model via on(ViatraQueryEngine)
,
e.g. in conjunction with ViatraQueryEngine#on(Notifier)
.
Matches of the pattern will be represented as TraceMatch
.
Original source:
@QueryExplorer(checked = false)
pattern trace(source : EObject, id, target : EObject, trace : Trace, traceabilityId) {
Trace.params(trace, source);
Trace.targets(trace, target);
Trace.id(trace,id);
Traceability.id(traceability,traceabilityId);
Traceability.traces(traceability,trace);
} or {
Trace.objects(trace, source);
Trace.targets(trace, target);
Trace.id(trace,id);
Traceability.id(traceability,traceabilityId);
Traceability.traces(traceability,trace);
}
TraceMatch
,
TraceProcessor
,
TraceQuerySpecification
engine, querySpecification
Modifier and Type | Method and Description |
---|---|
protected TraceMatch |
arrayToMatch(java.lang.Object[] match)
Converts the array representation of a pattern match to an immutable Match object.
|
protected TraceMatch |
arrayToMatchMutable(java.lang.Object[] match)
Converts the array representation of a pattern match to a mutable Match object.
|
int |
countMatches(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Returns the number of all matches of the pattern that conform to the given fixed values of some parameters.
|
static TraceMatcher |
create() |
void |
forEachMatch(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId,
IMatchProcessor<? super TraceMatch> processor)
Executes the given processor on each match of the pattern that conforms to the given fixed values of some parameters.
|
boolean |
forOneArbitraryMatch(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId,
IMatchProcessor<? super TraceMatch> processor)
Executes the given processor on an arbitrarily chosen match of the pattern that conforms to the given fixed values of some parameters.
|
java.util.Collection<TraceMatch> |
getAllMatches(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Returns the set of all matches of the pattern that conform to the given fixed values of some parameters.
|
java.util.Set<java.lang.String> |
getAllValuesOfid()
Retrieve the set of values that occur in matches for id.
|
java.util.Set<java.lang.String> |
getAllValuesOfid(org.eclipse.emf.ecore.EObject pSource,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Retrieve the set of values that occur in matches for id.
|
java.util.Set<java.lang.String> |
getAllValuesOfid(TraceMatch partialMatch)
Retrieve the set of values that occur in matches for id.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOfsource()
Retrieve the set of values that occur in matches for source.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOfsource(java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Retrieve the set of values that occur in matches for source.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOfsource(TraceMatch partialMatch)
Retrieve the set of values that occur in matches for source.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOftarget()
Retrieve the set of values that occur in matches for target.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOftarget(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
Trace pTrace,
java.lang.String pTraceabilityId)
Retrieve the set of values that occur in matches for target.
|
java.util.Set<org.eclipse.emf.ecore.EObject> |
getAllValuesOftarget(TraceMatch partialMatch)
Retrieve the set of values that occur in matches for target.
|
java.util.Set<Trace> |
getAllValuesOftrace()
Retrieve the set of values that occur in matches for trace.
|
java.util.Set<Trace> |
getAllValuesOftrace(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
java.lang.String pTraceabilityId)
Retrieve the set of values that occur in matches for trace.
|
java.util.Set<Trace> |
getAllValuesOftrace(TraceMatch partialMatch)
Retrieve the set of values that occur in matches for trace.
|
java.util.Set<java.lang.String> |
getAllValuesOftraceabilityId()
Retrieve the set of values that occur in matches for traceabilityId.
|
java.util.Set<java.lang.String> |
getAllValuesOftraceabilityId(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace)
Retrieve the set of values that occur in matches for traceabilityId.
|
java.util.Set<java.lang.String> |
getAllValuesOftraceabilityId(TraceMatch partialMatch)
Retrieve the set of values that occur in matches for traceabilityId.
|
TraceMatch |
getOneArbitraryMatch(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Returns an arbitrarily chosen match of the pattern that conforms to the given fixed values of some parameters.
|
boolean |
hasMatch(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Indicates whether the given combination of specified pattern parameters constitute a valid pattern match,
under any possible substitution of the unspecified parameters (if any).
|
TraceMatch |
newMatch(org.eclipse.emf.ecore.EObject pSource,
java.lang.String pId,
org.eclipse.emf.ecore.EObject pTarget,
Trace pTrace,
java.lang.String pTraceabilityId)
Returns a new (partial) match.
|
static TraceMatcher |
on(ViatraQueryEngine engine)
Initializes the pattern matcher within an existing VIATRA Query engine.
|
static IQuerySpecification<TraceMatcher> |
querySpecification() |
protected java.util.Set<java.lang.String> |
rawAccumulateAllValuesOfid(java.lang.Object[] parameters)
Retrieve the set of values that occur in matches for id.
|
protected java.util.Set<org.eclipse.emf.ecore.EObject> |
rawAccumulateAllValuesOfsource(java.lang.Object[] parameters)
Retrieve the set of values that occur in matches for source.
|
protected java.util.Set<org.eclipse.emf.ecore.EObject> |
rawAccumulateAllValuesOftarget(java.lang.Object[] parameters)
Retrieve the set of values that occur in matches for target.
|
protected java.util.Set<Trace> |
rawAccumulateAllValuesOftrace(java.lang.Object[] parameters)
Retrieve the set of values that occur in matches for trace.
|
protected java.util.Set<java.lang.String> |
rawAccumulateAllValuesOftraceabilityId(java.lang.Object[] parameters)
Retrieve the set of values that occur in matches for traceabilityId.
|
protected TraceMatch |
tupleToMatch(Tuple t) |
countMatches, countMatches, emptyArray, forEachMatch, forEachMatch, forOneArbitraryMatch, forOneArbitraryMatch, getAllMatches, getAllMatches, getAllValues, getAllValues, getCapabilities, getEngine, getOneArbitraryMatch, getOneArbitraryMatch, getParameterNames, getPatternName, getPositionOfParameter, getSpecification, hasMatch, matchToArray, newEmptyMatch, newMatch, rawAccumulateAllValues, rawCountMatches, rawForEachMatch, rawForOneArbitraryMatch, rawGetAllMatches, rawGetAllValues, rawGetOneArbitraryMatch, rawHasMatch, setBackend
public static TraceMatcher on(ViatraQueryEngine engine) throws ViatraQueryException
engine
- the existing VIATRA Query engine in which this matcher will be created.ViatraQueryException
- if an error occurs during pattern matcher creationpublic static TraceMatcher create() throws ViatraQueryException
ViatraQueryException
- if an error occurs during pattern matcher creationpublic java.util.Collection<TraceMatch> getAllMatches(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.public TraceMatch getOneArbitraryMatch(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.public boolean hasMatch(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.public int countMatches(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.public void forEachMatch(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId, IMatchProcessor<? super TraceMatch> processor)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.processor
- the action that will process each pattern match.public boolean forOneArbitraryMatch(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId, IMatchProcessor<? super TraceMatch> processor)
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.processor
- the action that will process the selected match.public TraceMatch newMatch(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
The returned match will be immutable. Use BaseMatcher.newEmptyMatch()
to obtain a mutable match object.
pSource
- the fixed value of pattern parameter source, or null if not bound.pId
- the fixed value of pattern parameter id, or null if not bound.pTarget
- the fixed value of pattern parameter target, or null if not bound.pTrace
- the fixed value of pattern parameter trace, or null if not bound.pTraceabilityId
- the fixed value of pattern parameter traceabilityId, or null if not bound.protected java.util.Set<org.eclipse.emf.ecore.EObject> rawAccumulateAllValuesOfsource(java.lang.Object[] parameters)
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOfsource()
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOfsource(TraceMatch partialMatch)
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOfsource(java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
protected java.util.Set<java.lang.String> rawAccumulateAllValuesOfid(java.lang.Object[] parameters)
public java.util.Set<java.lang.String> getAllValuesOfid()
public java.util.Set<java.lang.String> getAllValuesOfid(TraceMatch partialMatch)
public java.util.Set<java.lang.String> getAllValuesOfid(org.eclipse.emf.ecore.EObject pSource, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace, java.lang.String pTraceabilityId)
protected java.util.Set<org.eclipse.emf.ecore.EObject> rawAccumulateAllValuesOftarget(java.lang.Object[] parameters)
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOftarget()
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOftarget(TraceMatch partialMatch)
public java.util.Set<org.eclipse.emf.ecore.EObject> getAllValuesOftarget(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, Trace pTrace, java.lang.String pTraceabilityId)
protected java.util.Set<Trace> rawAccumulateAllValuesOftrace(java.lang.Object[] parameters)
public java.util.Set<Trace> getAllValuesOftrace()
public java.util.Set<Trace> getAllValuesOftrace(TraceMatch partialMatch)
public java.util.Set<Trace> getAllValuesOftrace(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, java.lang.String pTraceabilityId)
protected java.util.Set<java.lang.String> rawAccumulateAllValuesOftraceabilityId(java.lang.Object[] parameters)
public java.util.Set<java.lang.String> getAllValuesOftraceabilityId()
public java.util.Set<java.lang.String> getAllValuesOftraceabilityId(TraceMatch partialMatch)
public java.util.Set<java.lang.String> getAllValuesOftraceabilityId(org.eclipse.emf.ecore.EObject pSource, java.lang.String pId, org.eclipse.emf.ecore.EObject pTarget, Trace pTrace)
protected TraceMatch tupleToMatch(Tuple t)
tupleToMatch
in class BaseMatcher<TraceMatch>
protected TraceMatch arrayToMatch(java.lang.Object[] match)
BaseMatcher
arrayToMatch
in class BaseMatcher<TraceMatch>
protected TraceMatch arrayToMatchMutable(java.lang.Object[] match)
BaseMatcher
arrayToMatchMutable
in class BaseMatcher<TraceMatch>
public static IQuerySpecification<TraceMatcher> querySpecification() throws ViatraQueryException
ViatraQueryException
- if the pattern definition could not be loaded