Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "MoDisco/Components/QueryManager/Documentation/0.8"

 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{MoDiscoTabs|QueryManager|0|1}}
+
#REDIRECT [[MoDisco/Moved To Help Center]]
 
+
== How to create a MoDisco query set ==
+
The first step is to [[MoDisco/ProjectNature|create a MoDisco project]].
+
 
+
Right-click on the MoDisco project and select the "New > Other ..." button.
+
 
+
[[Image:NewModelQuerySet 001.png]]
+
 
+
Select "QuerySet Model" and press the "Next" button
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_002.png]]
+
 
+
Choose a name for your model query set (My.querySet in the
+
example) and press "Finish".
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_003.png]]
+
 
+
Open the "My.querySet" file and open the "Properties View"
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_006.png]]
+
 
+
Set the description of the query set and take care that the query
+
set name is the same as the containing file name ("My" in the
+
example).
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_007.png]]
+
 
+
Load the resources containing the meta-models used by the model
+
queries that will be owned by the query set. To load a meta-model
+
resource use the "Load meta-model resource" action.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_008.png]]
+
 
+
In this example, we choose to use the KDM meta-model.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_009.png]]
+
 
+
Fill the "Associated Metamodels" field with the ePackages
+
containing the meta-models used by the model queries that will be owned
+
by the query set.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_010.png]]
+
 
+
In this example we use the "core" package.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_011.png]]
+
 
+
Right click on the ModelQuerySet element and choose the "New Child >
+
Java Model Query" action to create a "Java Model Query".
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_012.png]]
+
 
+
Set the name, the description and the return type of the query.
+
Set the "Implementation Class Name" field with the qualified name of the
+
class that will contain the query's Java implementation.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_013.png]]
+
 
+
Fill the "Scope" field with the meta-class to which the query will be
+
applicable.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_014.png]]
+
[[Image:MoDisco_Query_newModelQuerySet_015.png]]
+
[[Image:MoDisco_Query_newModelQuerySet_016.png]]
+
 
+
Create the query's implementation class.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_017.png]]
+
 
+
A MoDisco project is also a "Plug-in project". To be able to
+
refer to the API of the used meta-model, we have to add the "org.eclipse.gmt.modisco.infra.query.core" plug-in and the meta-model
+
implementation plug-in in the plug-in dependencies.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_020_1.png]]
+
 
+
The Java Query implementation class must implement
+
org.eclipse.gmt.modisco.query.core.java.IJavaModelQuery.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_018.png]]
+
[[Image:MoDisco_Query_newModelQuerySet_020.png]]
+
[[Image:MoDisco_Query_newModelQuerySet_021.png]]
+
 
+
==How to consult the MoDisco query set catalog through the UI==
+
If a query set model is valid, it is registered in the model
+
query set catalog. To consult the model query set catalog, we can use
+
the "Model Query Set" view.
+
 
+
To get this view select "Windows > Show view > Other ..."
+
in the menu bar and choose "Query Set" in the list.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_022.png]]
+
[[Image:MoDisco_Query_newModelQuerySet_023.png]]
+
 
+
The "Query set" view presents the available query sets and their
+
queries. For each query, the description model location is pointed out.
+
 
+
[[Image:MoDisco_Query_newModelQuerySet_024.png]]
+
 
+
==How to programmatically use the MoDisco query set catalog.==
+
 
+
Here a MoDisco query API example is provided. For more
+
information please refer to the JavaDoc.
+
 
+
import org.eclipse.emf.ecore.EObject;
+
import org.eclipse.gmt.modisco.infra.query.ModelQuery;
+
import org.eclipse.gmt.modisco.infra.query.ModelQuerySet;
+
import org.eclipse.gmt.modisco.infra.query.core.AbstractModelQuery;
+
import org.eclipse.gmt.modisco.infra.query.core.ModelQuerySetCatalog;
+
import org.eclipse.gmt.modisco.infra.query.runtime.ModelQueryResult;
+
public class Example {
+
+
public Integer main(EObject context) throws Exception {
+
  //Get the model query set catalog.
+
ModelQuerySetCatalog catalog = ModelQuerySetCatalog.getSingleton();
+
//Get the query set named "My".
+
ModelQuerySet modelQuerySet = catalog.getModelQuerySet("My");
+
//Select into the "My" query set a query named "myQuery".
+
//modelQueryDescription is a model element.
+
ModelQuery modelQueryDescription = null;
+
for (ModelQuery modelQuery : modelQuerySet.getQueries()) {
+
if (modelQuery.getName().equals("myQuery")) {
+
modelQueryDescription = modelQuery;
+
break;
+
}
+
}
+
if (modelQueryDescription == null) {
+
throw new Exception();
+
}
+
//Get a java instance of the querySet
+
AbstractModelQuery myModelQuery = catalog
+
.getModelQueryImpl(modelQueryDescription);
+
//the model query set evaluation
+
ModelQueryResult result = myModelQuery.evaluate(context);
+
if (result.getException() != null) {
+
throw new Exception();
+
}
+
return (Integer) result.getValue();
+
}
+
}
+
 
+
 
+
==Query Meta-model Description==
+
 
+
[[Image:MoDisco_Query_Metamodel.png]]
+
 
+
ModelQuerySet is the root of the query model. One root per query
+
model is expected.
+
 
+
ModelQuerySet::name must be unique (in the Eclipse platform) and
+
equal to the containing file name. We recommend to use a name prefix
+
with a namespace, for example: org.eclipse.gmt.modisco.example1.querySet1.
+
 
+
ModelQuerySet::isEditable is true if the query can be edited. If
+
the query is stored into a compiled file then ModelQuerySet::isEditable is
+
false.
+
 
+
ModelQuerySet::getQuery(EString) returns the contained ModelQuery
+
having the requested name.
+
 
+
ModelQuerySet::associatedMetamodels points to the meta-models
+
used by the contained queries.
+
 
+
ModelQuerySet::queries refers to the contained queries.
+
 
+
ModelQuery is an abstract class representing a query.
+
 
+
ModelQuery::name is the query name. In each query set the query
+
names must be unique.
+
 
+
ModelQuery::parameters a set of ModelQueryParameter instances
+
describing the query parameters.
+
 
+
ModelQuery::returnType is an ecore::DataType representing the
+
query return type.
+
 
+
ModelQuery::scope is the set of types on which the query is
+
applicable. Those types are represented by ecore::DataType instances.
+
 
+
ModelQueryParameter is a class representing the query parameters.
+
 
+
ModelQueryParameter::type is an ecore::DataType representing the
+
query parameter type.
+
 
+
ModelQueryParameter::name is the parameter name. In each query
+
the parameter names must be unique.
+
 
+
ModelQuery::isExternalContextDependent must be true if two
+
evaluations of the same query with the same context and parameters can
+
return different results.
+
 
+
JavaModelQuery is a sub class of ModelQuery which points to a
+
Java implemented query.
+
 
+
JavaModelQuery::implemenationClassName contains the qualified
+
name of the class implementing the query. This class must be a sub class
+
of org.eclipse.gmt.modisco.infra.query.core.java.IJavaModelQuery. The
+
Java implementation class must be stored in the same plug-in (or plug-in
+
project) as the query model.
+
 
+
OCLModelQuery::query is the OCL query string.
+
 
+
 
+
== JXPath Queries ==
+
=== JXPath Meta-model Extension Description ===
+
[[Image:MoDisco_Query_jxpath_metamodel.png|JXPath Query Meta-model Extension]]
+
 
+
A JXPathModelQuery is a ModelQuery describing a '''[http://commons.apache.org/jxpath/ JXPath]''' expression.
+
 
+
The JXPath expressions are stored into the JXPathModelQuery::query attribure.
+
 
+
=== Example ===
+
 
+
The '''[http://dev.eclipse.org/svnroot/modeling/org.eclipse.gmt.modisco/plugins/trunk/org.eclipse.gmt.modisco.infra.query.doc/doc/resources/jxpathQueryTest.querySet jxpathQueryTest.querySet]'''
+
model provides an example of a JXPath query. The JXPathQuery stored into
+
'''[http://dev.eclipse.org/svnroot/modeling/org.eclipse.gmt.modisco/plugins/trunk/org.eclipse.gmt.modisco.infra.query.doc/doc/resources/jxpathQueryTest.querySet jxpathQueryTest.querySet]''' returns the name of the EPackage passed in the query
+
context.
+
 
+
[[Category:MoDisco]]
+

Latest revision as of 11:31, 2 April 2012

  1. REDIRECT MoDisco/Moved To Help Center

Back to the top