Innovator 2009 excellence. Anbindung an Eclipse. Einführung, Installation und Konfiguration. Connect. Roland Patka.

Transkript

1 Innovator 2009 excellence Anbindung an Eclipse Einführung, Installation und Konfiguration Roland Patka Connect

2 Inhaltsverzeichnis Einführung... 1 Installation... 2 Konfiguration... 4 Anbindung eines Java-Projekts an ein excellence-modell... 4 Anzuzeigende Stereotype... 6 Quellen-Verzeichnisse Öffnen von Quellcode aus der Innovator-Sicht Wechseln zum Innovator-Modellbrowser Anzeige der Innovator-Sicht Einführung Die hier beschriebene Anbindung an excellence-modelle steht für Eclipse ab Version 3.3 zur Verfügung. Das Eclipse-Plug-in für Innovator excellence stellt im Wesentlichen in Eclipse eine Sicht bereit, innerhalb derer ein excellence-modell als Baum dargestellt wird, sehr ähnlich der aus dem Innovator- Modellbrowser gewohnten Ansicht. Innerhalb der Sicht werden Pakete als aufklappbare Knoten eines Baums dargestellt, unterhalb derer sich wiederum Pakete und andere Modellelemente verbergen. Von jedem Modellelement aus können Sie in den Innovator-Modellbrowser wechseln. Von dort aus steht Ihnen die gesamte Innovator-Funktionalität zur Verfügung. Wenn es zu dem Modellelement eine aus Innovator generierte Quelldatei in Ihrem Projekt gibt, so können Sie diese Quelldatei im Eclipse-Editor von der Innovator-Sicht aus öffnen. Die Innovator-Sicht versucht stets, das zum gerade aktiven Editor gehörende Element zu ermitteln und zu selektieren. Wenn Sie Eclipse beenden, so erfolgt das Logout aus den excellence-modellen. 1

3 Installation Die Installation erfolgt über die Innovator Update-Site: Um das Eclipse-Plug-in für Innovator excellence in Eclipse installieren:» Wählen Sie in Eclipse den Menübefehl Help>Software Updates>Find and Install... Die Dialogbox Install\Update erscheint.» Aktivieren Sie das Alternativfeld Search for new features to install und klicken Sie auf [Next >]. Die Dialogbox Install erscheint.» Klicken Sie auf die Schaltfläche [New Remote Site...] Die Dialogbox New Update Site erscheint.» Geben Sie einen Namen (z. B. Innovator 2009) und die URL der Innovator Update-Site ein: Bestätigen Sie mit [OK]. In der Auswahlfelder-Liste Sites to include in search erhalten Sie dafür einen neuen Eintrag, der aktiviert ist.» Klicken Sie auf die Schaltfläche [Finish]. Die Dialogbox Updates erscheint.» Klappen Sie den Auswahlfelder-Baum ganz auf und aktivieren Sie die Auswahlfelder Innovator 2009 Java API Plugin <Versionsnummer> und Innovator 2009 Eclipse plugin <Versionsnummer>. 2

4 » Klicken Sie auf [Next >]. Die Dialogbox Install Feature License erscheint.» Lesen Sie die Lizenzvereinbarung durch. Falls Sie damit einverstanden sind, aktivieren Sie das entsprechende Alternativfeld und klicken Sie auf [Next >]. Die Dialogbox Install Installation erscheint.» Überprüfen Sie das Installationsverzeichnis. Klicken Sie auf [Finish]. Nach erfolgreicher Installation bietet Eclipse einen Neustart an, den Sie auch durchführen sollten, um die Änderungen wirksam zu machen. Um die Innovator-Sicht in Eclipse zu aktivieren:» Wählen Sie Window>Show View>Other... Die Dialogbox Show View erscheint. Klappen Sie den Knoten Innovator excellence auf und selektieren Sie Innovator-Modell. 3

5 » Bestätigen Sie mit [OK]. Hinweis Das Plug-in ruft Innovator-Anwendungen auf. Daher müssen Sie das Innovator- Verzeichnis mit den ausführbaren Dateien (.../INOEXE) in die Umgebungsvariable PATH eintragen. Konfiguration Für jedes Java-Projekt können Sie eine eigene Innovator-Anbindung in Eclipse einrichten. Dies geschieht durch Aufruf des Innovator-Verbindungsassistenten über das Kontextmenü des jeweiligen Java-Projekts. Anbindung eines Java-Projekts an ein excellence-modell Um eine Innovator-Anbindung einzurichten:» Selektieren Sie im Package Explorer von Eclipse ein Java-Projekt.» Rufen Sie über die rechte Maustaste das Kontextmenü auf und wählen Sie den Menübefehl Innovator excellence>verbindungsassistent... Die Dialogbox Innovator Verbindungsassistent erscheint. 4

6 » Geben Sie den Namen Ihres Innovator Lizenzservers und die Portnummer ein.» Klicken Sie auf [Next >].» Wählen Sie in den Auswahllisten Repository, Modelltyp und -name, Benutzername und Rolle aus.» Klicken Sie auf [Next >].» Geben Sie den Basispfad ein oder wählen Sie ein Verzeichnis aus, in dem die Quelldateien Ihres Java-Projekts liegen. Der Basispfad muss ein Unterverzeichnis des Projektverzeichnisses sein. 5

7 » Klicken Sie auf [Finish].» Öffnen oder aktivieren Sie im Eclipse-Editor eine Quelldatei dieses Java-Projekts. Die Dialogbox Passwort-Eingabe erscheint, falls für den betreffenden Benutzer ein Passwort vorgesehen ist.» Geben Sie das Passwort ein und bestätigen Sie mit [OK]. Sie erhalten in der Innovator-Sicht die Baumstruktur des Modells. Beim ersten Aufruf wird allerdings nur die Wurzel des Baums angezeigt, da noch keine Stereotype für die Anzeige konfiguriert sind. Anzuzeigende Stereotype Um Stereotype für die Anzeige einzustellen:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Innovator-Sicht: Alternativ können Sie über das Kontextmenü (rechte Maustaste klicken und Einstellungen auswählen) dieselbe Dialogbox aufrufen. Die Dialogbox Einstellungen erscheint.» Klicken Sie auf die Schaltfläche [Hinzufügen...]. Die Dialogbox Stereotypauswahl erscheint. 6

8 » Aktivieren Sie die Auswahlfelder der Stereotype, die angezeigt werden sollen. Zum Beispiel:» Bestätigen Sie die Selektion mit [OK]. In der Dialogbox Einstellungen werden die anzuzeigenden Stereotype aufgelistet.» Bestätigen Sie mit [OK]. In der Innovator-Sicht wird der durch die ausgewählten Stereotype gefilterte Baum des excellence- Modells angezeigt und das im Eclipse-Editor aktivierte Element wird selektiert: 7

9 Sie können jederzeit weitere Stereotype für die Anzeige hinzufügen oder entfernen. Die Innovator- Sicht sorgt dafür, dass die eingestellten Stereotype nach Beenden von Eclipse für das betreffende Projekt abgespeichert werden und nach Neustart von Eclipse wieder zur Verfügung stehen. Zusätzlich können Sie die anzuzeigenden Stereotype in eine XML-Datei schreiben bzw. diese aus einer XML-Datei in die Anzeigeliste einlesen. Um anzuzeigende Stereotype in eine XML-Datei zu speichern:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Innovator-Sicht. Die Dialogbox Einstellungen erscheint.» Klicken Sie auf die Schaltfläche [Konfiguration abspeichern...]. Die Dialogbox Speichern unter... erscheint.» Wählen Sie ein Verzeichnis und einen Dateinamen aus.» Klicken Sie auf [Speichern]. 8

10 Die XML-Datei sieht dann beispielsweise wie folgt aus: <?xml version="1.0" encoding="utf-8" standalone="no"?> <stereotypes> <item> <voclclass>clclass</voclclass> <stereotype>class</stereotype> <profile>object excellence</profile> </item> <item> <voclclass>clclass</voclclass> <stereotype>javaclass</stereotype> <profile>j2se</profile> </item> <item> <voclclass>clproperty</voclclass> <stereotype>javaproperty</stereotype> <profile>j2se</profile> </item> : </stereotypes> Für jeden Eintrag in der Anzeigeliste wird ein Tripel gespeichert, das aus Folgendem besteht: Innovator- vocl (API-Name) der Modellklasse, Name des Stereotyps und Name des Profils, in dem das Stereotyp definiert ist. Den Innovator- vocl eines Elements können Sie sehen, wenn Sie im Innovator- Modellbrowser das entsprechende Element selektieren, den Menübefehl Hilfe/Was ist das? aufrufen und den Eintrag API-Name aufklappen. Sie können analog dazu über die Schaltfläche [Konfiguration laden...] Stereotype aus einer XML-Datei in die Anzeigeliste laden. Die XML-Datei muss das oben beschriebene Format haben: <stereotypes> <item> <voclclass>innovator-vocl der Modellklasse</voclclass> <stereotype>stereotypname</stereotype> <profile>profilname des Stereotyps</profile> </item> : </stereotypes> Die Stereotype aus der XML-Datei werden in die Anzeigeliste zu den bereits bestehenden Einträgen hinzugefügt. Hinweis Das Speichern und Laden der Stereotype über die XML-Datei kann vor allem dann sehr hilfreich sein, wenn Sie sich von verschiedenen Java-Projekten aus mit der gleichen Konfiguration zu Innovator-Modellen verbinden möchten. Weil Stereotype über eine Datei in die Anzeigeliste hinzugefügt werden können, kann es vorkommen, dass auch Stereotype geladen werden, die in dem betreffenden Innovator-Modell gar nicht vorhanden sind. Diese Einträge können Sie sehen, wenn Sie in der Auswahlliste über der Anzeigeliste Im Modell nicht vorhanden auswählen: 9

11 Die Stereotype, die in dem betreffenden Modell nicht vorhanden sind, werden zwar in der Anzeigeliste gespeichert, doch für die Anzeige des Baums in der Innovator-Sicht ignoriert. Quellen-Verzeichnisse Bereits beim Aufbau einer Verbindung zu einem Innovator-Modell werden Sie vom Verbindungsassistenten aufgefordert, ein Verzeichnis anzugeben, in dem Ihre Java-Quellen gespeichert sind. Befinden sich Ihre aus Innovator generierten Java-Quellen in mehreren Verzeichnissen, so sollten Sie auch die weiteren Verzeichnisse hinzufügen. Die Verzeichnisse müssen allerdings alle unterhalb des Projektverzeichnisses liegen. Virtuelle Projektordner werden nicht berücksichtigt. Um weitere Quellen-Verzeichnisse hinzuzufügen:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Innovator-Sicht. Die Dialogbox Einstellungen erscheint.» Wechseln Sie in das Register Quellen-Verzeichnisse.» Geben Sie ein Verzeichnis ein (im Format: \Projektname\Unterverzeichnis) oder wählen Sie eines über die Schaltfläche [Auswählen...] aus. Das Verzeichnis muss ein Unterverzeichnis des Projektverzeichnisses sein. 10

12 » Klicken Sie auf die Schaltfläche [Hinzufügen]. Das neue Verzeichnis erscheint in der Liste der ausgewählten Verzeichnisse.» Wiederholen Sie bei Bedarf diesen Vorgang mit anderen Verzeichnissen und klicken Sie danach [OK]. Hinweis Quellen-Verzeichnisse werden für das Öffnen eines in der Innovator-Sicht selektierten Elements im Eclipse-Editor genutzt. Die Innovator-Sicht sucht nur in den eingestellten Quellen-Verzeichnissen nach dem Quellcode des betreffenden E- lements. Die Suche erfolgt rekursiv, d. h. auch Unterverzeichnisse der ausgewählten Verzeichnisse werden berücksichtigt. Öffnen von Quellcode aus der Innovator-Sicht Voraussetzung für das Öffnen von Quellcode ist einerseits, dass zum betreffenden Element Quellcode in Ihrem Java-Projekt existiert, der aus Innovator generiert worden ist (bzw. der die zugehörige aox-uri enthält), und andererseits, dass sich der Quellcode in einem der hinzugefügten Quellen- Verzeichnisse befindet (siehe vorhergehenden Abschnitt). Jedes Innovator-Element kann eindeutig durch seine aox-uri identifiziert werden. Diese wird bei der Code-Generierung aus Innovator als Kommentar in die betreffende Quellcode-Datei geschrieben. Die Suche beim Öffnen des Quellcodes aus der Innovator-Sicht erfolgt über die aox-uri des betreffenden Elements. Sie können somit generierte Dateien oder Klassen auch umbenennen, die Zuordnung geht dabei nicht verloren. Die Kommentarzeile mit der aox-uri sollten Sie allerdings nicht löschen. 11

13 Um Quellcode aus der Innovator-Sicht zu öffnen:» Selektieren Sie ein Element im Baum der Innovator-Sicht, zu dem Sie in Ihrem Java-Projekt (aus Innovator generierten) Quellcode gespeichert haben.» Klicken Sie auf das Symbol in der Symbolleiste der Innovator-Sicht. Alternativ können Sie dieselbe Aktion über das Kontextmenü ausführen: Rechte Maustaste klicken und Öffne im Editor auswählen. Die entsprechende Quellcode-Datei wird (falls vorhanden) im Editor geöffnet oder aktiviert. Wechseln zum Innovator-Modellbrowser Voraussetzung für das Wechseln zum Innovator-Modellbrowser ist das Hinzufügen des Verzeichnisses mit den ausführbaren Innovator-Dateien...\INOEXE zur Umgebungsvariablen PATH. Um zum Innovator-Modellbrowser zu wechseln:» Selektieren Sie ein Element im Baum der Innovator-Sicht.» Klicken Sie auf das Symbol in der Symbolleiste der Innovator-Sicht. Alternativ können Sie dieselbe Aktion über das Kontextmenü ausführen: Rechte Maustaste klicken und Wechsle ins Modell auswählen. Der Innovator-Modellbrowser erscheint und das betreffende Element wird im Modellbrowser selektiert. Klassen- und Komponentendiagramme werden zusätzlich noch geöffnet. Anzeige der Innovator-Sicht Die Anzeige in der Innovator-Sicht orientiert sich stets an dem gerade aktiven Eclipse-Editor. Öffnen Sie z. B. über den Package Explorer eine Java-Datei im Editor, so ermittelt die Innovator-Sicht, ob es ein zugehöriges Element im Baum der Innovator-Sicht gibt und selektiert dieses gegebenenfalls. Haben Sie sich aus mehreren Java-Projekten mit mehreren Innovator-Modellen verbunden, so wird in der Innovator-Sicht stets das Modell angezeigt, das zum geraden aktiven Editor gehört. Öffnen oder aktivieren Sie eine Datei aus einem anderen Projekt, so wechselt auch die Innovator-Sicht automatisch zu dem entsprechenden Innovator-Modell, dass Sie mit diesem neuen Projekt verbunden haben. Innovator 2009 Connect Eclipse excellence doc Copyright 2009 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline. Telefon: +49 (0) , Dieses Dokument finden Sie neben anderen auch im exklusiven Login-Download-Bereich für Innovator-Wartungskunden unter Ihre MID MID GmbH, Eibacher Hauptstraße 141, Nürnberg Telefon: +49 (0) , Fax: +49 (0) , Internet: 12