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 "VIATRA/Releases/MigrationTo1.2"
Line 4: | Line 4: | ||
From version 1.2 EMF-IncQuery is merged into the Viatra project as Viatra-Query. The merger involves the complete removal of org.eclipse.incquery namespace, thus making all code depenent on EMF-IncQuery incompatible with Viatra Query API. To ease the migration process, a migrator tool is included since Viatra 1.2 to reduce manual refactoring as much as possible. | From version 1.2 EMF-IncQuery is merged into the Viatra project as Viatra-Query. The merger involves the complete removal of org.eclipse.incquery namespace, thus making all code depenent on EMF-IncQuery incompatible with Viatra Query API. To ease the migration process, a migrator tool is included since Viatra 1.2 to reduce manual refactoring as much as possible. | ||
− | |||
− | |||
− | * Migration of query projects (EMF-IncQuery 0.8.0-1.1.0) | + | === Usage === |
+ | The tool can be accessed in the 'Configure' context menu on Java/EMF-IncQuery projects where it is applicable. | ||
+ | |||
+ | * '''Update Query Project''': Migration of query projects (EMF-IncQuery 0.8.0-1.1.0) | ||
** Updates project dependencies | ** Updates project dependencies | ||
** Updates query description files | ** Updates query description files | ||
** Updates query specification extensions | ** Updates query specification extensions | ||
− | * Migration of Java and | + | ** Updates IncQuery API usage |
+ | ** ''Important'': this item is not available in projects that are already VIATRA Query projects | ||
+ | * '''Replace EMF-IncQuery API Usage''': Migration of Java and Xtend projects | ||
** Updates usage of EMF-IncQuery API | ** Updates usage of EMF-IncQuery API | ||
+ | ** Safe to be called multiple times | ||
=== Remaining manual tasks after migration === | === Remaining manual tasks after migration === |
Revision as of 08:19, 16 March 2016
Migrating from EMF-IncQuery 1.1
From version 1.2 EMF-IncQuery is merged into the Viatra project as Viatra-Query. The merger involves the complete removal of org.eclipse.incquery namespace, thus making all code depenent on EMF-IncQuery incompatible with Viatra Query API. To ease the migration process, a migrator tool is included since Viatra 1.2 to reduce manual refactoring as much as possible.
Usage
The tool can be accessed in the 'Configure' context menu on Java/EMF-IncQuery projects where it is applicable.
- Update Query Project: Migration of query projects (EMF-IncQuery 0.8.0-1.1.0)
- Updates project dependencies
- Updates query description files
- Updates query specification extensions
- Updates IncQuery API usage
- Important: this item is not available in projects that are already VIATRA Query projects
- Replace EMF-IncQuery API Usage: Migration of Java and Xtend projects
- Updates usage of EMF-IncQuery API
- Safe to be called multiple times
Remaining manual tasks after migration
- Maven builds are not migrated.
- Deprecated API [in EMF-IncQuery 1.1.0] are removed in 1.2.0. These API usages have to be migrated manually.
- Generated plugin extensions other than query specifications are regenerated, but the old ones are not removed. These shall be removed manually.
- Type of static method calls (e.g. AdvancedIncQueryEngine.createUnmanagedEngine()) shall be renamed manually.
- Renamed methods and fields are not migrated by the tool
- Schedulers.getIQEngineSchedulerFactory → Schedulers.getQueryEngineSchedulerFactory
- ExecutionSchemas.createIncQueryExecutionSchema → ExecutionSchemas.createViatraQueryExecutionSchema
- CRUDActivationStateEnum.APPEARED → CRUDActivationStateEnum.CREATED
- CRUDActivationStateEnum.DISAPPEARED → CRUDActivationStateEnum.DELETED