Java Code Reverse Developer Guide
Papyrus provides an extra plugin named org.eclipse.papyrus.java.reverse which can reverse-engineer a Papyrus model from Java source code. It is divided in 3 projects:
- reverse : parse and visit the Eclipse AST of the reversed project.
- reverse.ui : provides the user graphical interface to run the reverse plugin
- reverse.utils : provides handlers for reverse.
The following schema shows dependencies between Java code reverse plugins:
The reverse project uses the japa parser to visit the Eclipse AST (Abstract Syntax Tree). This AST allows the plugin to add reverse action for each element (project, class, field, method etc.). For more details, please see the Eclipse AST
In particular, it uses a Catalog to find preexisting UML components (for example from a previous reverse-engineering action), and only add the non-existing components. Note that, as it never removes any component, it leaves components of previous reverse-engineering actions, even if Java source code does not exist anymore (for example, if user removes this code).
The ui project provides the Eclipse user interface for the entire plugin. It is divided into two parts:
- Handlers, which call commands:
- ReverseCodeHandler, which calls the reverse command,
- CreateAssociationFromPropertyHandler, which finds associations of a component.
- plugin.xml, which contains buttons, pop menu … . Each component calls a handler. Moreover, the components are only available when the selected resource is generatable, according to XML « when » condition.
drag and drop
A drag & drop way to reverse is implemented. It is decomposed into:
- DndReverseCodeDialog: a popup dialog extends from ReverseCodeDialog, which just adds some buttons to allow a user to display or not display reverse-engineered components in a diagram,
- DndReverseCodeHandler: a special handler which searches for reverse-engineered elements to display in a class diagram.
- DropReverseCommand & DropReverseStrategy, which checks if drag & drop is possible. It is possible if (please see DropReverseCommand.canExecute() ):
- selected Java resources are only composed by Compilation Unit (Classes, Interfaces, Enumerations), packages, and Java source folder. Any other item (a Papyrus model file for example) automatically disables the drag and drop.
- Selection is dropped into a Papyrus diagram.