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/DiscoverersManager/Documentation/0.8"

(Sources)
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{MoDiscoDiscoverersManagerTabs}}
+
#REDIRECT [[MoDisco/Moved To Help Center]]
 
+
== Features ==
+
 
+
=== Discoverer extension point ===
+
 
+
A discoverer must have a name and provide an implementation of the Discoverer interface to be managed by DiscoveryManager. For each discoverer, a new entry in the MoDisco menu will be added. However, each discoverer should provide a resource filter to adapt the menu depending on a single selected element.
+
 
+
Description of information in the contract of the discoverer extension point :
+
 
+
* '''name''' - Required - information to identify a discoverer in the registry; it must be unique. This name will also be used to populate menu.
+
* '''class''' - Required - A class that implements the Discoverer interface to be managed and used by Discovery manager. When a corresponding element has been selected (filter provided by informations in extension part), a model can usually be retrieved by calling method "discoverElement", and it returns an EMF Resource.
+
* '''path''' - Optional- To allow sub-menu path into root menu provided by Discovery Manager. For example, if your path is "j2se5/filters", the provided menu will be : <root menu> -> java -> filters -> Your Discoverer name
+
 
+
=== Discoverers registry ===
+
 
+
The registry of discoverers references all discoverer extensions installed in the current Eclipse platform. The DiscoveryManager provides an access to this registry. There are two methods : one to retrieve all the discoverers and one to retrieve only one discoverer using its name to identify it.
+
 
+
  /**
+
  * Accessor to all discoverers registered in DiscoveryManager
+
  * through extensions.
+
  *
+
  * @return the list of discoverers available in registry
+
  */
+
  public static List<? extends Discoverer> getDiscoverers()
+
 
+
  /**
+
  * Accessor to one discoverer registered in DiscoveryManager
+
  * through extensions.
+
  *
+
  * @param discovererName name of a discoverer
+
  * @return the discoverer with specified name,
+
  *  or null if there is no discoverer registered with specified name.
+
  */
+
  public static Discoverer getDiscoverer(String discovererName)
+
 
+
=== Dynamic contextual menu ===
+
 
+
The contextual menu will be completed dynamically when a discoverer is able to manage the selected resource.
+
For example, when a java project is selected (instance of IJavaProject):
+
 
+
[[Image:MoDisco-DiscoverersManager dynamic contextual menu.jpg|frame|center|Example with J2se5 discoverer]]
+
 
+
=== Launch configuration framework ===
+
 
+
The launch configuration framework provides a new type of launch configuration (named MoDisco Discoverers) accessible through the “Run Configurations …” menu.
+
 
+
[[Image:MoDisco-DiscoverersManager launch configuration type.jpg|frame|center|Presentation of discoverer type]]
+
 
+
And here is an example of a discovery configuration.
+
 
+
[[Image:MoDisco-DiscoverersManager launch configuration example.jpg|frame|center|Discovery configuration example]]
+
 
+
== Install ==
+
 
+
=== Sources ===
+
You will find a version of this plug-in in [http://dev.eclipse.org/viewsvn/index.cgi/plugins/trunk/org.eclipse.gmt.modisco.infra.discoverymanager/?root=Modeling_MODISCO the SVN repository].
+
 
+
Connection parameters to the SVN repository: [[MoDisco/SVN]].
+
 
+
Here are deployment instructions :
+
* Import the project in your workspace using a SVN client.
+
* Use the "export" menu to export this project as a plug-in (Deployable plug-ins and fragments) in your Eclipse installation. Don't forget to choose the "Package plug-ins as individual jar archives" option.
+
* Re-start your Eclipse to take this plug-in into account.
+
 
+
=== Runtime  ===
+
 
+
You could download it or use the update manager. [http://www.eclipse.org/gmt/modisco/downloads/ See more ...]
+
 
+
== User manual ==
+
 
+
First step: in your plug-in properties (plugin.xml or META-INF/MANIFEST.MF), add a dependency to plug-in “org.eclipse.gmt.modisco.discoverersmanager”.
+
 
+
[[Image:MoDisco-DiscoverersManager plugin dependency initialisation.jpg|frame|center|Dependency to plug-in DiscoverersManager]]
+
 
+
Second step: create a class in your plug-in that implements the Discoverer interface provided by the DiscoverersManager plug-in. See the javadoc of this interface for details of methods.
+
 
+
[[Image:MoDisco-DiscoverersManager class implementing Discoverer.jpg|frame|center|Creation of class which implements Discoverer]]
+
 
+
Third step: in your plug-in properties (plugin.xml or META-INF/MANIFEST.MF), create a “discoverers” extension.
+
 
+
[[Image:MoDisco-DiscoverersManager creation of discoverers extension.jpg|frame|center|Creation of discoverers extension]]
+
 
+
Fourth step: in discoverers extension, a discoverer declaration has been created automatically. You will have to fill element details to validate discoverer declaration.
+
 
+
[[Image:MoDisco-DiscoverersManager fill discoverer extension details.jpg|frame|center|Fill discoverer details]]
+
 
+
 
+
Congratulations, your first discoverer has been successfully defined.
+
 
+
If you want to add several discoverers in your plug-in, first you will have to add a discoverer in your “discoverers” extension.
+
 
+
[[Image:MoDisco-DiscoverersManager add another discoverer declaration in your extension.jpg|frame|center|Add another discoverer declaration in your extension]]
+
 
+
Then, you will have to fill element details to obtain a second valid discoverer.
+
 
+
[[Image:MoDisco-DiscoverersManager several discoverer declarations in your extension.jpg|frame|center|Several discoverer declarations in your extension]]
+

Latest revision as of 10:56, 2 April 2012

  1. REDIRECT MoDisco/Moved To Help Center

Back to the top