Anleitung zur Installation und Verwendung von eclipseuml 2.1.0 In dieser Anleitung wird die Installation und Verwendung von Omodo eclipseuml 2.1.0 beschrieben. eclipseuml ist eine Zusatzsoftware für Eclipse, für die es je Eclipse-Version passende Versionen gibt. Diese Anleitung setzt voraus, dass die vom Autor zu beziehende Eclipse-Version "Eclipse 3.2.1 mit JDK 1.4.2 und Callisto" verwendet wird! Diese Eclipse-Version ist um das Callisto-Paket erweitert worden und verwendet das JDK 1.4.2. In die so konfigurierte Eclipse-Version wird eclipseuml 2.1.0 für Eclipse 3.2 installiert. 1. Laden Sie von der Javakurs-DVD oder vom FTP-Server PC132W.bsnw.fb4.fh-bochum.de die in dem Verzeichnis http://pc132w.bsnw.fb4.fh-bochum.de/eikelberg/javakurs/download/eclipseuml2.1.0 zu findenden Dateien herunter und speichern Sie diese in ein in einem Verzeichnis Ihres Rechners. Sie sollten folgende Dateien heruntergeladen haben: $install-eclipseuml.bat eclipseuml_e320_freeedition_2.1.0.20061006.jar download_free_eclipse_3x.pdf url.txt Die letzten beiden Dateien enthalten Informationen, von welcher Web-Seite die Datei eclipseuml_e320_freeedition_2.1.0.20061006.jar ursprünglich heruntergeladen wurde. Die jar-datei enthält die Software eclipseuml der Firma Omondo. 2. Installation von eclipseuml Öffnen Sie die Datei $install-eclipseuml.bat und tragen Sie in der Zeile mit dem Aufruf von java.exe einen geeigneten Pfad zu einer virtuellen Maschine (z. Bsp. aus dem JDK 1.4.2, das mit diesen Kursunterlagen verteilt wird) ein. Führen Sie die Datei $install-eclipseuml.bat aus. Es startet das Installationsprogramm von eclipseuml. Der Installationsvorgang erfolgt aufgrund der folgenden Anweisung in der Datei $install-eclipseuml.bat: D:\jdk1.4.2\bin\javaw -classpath.;eclipseuml_e320_freeedition_2.1.0.20061006.jar com.izforge.izpack.installer.installer Wählen Sie eine Sprache aus. Für die Kursunterlagen wurde die englische Sprache ausgewählt passend dazu, dass die bereitgestellte eclipse-version ebenfalls englisch beschriftet ist. Folgen Sie dem Assistenten zur Installation von Eclipse UML Free Edition. Akzeptieren Sie die Lizenzvereinbarung. Da Eclipse UML Free installiert wird, gibt es keine Lizenzgebühren. Geben Sie das Installationsverzeichnis Ihrer Eclipse-Installation an und führen Sie die Installation durch. Beachten Sie dabei, dass Sie das Verzeichnis angeben müssen, in der die Datei eclipse.exe gespeichert ist. Dieses Verzeichnis lautet für die vom Autor verteilte eclipse-installation wie folgt: D:\eclipse-SDK-3.2.1-win32_JDK1.4.2_Callisto\eclipse Im Unterverzeichnis Uninstaller Ihrer eclipse-installation wurde vor Abschluss der Installation ein Programm uninstaller.jar angelegt. Der Deinstallationsvorgang kann bei Bedarf wie folgt angestoßen werden: d:\jdk1.4.2\bin\javaw.exe -cp.;eclipseuml-unistaller.jar com.izforge.izpack.uninstaller.uninstaller Hinweis: Bei der Durchführung des obigen Ablaufs kann es zu Problemen kommen, wenn Sonderzeichen (z. Bsp. das Ausrufezeichen) in einem Verzeichnisnamen auftreten. 3. Anlegen eines Klassendiagramms mit eclipseuml Der folgende Ablauf beschreibt beispielhaft das Anlegen eines Klassendiagramms mit eclipseuml Starten Sie eclipse und legen Sie in einem Java-Basisverzeichnis (z. Bsp. jpr02110) ein neues Projekt an. Legen Sie in dem neuen Projekt ein Paket (z. Bsp. bsp02110) an. Wählen Sie im Kontextmenü für das Paket die Auswahl Open UML / Class diagram editor Stellen Sie für den Klassendiagramm-Editor folgende Optionen ein "Wire automation" - automatisches Erzeugen von Verbindungen: Association - Erzeugen von Symbolen für Assoziationen (nur für einen Datenbankentwurf notwendig) Inheritance - Erzeugen von Symbolen für Vererbung (stets einstellen) Dependency - Anzeigen der Abhängigkeiten zwischen den Klassen (stets einstellen) "Scope options" - Festlegen der logischen Grenzen des Diagramms: Scope "project" - Anzeigen der projektweiten Bezüge Level - einen geeigneten Wert, bis zu welcher Tiefe die Bezüge angezeigt werden sollen (z. Bsp. 5) Im Package Explorer von eclipse wird daraufhin ein leeres Klassendiagramm (bsp02110-id.ucd) angezeigt:
Öffnen Sie mit einem Rechtsklick das Kontextmenü des leeren Klassendiagramms und wählen Sie New / Class, um eine neue Klasse anzulegen. Vergeben Sie einen passenden Klassennamen (MyClass1). Daraufhin wird im Klassendiagramm eine neue Klasse angezeigt. Nach Markieren dieser Klasse kann diese über das Kontextmenü konfiguriert werden, z. Bsp. durch Einfügen von Variablen und Methoden. Synchron wird passend zu der Klasse im UML Klassendiagramm eine Java-Quelldatei angelegt, die im Editor der Java-Perspektive angezeigt werden kann:
Änderungen im Quellcode der Klasse werden ebenfalls synchron im Klassendiagramm mitgeführt:
Klassen, die ohne Verwendung von eclipseuml direkt mit der Auswahl File / New / Class im Eclipse-Menü erzeugt wurden, werden nicht automatisch in das Klassendiagramm eingefügt. Vielmehr muss dies wie folgt manuell angestoßen werden: Markieren Sie die noch nicht im Diagramm enthaltene java-klasse im Package Explorer und ziehen Sie diese Klasse mit drag and drop in das Klassendiagramm.