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.
ATL 3.0.0 New and Noteworthy
The ATL Toolkit is now compatible with Eclipse Galileo (Eclipse 3.5, EMF 2.5). ATL is still compatible with Eclipse 3.4, 3.3 and 3.2.
The ATL file wizard has been refactored to improve user guidance when creating a new ATL file. You can specify metamodels URIs/paths (for content assist inside the editor) and generate the corresponding launch configuration. Then, to launch the transformation, you just have to specify model (input, output) paths in the launch configuration window.
ATL editor now allows code folding, which can be useful when developing large ATL files.
Clickable Execution Traces
ATL3.0.0 provides console hyperlinks which allow to follow errors just by clicking, as you can see below.
ATL IDE implements the Eclipse launch shortcuts API and allows to directly launch an ATL transformation from its ATL file. When the ATL editor active page is opened on the file you want to launch, simply do Ctrl + F11, this will:
- if you ever defined a launch configuration based on the current file: this will automatically launch the matching launch configuration
- if you ever defined several launch configuration based on the current file: this will open a dialog which allow to choose which configuration you want to launch
- if there is no launch configuration based on the current file: this will initialize a new configuration based on the current ATL file and open it to configure paths (models, libraries...).
ATL provides, under the ATL perspective, the "Register Metamodel" action on .ecore files.
This action reads the .ecore file and registers it into the EMF Registry. This is useful in the case you only have an ecore file as metamodel and you don't have the generated EMF plug-ins installed: in this case usually you can't open models conforming to the ecore metamodel into the EMF xmi default editor. Using the "Register Metamodel" action, you will be able to open such models.
Toggle ATL Nature on projects
ATL perspective provides two new actions available on projects, by right-clicking: under the ATL perspective, you can now convert any project to an ATL project. This action adds the ATL nature to the project, which makes every .atl files inside of the project to be compiled as a .asm file. You can remove the ATL nature from an ATL project, regardless of the perspective you are in.
ATL API has been refactored in that release, to provide a better support for:
- launching transformation from Java code, inside & outside of Eclipse
- multiple ATL Virtual Machines use
- HOT (High-Order Transformations) utilities: ATL compilation from an ATL model, .atl files parsing, generation
For more details, please refer to the documentation.
ATL refining mode consists on transforming a model itself, only rules that do not perform simple copy need to be specified, with all bindings (similar to superimposition but with an implicit copy transformation). In the first refining mode version, the ATL VM was copying the whole model to a new one, applying modifications specified by the rules at the same time. It was not enough efficient and there was no identity preserving.
In that release, the refining mode works by performing in-place transformation. It still keeps ATL semantics (i.e., write-only target model during rule execution) but performs well-enough for interactive usage and preserves elements identity.
An example of that mode is embedded into ATL SDK, you can install it from eclipse: New → Example... → ATL → Public to private Example
ATL now embeds its own set of ant tasks, which are quite similar to the AM3 ones. The task API is extensible and can be improved to support new functionalities – or to redo old AM3 ones. An example of ant launching is integrated into the Public to private Example.