Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "GMF Xpand Migration howto"
(→Additional References: filled) |
(→Migration Tool: section filled) |
||
Line 2: | Line 2: | ||
== Migration Tool == | == Migration Tool == | ||
+ | Migration tool consists of following plugins: | ||
+ | <li>org.eclipse.gmf.xpand.migration | ||
+ | <li>org.eclipse.gmf.xpand.qvtlibrary | ||
+ | <p> | ||
+ | and can be [http://www.eclipse.org/modeling/gmf/downloads/?project= downloaded] as a part of GMF 2.2M4 or later. Source code is available from [[GMF Development Guidelines#CVS]]. | ||
+ | |||
+ | === org.eclipse.gmf.xpand.migration === | ||
+ | This plug-in contains slightly modified source code of legacy GMF Xpand engine together with migration code including UI contribution – probably this package should be reworked later to separate all three logical parts from each other. | ||
+ | This plug-in should be installed into the platform to let migration action(s) working. This plug-in is responsible for the GMF Xpand dialect migration, but with minor modifications can be used to migrate any Xtend language-based queries to QVTO-based. | ||
+ | |||
+ | === org.eclipse.gmf.xpand.qvtlibrary === | ||
+ | QVTO and Xtend languages are very similar, but nevertheless some particular Xtend constructions cannot be simply copied using QVTO – this language always has alternative constructions, but the semantic of QVTO construction can be different from the original Xtend query. In such cases migration code will produce .xpt/.qvto files referencing native libraries implementing particular Xtend language functions. All these native libraries are collected in org.eclipse.gmf.xpand.qvtlibrary plug-in. This plug-in should be installed into the platform to make .xpt/.qvto files produced by the migration plug-in compilable/executable. | ||
== How to execute == | == How to execute == |
Revision as of 13:32, 22 December 2008
One of the most noticeable changes developed during GMF 2.2 M4 cycle was integration of QVTO-based model query language with the XPand template language used throughout GMF. This document is important for those who use custom templates during GMF-based diagram(s) code generation and designed to help in a migration of existing custom template to new QVTO-based queries.
Contents
Migration Tool
Migration tool consists of following plugins:
and can be downloaded as a part of GMF 2.2M4 or later. Source code is available from GMF Development Guidelines#CVS.
org.eclipse.gmf.xpand.migration
This plug-in contains slightly modified source code of legacy GMF Xpand engine together with migration code including UI contribution – probably this package should be reworked later to separate all three logical parts from each other. This plug-in should be installed into the platform to let migration action(s) working. This plug-in is responsible for the GMF Xpand dialect migration, but with minor modifications can be used to migrate any Xtend language-based queries to QVTO-based.
org.eclipse.gmf.xpand.qvtlibrary
QVTO and Xtend languages are very similar, but nevertheless some particular Xtend constructions cannot be simply copied using QVTO – this language always has alternative constructions, but the semantic of QVTO construction can be different from the original Xtend query. In such cases migration code will produce .xpt/.qvto files referencing native libraries implementing particular Xtend language functions. All these native libraries are collected in org.eclipse.gmf.xpand.qvtlibrary plug-in. This plug-in should be installed into the platform to make .xpt/.qvto files produced by the migration plug-in compilable/executable.