Java Code Reverse Developer Guide

Overview

Papyrus provides an extra plugin named org.eclipse.papyrus.java.reverse which allows to generate 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 user graphical interface to run the reverse plugin
• reverse.utils : provides handlers for reverse.

Dependencies

The following schema shows dependencies between java code reverse plugins:

reverse

The reverse project uses the japa parser to visit the Eclipse AST (Abstract Syntax Tree). This AST allows to plugin to add reverse action for each element (project, class, field, method etc.). For more details, please see the Eclipse AST

In particular, it use a Catalog to find already existing uml components (for example a previous reverse result), and just add non existing components. Note that, as it never remove any component, it leave components of a previous reverse, even if java source code doesn’t exist anymore (for example if user remove this code).

ui

The ui project provides Eclipse user interface for the entire plugin. It is divided in two parts:

• Handlers, which call commands:
  • ReverseCodeHandler, which call the reverse command,
  • CreateAssociationFromPropertyHandler, which find association of a component.
• plugin.xml, which contains buttons, pop menu … . Each component call an handler. Morehover, there components are only available when selected resource is generable, according to xml « when » condition.

Class Diagram

The following is a class diagram of this plugin. While it not shows every classes of the project, it offer a good overview of main classes.