Skip to main content
Jump to: navigation, search

Difference between revisions of "Java reverse engineering"

m (Minor style & grammatical edits.)
(Installation Instructions)
Line 2: Line 2:
 
The Java reverse tools allow Java files or packages to be reverse-engineered into a Papyrus class diagram.
 
The Java reverse tools allow Java files or packages to be reverse-engineered into a Papyrus class diagram.
  
== Installation Instructions==
+
== Installation instructions==
Java Reverse Engineering is available as a Papyrus extra plugin.
+
The Java features of Papyrus are available as part of the [http://wiki.eclipse.org/Papyrus_Software_Designer Papyrus Software Designer] extra feature.
  
You can install it by using the Papyrus update site corresponding to your Papyrus version.
+
You can install it by using the Papyrus Software Designer update-site:
The current Papyrus update site can be found at the following page :
+
* http://download.eclipse.org/modeling/mdt/papyrus/components/designer/
*http://www.eclipse.org/papyrus/download.html
+
Or you can use the nightly build update site (paste following url in eclipse update site):
Use the update site corresponding to your Eclipse version.
+
* https://hudson.eclipse.org/papyrus/view/Designer/job/papyrus-designer-neon-papyrusnightly/ws/releng/org.eclipse.papyrus.designer.p2/target/repository/
  
Example :
+
Then select "Papyrus Java profile, library and code generation (Incubation)" feature. You need JDT installed (which comes with most Eclipse packages).
*For the latest Mars version, use:
+
**http://download.eclipse.org/modeling/mdt/papyrus/updates/releases/mars
+
 
+
*For the Neon version, use:
+
**http://download.eclipse.org/modeling/mdt/papyrus/updates/nightly/neon or
+
**http://download.eclipse.org/modeling/mdt/papyrus/updates/releases/neon
+
**with the additional designer update-site: http://download.eclipse.org/modeling/mdt/papyrus/components/designer/
+
 
+
Please note that the JavaReverse feature is currently not available for Neon, it can only be found in the designer git source (https://git.eclipse.org/r/papyrus/org.eclipse.papyrus-designer)
+
 
+
Then :
+
*Unselect 'Group item by category'
+
*Select  '  Papyrus Java Reverse (Incubation)'
+
*Finish
+
  
 
== How to use Reverse ==
 
== How to use Reverse ==

Revision as of 08:58, 19 October 2016

Through Eclipse Mars, the Java Reverse Engineering was available in the Papyrus extra plugins. Since Eclipse Neon, they are now in a separate Papyrus component, called Papyrus software designer. The Java reverse tools allow Java files or packages to be reverse-engineered into a Papyrus class diagram.

Installation instructions

The Java features of Papyrus are available as part of the Papyrus Software Designer extra feature.

You can install it by using the Papyrus Software Designer update-site:

Or you can use the nightly build update site (paste following url in eclipse update site):

Then select "Papyrus Java profile, library and code generation (Incubation)" feature. You need JDT installed (which comes with most Eclipse packages).

How to use Reverse

Using Command

Reverse-engineer a Java class

A Java class can be reverse-engineered into a Papyrus class diagram:

  • open the class diagram,
  • select a Java package from a project
  • click the Reverse button ReverseButton.jpg

A UML class is created in Model Explorer. You can now add it into your diagram. Note that all associated classes have also been added to the model.

Reverse-engineer a package

A Java package (and all classes included) can be reverse-engineered into a Papyrus class diagram:

  • open the class diagram,
  • select a Java package from a project,
  • click the Reverse button ReverseButton.jpg

Packages and classes have been created in Model Explorer. Your can now add them to your diagram. Note that all associated classes have also been added to the model.

Reverse-engineering settings

By default, a package named "generated" is created for reverse-engineering. You can choose another package name on the options menu.

JavaReverseOptionsMenu.jpg

This option menu allows one to:

  • change the default package of the reverse-engineering,
  • add or remove search path. The reverse generator search existing UML classes and regenerate them.
  • add or remove creation path. The reverse generator search on existing Java classes to generate a UML class. Useful for creating Java imports (e.g.: String, Integer).

Using Drag & Drop

You can reverse-engineer a class or a package by just dragging & dropping it on a Papyrus diagram:

  • Drag one or more classes and/or packages,
  • Drop the selection into an open diagram.

JavaReverseDragAndDrop.png

A settings dialog is opened. You can modify settings (please see Reverse settings). When you're reverse-engineering via the drag & drop method, you can also choose to display model, packages, and classes / interfaces / enumerations in the Papyrus diagram. To enable display, just click the check-boxes:

JavaReverseDnDPopUp.png

When you click on the OK button, your components are displayed in the Papyrus diagram. Note: while all selected components are reversed-engineered, only components which are selected, but not in the Papyrus diagram are displayed.

JavaReverseDnDResult.png

Change default reverse-engineering settings

The Java code reverse-engineering plugin allows you to change default settings on eclipse preferences:

  • Open Eclipse Preferences,
  • Search for the Papyrus section,
  • Choose Java Code Reverse sub-section

In this preferences page, you can change:

  • default search path values,
  • default creation path values.

Note that there are default values; if you have changed these values for a project, your changes are saved, and default values are not used.

JavaCodeReversePreferences.png

Copyright © Eclipse Foundation, Inc. All Rights Reserved.