Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "MoDisco/Components/Java/Composition/Documentation/0.9"

(User manual)
 
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{MoDiscoJavaCompositionTabs}}
+
#REDIRECT [[MoDisco/Moved To Help Center]]
 
+
== Java Composition Metamodel ==
+
 
+
=== Description ===
+
This metamodel ''JavaApplication'' aims at weaving a MoDisco Java Model with a MoDisco KDM Inventory Model. It relies on the core metamodel described in the
+
[http://wiki.eclipse.org/MoDisco/Components/KDMSourceExtension/Documentation/0.9 kdm.source extension framework].
+
 
+
Such a metamodel allows to link java nodes to their physical position in the source files (''JavaNodeSourceRegion'' metaclass owning ''startLine'' ''endLine'' properties).
+
 
+
As proposed in [http://wiki.eclipse.org/MoDisco/Components/KDMSourceExtension/Documentation/0.9 kdm.source extension framework], the reference ''JavaASTNodeSourceRegion.javaNode'' derived from ''ASTNodeSourceRegion.node''. So as the ''Java2File.javaUnit'' from ''CodeUnit2File.unit''.
+
 
+
[[Image:JavaApplicationMetaModel.png|frame|center|JavaApplication Metamodel]]
+
 
+
Note : the references ''java2DirectoryChildren'' and ''java2FileChildren'' are expected to be containment references. For some technical reasons (memory usage tuning via lazy loading), they are not containment to make sure that the ''Java2Directory'', ''Java2File'' and ''JavaNodeSourceRegion'' instances are managed in their own graph compared with ''JavaApplication'' instances (See [http://wiki.eclipse.org/MoDisco/Components/Java/Composition/Architecture#Benchmark benchmark]).
+
 
+
==Java Composition Discoverer==
+
 
+
=== Description ===
+
 
+
MoDisco provides a discoverer associated to the metamodel definition described here.
+
The discovery takes as an entry one workspace Java project.
+
The first step of the discovery creates one Java and one Kdm inventory model, using the associated discoverers.
+
The second step creates a model with ''JavaApplication'' metamodel instances with references to the two models.
+
 
+
[[Image:Javakdmdiscovery.JPG|frame|center|Java and kdm inventory discovery]]
+
 
+
=== User manual  ===
+
 
+
The plug-in 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 Application model of your application (see next Figure).
+
 
+
[[Image:Javakdmdiscoverypopup.JPG|frame|center|Discovering a JavaApplication model]]
+
 
+
 
+
=== Discoverer API ===
+
 
+
Each MoDisco discoverer responds to a normalized interface and can be called programmatically (see org.eclipse.gmt.modisco.infra.discoverymanager.Discoverer).
+
 
+
As an example, you may checkout the code from org.eclipse.gmt.modisco.java.composition.discoverer.tests project.
+
 
+
== Requirements  ==
+
 
+
To use the plug-ins you need:
+
 
+
*JDK 1.5 or above
+
*a version of Eclipse 3.6 or above with the following set of plug-ins installed
+
 
+
:*[[EMF|EMF]] 2.5.0 or higher
+
 
+
== Source Repository  ==
+
 
+
All of the source code is stored in a public source repository, which you can access at:
+
 
+
[https://dev.eclipse.org/svnroot/modeling/org.eclipse.mdt.modisco/plugins/trunk/org.eclipse.modisco.java.composition/ https://dev.eclipse.org/svnroot/modeling/org.eclipse.mdt.modisco/plugins/trunk/org.eclipse.modisco.java.composition/]
+
 
+
[https://dev.eclipse.org/svnroot/modeling/org.eclipse.mdt.modisco/plugins/trunk/org.eclipse.modisco.java.composition.discoverer/ https://dev.eclipse.org/svnroot/modeling/org.eclipse.mdt.modisco/plugins/trunk/org.eclipse.modisco.java.composition.discoverer/]
+

Latest revision as of 11:46, 2 April 2012

  1. REDIRECT MoDisco/Moved To Help Center

Back to the top