Innovator 2007 Code generieren mit Eclipse und oaw Eclipse und oaw konfigurieren und zur Code-Generierung mit xpand- Schablonen nutzen Albert Scheuerer, René Beckert HowTo www.mid.de
Eclipse und oaw konfigurieren und zur Code-Generierung mit xpand- Schablonen nutzen Inhalt Einleitung... 2 Voraussetzungen... 2 Installationsalternativen... 2 Anmerkung zur nachfolgenden Beschreibung... 2 Eclipse installieren... 2 Start von Eclipse... 3 Eclipse konfigurieren Proxy-Settings einstellen... 3 Eclipse Modeling Framework installieren... 4 openarchitectureware 4.1 installieren... 9 Voreingestellte Oberflächenansicht nach der Installation... 13 Package-Explorer aufrufen... 13 Anlegen eines neuen Projekts... 14 Innovator-API in das Projekt einbinden... 15 xpand-schablone im Projekt anlegen... 16 Workflow-Datei im Projekt anlegen... 18 Codegenerierung mit den erstellten Schablonen... 19 Einleitung Voraussetzungen Installationsalternativen Anmerkung zur nachfolgenden Beschreibung Eclipse installieren Das oaw-plugin für Eclipse hilft bei der Erstellung von xpand-schablonen für die Generierung aus Innovator Object excellence und bietet Funktionalitäten wie Syntax Highlighting, kontextsensitive Vervollständigung von Schlüsselwörtern und automatische Markierung von Fehlern. Das oaw-plugin besitzt Abhängigkeiten zum Eclipse Modeling Framework. Aus diesem Grund muss diese Komponente vor der Installation des oaw- Plugins wie in diesem HowTo beschrieben installiert werden. Bitte stellen Sie sicher, dass auf Ihrem System Java in der Version 1.5 oder einer neueren Version installiert ist. Es gibt zwei Möglichkeiten, die Installation von oaw 4.1 vorzunehmen: Die nachfolgend beschriebene Installation (stellt eine Referenzinstallation her) Falls ein Kollege bereits eine Referenzinstallation (z. B. unter C:\Programme) hat: Das Verzeichnis eclipse des Kollegen auf den eigenen Rechner kopieren (zum Beispiel unter C:\Programme; ein dort eventuell bereits bestehendes Verzeichnis eclipse vorher entweder umbenennen oder löschen) Die nachfolgende Beschreibung gibt den Stand vom Februar 2007 wieder; aufgrund von Updates der zu installierenden Software kann diese Beschreibung anpassungsbedürftig werden (zum Beispiel bei der Auswahl der zu installierenden oaw-features; siehe unten). Um Eclipse zu installieren:» Laden Sie Eclipse von der Web-Seite http://www.eclipse.org/downloads/ herunter.» Entpacken Sie die WinZip-Datei in ein beliebiges Verzeichnis (zum Beispiel: C:\Programme); falls in diesem Verzeichnis bereits ein Unterverzeichnis eclipse vorhanden ist, benennen Sie vorher dieses Unterverzeichnis um oder löschen Sie das Verzeichnis, falls es nicht mehr benötigt wird. 2
Start von Eclipse Um Eclipse zu starten:» Rufen Sie aus dem Windows-Explorer eclipse.exe auf (Im Falle der Installation unter C:\Programme zu finden unter C:\Programme\eclipse). Beim erstmaligen Aufruf von Eclipse erscheint der Workspace-Launcher: Eclipse konfigurieren Proxy-Settings einstellen» Wählen Sie den gewünschten Workspace.» Falls der Workspace-Launcher nicht bei jedem Start von Eclipse erscheinen soll: Aktivieren Sie das Auswahlfeld Use this as the default and do not ask again. Werden Komponenten in Eclipse nachinstalliert, so lädt Eclipse die erforderlichen Dateien automatisch aus dem Internet. Dazu muss eine funktionierende Internetverbindung existieren. Falls Sie in Ihrem Netzwerk über einen Proxy ins Internet gehen, müssen Sie diesen Proxy in Eclipse konfigurieren. Um einen Proxy zu konfigurieren:» Wählen Sie im Menü Window>Preferences.» Wählen Sie in der linken Baumstruktur den Eintrag Install/Update. Die folgende Ansicht erscheint:» Aktivieren Sie das Auswahlfeld Enable http proxy connection.» Tragen Sie die entsprechenden Werte in die Felder HTTP proxy host address und HTTP proxy host port ein.» Beenden Sie den Dialog mit [OK]. 3
Eclipse Modeling Framework installieren Das oaw-plugin für Eclipse besitzt Abhängigkeiten zur Komponente Eclipse Modeling Framework (EMF). Daher muss dieses Framework zuvor installiert werden. Um das EMF zu installieren:» Wählen Sie im Menü Help>Software Updates>Find and Install Folgender Dialog erscheint:» Aktivieren Sie das Alternativfeld Search for new features to install.» Betätigen Sie die Schaltfläche [Next]. Folgender Dialog erscheint: 4
» Betätigen Sie die Schaltfläche [New Remote Site ]. Der Dialog New Update Site erscheint:» Tragen Sie im Feld Name "Eclipse Modeling Framework" ein.» Tragen Sie im Feld URL "http://download.eclipse.org/tools/emf/updates/site.xml" ein.» Betätigen Sie die Schaltfläche [OK]. Sie kehren nun wieder zum Dialog Install zurück.» Aktivieren Sie das Auswahlfeld Eclipse Modeling Framework. Der Dialog sollte sich nun folgendermaßen darstellen:» Schließen Sie den Dialog mit der Schaltfläche [Finish]. 5
Folgende Ansicht erscheint:» Betätigen Sie die Schaltfläche [OK]. Die Ansicht Updates öffnet sich.» Aktivieren Sie das Auswahlfeld Eclipse Modeling Framework.» Betätigen Sie die Schaltfläche [Next]. 6
Nun erscheint ein Dialog mit den Lizenzbedingungen für das EMF:» Aktivieren Sie das Alternativfeld I accept the terms in the license agreements.» Betätigen Sie die Schaltfläche [Next]. Folgender Dialog erscheint:» Betätigen Sie die Schaltfläche [Finish]. Die Installation wird gestartet und nimmt einige Zeit in Anspruch. 7
Zum Abschluss der Installation erscheint folgendes Fenster:» Betätigen Sie die Schaltfläche [Install All]. Eclipse fordert Sie nun zum Neustart der Anwendung auf:» Führen Sie den Neustart durch, indem Sie die Schaltfläche [Yes] betätigen. Die Installation des Eclipse Modeling Framework ist nun abgeschlossen. 8
openarchitectureware 4.1 installieren Um das oaw-plugin für Eclipse zu installieren:» Wählen Sie im Menü Help>Software Updates>Find and Install Folgende Ansicht öffnet sich:» Aktivieren Sie das Alternativfeld Search for new features to install.» Betätigen Sie die Schaltfläche [Next]. Folgender Dialog erscheint: 9
» Betätigen Sie die Schaltfläche [New Remote Site ]. Der Dialog New Update Site erscheint:» Tragen Sie im Feld Name "openarchitectureware 4.1" ein.» Tragen Sie im Feld URL "http://www.openarchitectureware.org/updatesite/milestone/ site.xml" ein.» Betätigen Sie die Schaltfläche [OK]. Sie kehren zum Dialog Install zurück.» Deaktivieren Sie das Auswahlfeld Eclipse Modeling Framework.» Aktivieren Sie das Auswahlfeld openarchitectureware. Der Dialog sollte sich nun folgendermaßen darstellen: 10
» Betätigen Sie die Schaltfläche [Finish]. Folgende Ansicht erscheint:» Aktivieren Sie das Auswahlfeld openarchitectureware 4.1.» Klappen Sie die Liste unter dem Eintrag openarchitectureware 4.1 auf.» Klappen Sie die Liste unter dem Eintrag openarchitectureware auf.» Deaktivieren Sie die Auswahlfelder ATL Adapter Feature <...>, uml2 support for oaw 4 <...> und GMF Adapter Feature < >. Die deaktivierten Komponenten werden für die Installation nicht benötigt, haben aber ihrerseits Abhängigkeiten zu anderen Komponenten. Aus diesem Grund werden sie nicht mit installiert. Der Dialog mit den Lizenzbedingungen erscheint:» Aktivieren Sie das Alternativfeld I accept the terms in the license agreements. 11
» Betätigen Sie die Schaltfläche [Next]. Folgende Ansicht erscheint:» Betätigen Sie die Schaltfläche [Finish]. Die Installation wird nun gestartet. Die Installation nimmt danach einige Zeit in Anspruch. Zum Abschluss der Installation erscheint folgendes Fenster:» Betätigen Sie die Schaltfläche [Install All]. Eclipse fordert Sie nun zum Neustart der Anwendung auf:» Führen Sie den Neustart durch, indem Sie die Schaltfläche [Yes] betätigen. Die Installation des oaw-plugins für Eclipse ist nun abgeschlossen. 12
Voreingestellte Oberflächenansicht nach der Installation Beim erstmaligen Aufruf von Eclipse nach der Installation erhält man folgende Oberflächen-Ansicht: Package-Explorer aufrufen Es wird empfohlen, den Package-Explorer aufzurufen. Um den Package-Explorer zu öffnen:» Wählen Sie im Menü Window>Show View>Package Explorer 13
Anlegen eines neuen Projekts Um ein neues Projekt anzulegen:» Wählen Sie im Menü File>New>Project» Wählen Sie unter openarchitectorware den Eintrag openarchitectureware Project» Betätigen Sie die Schaltfläche [Next].» Tragen Sie den Projektnamen ein.» Betätigen Sie die Schaltfläche [Finish]. 14
Innovator-API in das Projekt einbinden Um die Innovator-API in das Projekt einzubinden:» Wählen Sie im Package Explorer das neu angelegte Projekt.» Wählen Sie im Kontext-Menu Build Path>Configure Build Path ; wählen Sie Java Build Path und wechseln Sie auf die Registerkarte Libraries: Der Dialog sollte sich nun folgendermaßen darstellen:» Betätigen Sie die Schaltfläche [Add External JARs ]» Wählen Sie die Datei inojapi.jar aus (nach einer regulären Innovator-Installation zu finden unter $INODIR\java\lib\ext) Der Dialog sollte sich nun folgendermaßen darstellen:» Betätigen Sie die Schaltfläche [Add External JARs ] 15
» Wählen Sie die Datei inooaw4.jar aus (nach einer regulären Innovator-Installation zu finden unter $INODIR\java\innoaw4) Der Dialog sollte sich nun folgendermaßen darstellen: xpand-schablone im Projekt anlegen» Betätigen Sie die Schaltfläche [OK]. Um eine neue xpand-schablone im Projekt anzulegen:» Wählen Sie im Menü File>New>Other» Wählen Sie unter openarchitectorware den Eintrag xpand Template» Betätigen Sie die Schaltfläche [Next]. 16
» Tragen Sie den Dateinamen ein.» Betätigen Sie die Schaltfläche [Finish]. Innerhalb der Schablone kann auf Innovator-Modelle mittels der JAVA-API zugegriffen werden. Neben den xpand-schablonen können bei Bedarf im Projekt auf analoge Weise auch xtend-dateien und Check-Dateien angelegt werden. Die den xpand-schablonen, xtend-dateien und Check-Dateien jeweils zugrundeliegende Syntax ist auf der Web-Seite http://www.eclipse.org/gmt/oaw/doc/ dokumentiert. Beispiele für diese Dateien sind nach einer regulären Innovator-Installation zu finden unter $INODIR\java\innoaw4\templates und den darunterliegenden Verzeichnissen. Um mit den erstellten Schablonen Code zu generieren, benötigt man im Projekt eine Workflow-Datei, welche die Schablone(n) referenziert. 17
Workflow-Datei im Projekt anlegen Um eine Workflow-Datei im Projekt anzulegen:» Wählen Sie im Menü File>New>Other...» Wählen Sie unter openarchitectorware den Eintrag Workflow File.» Betätigen Sie die Schaltfläche [Next].» Tragen Sie den Dateinamen ein.» Betätigen Sie die Schaltfläche [Finish]. 18
Die angelegte Workflow-Datei ist noch leer (bis auf die Einträge <workflow> und </workflow>. Codegenerierung mit den erstellten Schablonen Ein Beispiel für eine Workflow-Datei ist die Datei workflow.oaw einer regulären Innovator-Installation (nach einer regulären Innovator-Installation zu finden unter $INODIR\java\innoaw4). Diese Datei referenziert eine Datei workflow.properties im gleichen Verzeichnis, in der Innovatormodellspezifische Daten eingetragen sind, die von Modell zu Modell angepasst werden müssen. Um mit den erstellten Schablonen Code zu generieren:» Wählen Sie im Package Explorer die Workflow-Datei.» Wählen Sie im Kontext-Menü der Workflow-Datei entweder Run As>oAW Workflow oder Debug As>oAW Workflow (Debug). Copyright 2007 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline Telefon: +49 911 96836-22, E-Mail: support@mid.de. Dieses Dokument finden Sie neben anderen auch im exklusiven Login- Download-Bereich für INNOVATOR-Wartungskunden unter http://www.mid.de/support/. Ihre MID MID GmbH, Eibacher Hauptstr. 141, D-90451 Nürnberg Telefon: +49 911 96836-0, Fax: +49 911 96836-10 E-Mail: info@mid.de, Internet: http://www.mid.de Innovator_2007_HowTo_Eclipse_oAW_070727.doc 19