This extension point aims to list and connect any UML2 Sequence Diagram loader.
A fully qualified identifier of the target extension point.
An optional identifier of the extension instance.
An optional name of the extension instance.
A unique identifier for this <code>uml2SDLoader</code>. This is not mandatory as long as the id attribute cannot be retrieved by the provider plugin. The class attribute is the one on which the underlying algorythm relies.
An name of the extension instance.
The implementation of this UML2 SD viewer loader. The class must implement <code>org.eclipse.linuxtools.tmf.ui.views.uml2sd.load.IUml2SDLoader</code>.
The view ID of the view that this loader aims to populate.
Either <code>org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView</code> itself or a extension of <code>org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView</code>.
Set to true to make this loader the default one for the view; in case of several default loaders, first one coming from extensions list is taken.
1.0
<p>
For an example implementation of the loader class see:
<pre>
plug-in: org.eclipse.linuxtools.tmf.ui
package: org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl
class: TmfUml2SDSyncLoader
</pre>
</p>
<p>
The following is an example of the extension point:
<pre>
<extension
point="org.eclipse.linuxtools.tmf.ui.uml2SDLoader">
<uml2SDLoader
class="org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl.TmfUml2SDSyncLoader"
default="true"
id="org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl.TmfUml2SDSyncLoader"
name="Component Interactions"
view="org.eclipse.linuxtools.ust.examples.ui.componentinteraction">
</uml2SDLoader>
</extension>
</pre>
</p>
<p>
The following is an example of the extension point for the required sequence diagram view:
<pre>
<extension
point="org.eclipse.ui.views">
<view
category="org.eclipse.linuxtools.ust.examples.ui.sequenceDiagrams"
class ="org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView"
id="org.eclipse.linuxtools.ust.examples.ui.componentinteraction"
name="Sequence Diagram"
restorable="true">
</view>
</extension>
</pre>
</p>
<p>
The following example command handler shows how to specify which loader to use while opening the sequence diagram view. This is not necessary if there is only one loader for a given sequence diagram view associated and this loader has the attribute "default" set to "true".
<pre>
public class OpenSDView extends AbstractHandler {
@Override
public Object execute(ExecutionEvent event) throws ExecutionException {
try {
IWorkbenchPage persp = TmfUiPlugin.getDefault().getWorkbench().getActiveWorkbenchWindow().getActivePage();
SDView view = (SDView) persp.showView("org.eclipse.linuxtools.ust.examples.ui.componentinteraction");
LoadersManager.getLoadersManager().createLoader("org.eclipse.linuxtools.tmf.ui.views.uml2sd.impl.TmfUml2SDSyncLoader", view);
} catch (PartInitException e) {
throw new ExecutionException("PartInitException caught: ", e);
}
return null;
}
}
</pre>
</p>
<p>
For this extension point a sequence diagram view has to be defined as well. The sequence diagram view class implementation is provided by the plug-in org.eclipse.linuxtools.tmf.ui (org.eclipse.linuxtools.tmf.ui.views.uml2sd.SDView) and can be used as is or can also be sub-classed.
</p>
<p>
With this extension point, a loader class is associated with a sequence diagram view. Multiple loaders can be associated to a single sequence diagram view. However, additional means have to be implemented to specify which loader should be used when opening the view. For example, an eclipse action or command could be used for that (see example section). This additional code is not necessary if there is only one loader for a given sequence diagram view associated and this loader has the attribute "default" set to "true".
</p>
Copyright (c) 2005, 2008, 2011 IBM Corporation, Ericsson and others
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at <a
href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>