Code generieren mit - MID GmbH...» Aktivieren Sie das Auswahlfeld openArchitectureWare 4.1. » Klappen Sie die Liste unter dem Eintrag openArchitectureWare 4.1 auf. » Klappen Sie

Innovator 2007

Code generieren mit Eclipse und oAW

How

To Eclipse und oAW konfigurieren und

zur Code-Generierung mit xPand-

Schablonen nutzen

Albert Scheuerer, René Beckert

www.mid.de

HowTo Code generieren mit Eclipse und oAW

Eclipse und oAW konfigurieren und zur Code-Generierung mit xPand-Schablonen nutzen

Einleitung................................................................................................... 2Inhalt Voraussetzungen....................................................................................... 2Installationsalternativen............................................................................. 2Anmerkung zur nachfolgenden Beschreibung .......................................... 2Eclipse installieren..................................................................................... 2Start von Eclipse........................................................................................ 3Eclipse konfigurieren – Proxy-Settings einstellen ..................................... 3Eclipse Modeling Framework installieren.................................................. 4openArchitectureWare 4.1 installieren ...................................................... 9Voreingestellte Oberflächenansicht nach der Installation ....................... 13Package-Explorer aufrufen...................................................................... 13Anlegen eines neuen Projekts................................................................. 14Innovator-API in das Projekt einbinden................................................... 15xPand-Schablone im Projekt anlegen ..................................................... 16Workflow-Datei im Projekt anlegen ......................................................... 18Codegenerierung mit den erstellten Schablonen .................................... 19

Einleitung Das oAW-Plugin für Eclipse hilft bei der Erstellung von xPand-Schablonen für die Generierung aus Innovator Object eXcellence und bietet Funktionali-tä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. Voraussetzungen

Installationsalternativen Es gibt zwei Möglichkeiten, die Installation von oAW 4.1 vorzunehmen:

Die nachfolgend beschriebene Installation (stellt eine Referenzinstallati-on 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 Beschrei-bung anpassungsbedürftig werden (zum Beispiel bei der Auswahl der zu installierenden oAW-Features; siehe unten).

Anmerkung zur nachfolgenden Beschreibung

Eclipse installieren So gehen Sie vor

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 Bei-spiel: C:\Programme); falls in diesem Verzeichnis bereits ein Unterver-zeichnis eclipse vorhanden ist, benennen Sie vorher dieses Unterver-zeichnis um oder löschen Sie das Verzeichnis, falls es nicht mehr benö-tigt wird.

2

http://www.eclipse.org/downloads/


Start von Eclipse So gehen Sie vor

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:

» Wählen Sie den gewünschten Workspace.

» Falls der Workspace-Launcher nicht bei jedem Start von Eclipse er-scheinen soll: Aktivieren Sie das Auswahlfeld Use this as the de-fault and do not ask again.

Eclipse konfigurieren – Proxy-Settings einstel-len

Werden Komponenten in Eclipse nachinstalliert, so lädt Eclipse die erforder-lichen Dateien automatisch aus dem Internet. Dazu muss eine funktionie-rende Internetverbindung existieren. Falls Sie in Ihrem Netzwerk über einen Proxy ins Internet gehen, müssen Sie diesen Proxy in Eclipse konfigurieren.

So gehen Sie vor

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 Ec-lipse Modeling Framework (EMF). Daher muss dieses Framework zuvor installiert werden.

So gehen Sie vor

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 in-

stall.

» Betätigen Sie die Schaltfläche [Next].


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:


Die Ansicht Updates öffnet sich.

» Aktivieren Sie das Auswahlfeld Eclipse Modeling Framework.


6


Nun erscheint ein Dialog mit den Lizenzbedingungen für das EMF:

» Aktivieren Sie das Alternativfeld I accept the terms in the li-

cense agreements.



» 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äti-

gen.

Die Installation des Eclipse Modeling Framework ist nun abgeschlossen.

8


openArchitectureWare 4.1 installieren

So gehen Sie vor

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 in-

stall.



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.


Sie kehren zum Dialog Install zurück.

» Deaktivieren Sie das Auswahlfeld Eclipse Modeling Framework.

» Aktivieren Sie das Auswahlfeld openArchitectureWare.


10




» 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 li-

cense agreements.

11





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 fol-gende Oberflächen-Ansicht:

Es wird empfohlen, den Package-Explorer aufzurufen.

Package-Explorer aufrufen

So gehen Sie vor

Um den Package-Explorer zu öffnen:

» Wählen Sie im Menü Window>Show View>Package Explorer

13


Anlegen eines neuen Projekts

So gehen Sie vor

Um ein neues Projekt anzulegen:

» Wählen Sie im Menü File>New>Project…

» Wählen Sie unter openArchitectorWare den Eintrag openArchitec-tureWare Project


» Tragen Sie den Projektnamen ein.


14


Innovator-API in das Projekt einbinden

So gehen Sie vor

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:


» Betätigen Sie die Schaltfläche [Add External JARs…]

» Wählen Sie die Datei inojapi.jar aus (nach einer regulären Innova-tor-Installation zu finden unter $INODIR\java\lib\ext)


» Betätigen Sie die Schaltfläche [Add External JARs…]

15


» Wählen Sie die Datei inooaw4.jar aus (nach einer regulären Innova-tor-Installation zu finden unter $INODIR\java\innoaw4)



xPand-Schablone im Projekt anlegen

So gehen Sie vor

Um eine neue xPand-Schablone im Projekt anzulegen:

» Wählen Sie im Menü File>New>Other…

» Wählen Sie unter openArchitectorWare den Eintrag xPand Templa-te


16


» Tragen Sie den Dateinamen ein.


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 darunterlie-genden Verzeichnissen.

Um mit den erstellten Schablonen Code zu generieren, benötigt man im Projekt eine Workflow-Datei, welche die Schablone(n) referenziert.

17

http://www.eclipse.org/gmt/oaw/doc/


Workflow-Datei im Pro-jekt anlegen

So gehen Sie vor

Um eine Workflow-Datei im Projekt anzulegen:

» Wählen Sie im Menü File>New>Other...

» Wählen Sie unter openArchitectorWare den Eintrag Workflow File.


» Tragen Sie den Dateinamen ein.


18


19

Die angelegte Workflow-Datei ist noch leer (bis auf die Einträge <workflow> und </workflow>.

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 Innovator-modellspezifische Daten eingetragen sind, die von Modell zu Modell angepasst werden müssen.

Codegenerierung mit den erstellten Schablonen

So gehen Sie vor

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: [email protected].

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: [email protected], Internet: http://www.mid.de

Inno

vato

r_20

07_H

owTo

_Ecl

ipse

_oA

W_0

7072

7.do

c

mailto:[email protected]

http://www.mid.de/support/

mailto:[email protected]

http://www.mid.de/

Documents

Code generieren mit - MID GmbH...» Aktivieren Sie das Auswahlfeld openArchitectureWare 4.1. » Klappen Sie die Liste unter dem Eintrag openArchitectureWare 4.1 auf. » Klappen Sie