|
|
(16 intermediate revisions by the same user 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.
| + | |
− |
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | | + | |
− | 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();
| + | |
− | }
| + | |
− | }
| + | |
− | </source>
| + | |
− | | + | |
− | ==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]]
| + | |