Innovator Anbindung an openarchitectureware. Connect. Klaus Weber.

Transkript

1 Innovator 2007 Anbindung an openarchitectureware Klaus Weber Connect

2 Anbindung an openarchitectureware (oaw) Wozu dient die Anbindung an openarchitectureware? Für Innovator Object excellence wird eine modellgetriebene Codegenerierung nach MDSD (Model- Driven Software Development) als Architecture/Model-driven, Incremental Forward-Engineering unterstützt. Das Metamodell von Innovator excellence orientiert sich am Metamodell der UML 2 und dient als Basis für die Codegenerierung. Diese erfolgt als automatische Erstellung von Text (u.a. Quelltext) aus domänenspezifischen Innovator-Modellen über die offene, standard- und schablonenorientierte Sprache XPand von openarchitectureware ( Dabei wird das Generator-Metamodell direkt mit Innovator gekoppelt und so ein performanter, dynamischer Zugriff auf Innovator-Modelle bei der Schablonenauswertung gewährleistet. Derzeit sind Schablonen für die Programmiersprachen Java, C# und C++ im Lieferumfang von Innovator enthalten. Analog können weitere kundenspezifische Schablonen erstellt werden, z.b. um XML-Dateien für objekt-relationale Mapping-Tools (wie Hibernate und Oracle TopLink) oder EJB- Deploymentdescriptoren zu generieren. Die Verfügbarkeit von weiteren Schablonen kann über die Hotline erfragt werden. Im Folgenden wird beispielhaft die Anbindung zur Generierung von Java-Code beschrieben. Was ist openarchitectureware? openarchitectureware ist eine Werkzeugsuite zur Unterstützung der modellbasierten Softwareentwicklung, die auf einem modularen MDA/MDD-Generator-Framework aufbaut, in Java implementiert ist, frei wählbare (Design-)Formate (Metamodelle) importiert und (Code-)Formate exportiert. Unterstützende Werkzeuge (wie Editoren und Modellbrowser) basieren u.a. auf der Eclipse-Plattform. openarchitectureware ist ein "Werkzeug für das Erstellen von MDSD/MDA-Werkzeugen". Im Kern ist es eine Workflow-Engine, die die Definition von Workflows zur Transformation erlaubt, sowie eine Anzahl vorgefertigter Workflow-Komponenten, die genutzt werden können, um Modelle zu lesen und zu instanziieren, sie auf die Verletzung von Randbedingungen zu prüfen, sie in andere Modelle umzuwandeln und schließlich Text zu generieren. openarchitectureware (oaw) ist somit ein Werkzeug zur schablonenbasierten Textgenerierung. Um die gewünschten Generate zu erhalten, sind die Schablonen (Templates) mit entsprechenden Inputs aus dem Modell zu expandieren. Wie integriert Innovator openarchitectureware? Die Eckpunkte der Generierung von Text aus den UML-2-Designmodellen von Innovator über openarchitectureware sind die universelle Java-API mit UML-2-konformen Schnittstellen das Generator-FrameWork von oaw (Release 4) und die anpassbaren Schablonen für die jeweilige Zielsprache. 1

3 Die Java-API von Innovator wird zu 100% in reinem Java implementiert, das auch ohne weitere Innovator-Installation plattformübergreifend ausführbar ist. Die Schnittstellenspezifikation erfolgte in Java-5-Syntax. Die Integration in Innovator-Oberflächen erfolgt über einen eigenen Java-VM-Lader. Informationsfluss und Komponenten von Innovator und openarchitectureware Auslieferungsumfang Alle nötigen Komponenten werden mit Innovator 2007 ausgeliefert: oaw Generator FrameWork Release 4, oaw4-bibliotheken (${INODIR}/java/inooaw4/lib/*.jar) Innovator-Metamodell-Adapter und Typsystem (${INODIR}/java/inooaw/inooaw4.jar) Xpand-Beispielschablonen zur Generierung in den Sprachen Java, C++ und C# (${INODIR}/java/inooaw4/templates) oaw-workflow-datei und -Filter bezogen auf UML-Modellelemente (${INODIR}/java/inooaw4/workflow.oaw bzw..../filter.xml) Innovator Java-API (${INODIR}/java/lib/ext/inojapi.jar) Innovator Java-API-Java-Doc (.../lib/ext/inojapi-doc.jar) Hinweise zu den Komponenten Der Innovator-Metamodell-Adapter stellt das Innovator-Metamodell dem Generator-Backend als Typsystem zur Verfügung, bietet direkten Zugriff auf Modelleigenschaften ohne den Umweg über XMI und wird über die oaw-workflow-komponente parametriert. Die Klasse de.mid.innovator.oaw.onlinemodelaccess implementiert eine oaw-workflow- Komponente, die den Zugriff auf Innovator-Modelle bereitstellt. Sie kann als oaw-workflow-kom- ponente in der Workflow-Definitionsdatei (workflow.oaw) verwendet werden. 2

4 Die Implementierung befindet sich zusammen mit weiteren Klassen im Archiv $(INODIR)/java/inooaw/inooaw4.jar. Beispiel Workflow-Definitionsdatei <?xml version="1.0" encoding="windows-1252"?> <workflow> <property file="workflow.properties"/> <property name="prj.root.dir" value="."/> <property name="language" value="${innovator.language}" /> <property name="src.dir" value="${prj.root.dir}/${srcgenpath}"/> <component id="inosrv" class="de. mid.innovator.oaw4.wf.onlinemodelaccess"> <!-- these params are needed only, if the workflow is started from eclipse --> <inohost value="${inohost}"/> <server value="${inosrv}"/> <model value="${inomodel}"/> <loginuser value="${inouser}" /> <loginpwd value="${inopwd}"/> <filter value="filter.xml"/> <outputslot value="model"/> </component> <component id= "dirhandler" class="de.mid.innovator.oaw4.wf.filesystemhandler"> <cmd value="mkdir"/> <dir value="${src.dir}"/> </component> <component id="generator" class="org.openarchitectureware.xpand2.generator" skiponerrors="true"> <metamodel id="mm" class="de.mid.innovator.oaw4.type.inometamodel"/> <expand value="templates::${language}::root::root FOREACH model.typeselect(de::mid::innovator::srv2api::icw2class::clclassifier)"/> <genpath value="${src.dir}"/> <srcpath value="${src.dir}"/> <prsrcpaths value="${src.dir}"/> <!-- <beautifier class="org.openarchitectureware.xpand2.output.javabeautifier"/> --> </component> </workflow> 3

5 Wie Sie beim Konfigurieren von Innovator vorgehen Die grundsätzlichen Einstellungen für die Anbindung von Innovator Object excellence an openarchitectureware sind Bestandteil der Profile Java Codegenerierung bzw. C# Codegenerierung, die mit Innovator ausgeliefert werden. Konfiguration Das Profil Ihrer Zielsprache müssen Sie in Ihrem Object-Modell mit dem Menübefehl Konfiguration>Profile laden geladen haben. Danach stehen Ihnen die entsprechenden Engineering-Aktionen zur Code-Generierung zur Verfügung. (Den Konfigurationseditor erreichen Sie aus dem Modellbrowser mit dem Menübefehl Wechseln>Konfiguration.) Anschließend müssen Sie lediglich Anpassungen vornehmen, die sich aus Ihrem konkreten Projekt ergeben; einige werden im Folgenden beschrieben. In der Innovator-Modellkonfiguration (Ansicht Aktionen) können Sie die Voreinstellungen zum vollqualifizierten Pfad ihrer oaw-konfigurationsdatei und für die gewünschte Zielsprache ändern. Die konfigurierte Aktion startet inojava.exe im angegebenen Arbeitsverzeichnis. Der Klassenpfad wird entsprechend Register Klassenpfad eingestellt. Anschließend wird die Methode main der angegebenen Klasse ausgeführt. Die oaw-aktion ist so konfiguriert, dass die oaw-workflow-engine (workflow.oaw) ausgeführt wird. (Weitere Informationen finden Sie auf Den oaw-workflow starten Sie im Modellbrowser über den Menübefehl Engineering>Aktion ausführen><zielsprache>-code generieren. Dadurch wird via inojava.exe eine Java Virtual Machine gestartet, die wiederum den oaw- Workflow ausführt. Voraussetzungen Innovator excellence benötigt für alle Java-Anwendungen eine Java Runtime ab Version (Java 5). Diese sollte auf dem Client-Rechner als Standard-JRE installiert sein, damit inojava.exe korrekt funktioniert. Beim Start der Virtual Machine über inojava.exe werden dem aufgerufenen Programm diverse Informationen bereitgestellt, wie beispielsweise die aktuell selektierten Modellelemente. Auf diese Weise kann das Innovator-oAW-Plugin die relevanten Informationen eigenständig auslesen. 4

6 Wie Sie die Anbindung in die IDE integrieren Der Prozess der Codegenerierung mit oaw ist eng an die Eclipse-Plattform gekoppelt, kann aber auch leicht in eine externe Ant-Build-Datei integriert werden. Beispiel Ant-Build-Datei <?xml version="1.0" encoding="iso "?> <project name="generator" default="all" basedir="."> <target name="generate"> <taskdef name="workflow" classname="org.openarchitectureware.workflow.ant.workflowanttasks" /> <workflow file="path/workflow.oaw"> <param name="basedir" value="/base/" /> </workflow> </target> </project> Copyright 2007 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: Innovator 2007 Connect oaw doc 5