|
|
| (6 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | The goal of Java Discoverer plugin is to allow practical extractions of [[MoDisco/Java|Java models]] from a Java project.
| + | #REDIRECT [[MoDisco/Java]] |
| − | | + | |
| − | | + | |
| − | == Description ==
| + | |
| − | | + | |
| − | This plugin aims at analysing Java source code compliant with J2SE 5.0 standard and providing a model describing the information found. As shown in next figure, this model can conform either to the [[MoDisco/Java|Java metamodel]].
| + | |
| − | | + | |
| − | [[Image:JavaDiscovererOverview.jpg|frame|center|Overall approach of the Java discoverer]]
| + | |
| − | | + | |
| − | | + | |
| − | The [[MoDisco/Java|Java model]] is built from the source code by a Java component.
| + | |
| − | | + | |
| − | The [[MoDisco/Java|Java model]] contains the full abstract syntax tree of the Java program : each statement such as attribute definition, method invocation or loop is described. In addition, links between elements are resolved (by resolved link we mean for instance a link between a method invocation and the declaration of this method, or the usage of a variable and its declaration). The model can thus be seen as an abstract syntax graph (ASG).
| + | |
| − | | + | |
| − | == Requirements ==
| + | |
| − | | + | |
| − | To use the plug-in you need:
| + | |
| − | * JDK 1.5 or above
| + | |
| − | * a version of Eclipse 3.3 or above with the following set of plugins installed
| + | |
| − | :* [[EMF|EMF]] 2.3.0 or higher
| + | |
| − | :* [[ATL|ATL]] 2.0.0 or higher
| + | |
| − | :* [[MoDisco/Java|Java metamodel]]
| + | |
| − | | + | |
| − | == Team ==
| + | |
| − | Gabriel Barbier ([http://www.mia-software.com Mia-Software])
| + | |
| − | | + | |
| − | Fabien Giquel ([http://www.mia-software.com Mia-Software])
| + | |
| − | | + | |
| − | Frédéric Madiot ([http://www.mia-software.com Mia-Software])
| + | |
| − | | + | |
| − | == Install ==
| + | |
| − | | + | |
| − | You will find a version of this plug-in attached in [https://bugs.eclipse.org/bugs/show_bug.cgi?id=258281 following bug].
| + | |
| − | | + | |
| − | As IP review of this plugin is not finished, here is installation instructions :
| + | |
| − | | + | |
| − | * Extract archive file in your Eclipse workspace, then use "import" menu to import this project.
| + | |
| − | * Use "export" menu to export this project as a plugin (Deployable plugins and fragments) in your Eclipse installation. Don't forget to choose "Package plug-ins as individual jar archives" option.
| + | |
| − | * re-start your Eclipse to take in account this plug-in
| + | |
| − | | + | |
| − | == User manual ==
| + | |
| − | | + | |
| − | The plugin provides the user with a contextual menu to easily create models.
| + | |
| − | | + | |
| − | By right-clicking on a Java Project in the Eclipse Package Explorer view, you can quickly create the Java model of your application (see next Figure).
| + | |
| − | | + | |
| − |
| + | |
| − | [[Image:MoDisco-JavaDiscoverer popup.png|frame|center|Menus in Eclipse to create model from source code]]
| + | |
| − | | + | |
| − | A progress bar will appear at the bottom of the window as soon as the operation begins. Depending on the size of your application, the reverse engineering might take some time to complete (see next Figure).
| + | |
| − | | + | |
| − | [[Image:MoDisco-JavaDiscoverer progress bar model creation.png|frame|center|Progress bar during model creation]]
| + | |
| − | | + | |
| − | At the end of the process, the newly created model files are added at the root of your project and are automatically opened in the default editor (see next Figure).
| + | |
| − | | + | |
| − | [[Image:MoDisco-JavaDiscoverer Java model.png|frame|center|Java model in the package explorer]]
| + | |
| − | | + | |
| − | .javaxmi files could be opened in the Sample Ecore Model Editor (see next Figure).
| + | |
| − | | + | |
| − | [[Image:MoDisco-JavaDiscoverer Java in EMF browser.png|frame|center|Java model viewed with EMF browser]]
| + | |
| − | | + | |
| − | They could also be opened in MoDisco model browser (see next Figure) which brings some graphical improvements.
| + | |
| − | | + | |
| − | [[Image:MoDisco-JavaDiscoverer example Java SimpleModel.jpg|frame|center|Java model viewed with MoDisco browser]]
| + | |
