Kurzanleitung JAMS-Entwicklung

Version vom 27. Januar 2009, 13:50 Uhr

Einleitung

Diese Anleitung ist gedacht für Anwender, die

• neue Komponenten entwickeln wollen oder
• Probleme bei der Anwendung von JAMS haben oder
• einfach nur wissen wollen, was genau in JAMS und/oder den Prozesskomponenten passiert.

In letzterem Fall kann das Aufsetzen der Entwicklungsumgebung dabei helfen, Fehlerquellen aufzufinden und zu beheben.

Installation der benötigter Software

1. Tortoise SVN (http://tortoisesvn.tigris.org/)
2. NetBeans/Java (http://java.sun.com/javase/downloads/netbeans.html)

Einrichten der SVN-Repositories

1. Verzeichnis für JAMS-Core anlegen (z.B. c:\jams)
2. Verzeichnis für Modelle anlegen (z.B. c:\jamsmodels)
3. Verzeichnis für Daten anlegen (z.B. c:\jamsdata)
4. rechte Mousetaste auf c:\jams -> SVN Checkout und http://svn.geogr.uni-jena.de/svn/jams/trunk als URL des Repository’s angeben -> OK
5. rechte Mousetaste auf c:\jamsmodels -> SVN Checkout und http://svn.geogr.uni-jena.de/svn/jamsmodels/trunk als URL des Repositorys angeben -> OK
6. rechte Mousetaste auf c:\jamsdata -> SVN Checkout und http://svn.geogr.uni-jena.de/svn/modeldata als URL des Repositorys angeben -> OK

Projekte in NetBeans aufsetzen

Beispiel JAMS

1. File -> New Projekt -> Java Project with Existing Sources
2. Projektname (z.B. JAMS) und Verzeichnis (z.B. c:\nbprojects\JAMS) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next
3. Source Package Folder -> Add Folder -> c:\jams\JAMS\src -> OK
4. Import beenden
5. Bibliotheken einbinden: rechte Mousetaste auf Libraries -> Add JAR/Folder und hier jscience.jar und jts-x.x.jar aus c:\jams\lib hinzufügen ("x" durch aktuelle Versionsnummern ersetzen!)
6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMS.jar in c:\nbprojects\JAMS\dist\ erzeugen)

Diese Schritte werden für alle aufzusetzenden Projekte (z.B. J2K und JAMSComponents) entsprechend wiederholt. Unterschiede gibt es jeweils im Umfang der benötigten Bibliotheken. Für alles übrigen Projekte wird die oben erzeugte Bibliothek JAMS.jar (z.B. aus dem Verzeichnis c:\nbprojects\JAMS\dist) eingebunden. Weitere Bibliotheken, welche von StandardComponents benötigt werden, befinden sich im lib-Verzeichnis des JAMS-Repositories (z.B. c:\jams\lib).

Achtung:

In JAMSComponents befindet sich auch eine 3D-Visualisierungkomponente (MapCreator3D und zugehörige Klasse Styled3DMapPane), welche plattformabhängige Bibliotheken benötigt, die sich nicht im o.g. lib-Verzeichnis befinden. Um diese übersetzen und nutzen zu können, muss zuvor Java3D für die entsprechende Plattform installiert werden. Eine Installationsdatei für Windows befindet sich im Rootverzeichnis des JAMS-Repositories (z.B. c:\jams) und heisst java3d-1_5_0-windows-i586.exe. Andere Versionen können unter http://java.sun.com/javase/technologies/desktop/java3d heruntergeladen werden.

Template für JAMS-Komponenten

Ein Komponenten-Template für NetBeans ist im JAMS-Verzeichnis des JAMS-Repositories (z.B. c:\jams\JAMS\JAMSComponent.java) zu finden (ggf. vorher anpassen!). Die Einbindung in NetBeans erfolgt wie folgt:

1. Tools -> Template Manager -> Java Classes -> Add...
2. Add.. und oben genanannte Datei auswählen

Danach kann beim Anlegen einer neuen Klasse "JAMSComponent" als File Type ausgewählt werden.

JAMS/J2K ausführen

Für die JAMS-Ausführung wird dann wie folgt vorgegangen:

1. zur einfacheren Ausführung rechte Mousetaste auf JAMS -> Set Main Project
2. rechte Mousetaste auf JAMS -> Properties -> Run und
   • "Main Class" auf org.unijena.jams.JAMS setzen
   • Unter "Arguments" eingeben: -c <vollständiger Pfad einer Konfigurationsdatei> -m <vollständiger Pfad einer Modelldefinitionsdatei>. Beide Argumente sind optional und können auch über die grafische Oberfläche des JAMS-Launchers ausgewählt werden.
3. rechte Mousetaste auf JAMS -> Run Project oder einfach Taste F6

In der Standardkonfiguration sollte sich nun der JAMS-Launcher öffnen. Über File -> Load Model Configuration kann nun eine Modelldefinitionsdatei geladen werden.

Für die Ausführung der meisten Modelle ist darüber hinaus die Bereitstellung zusätzlicher Bibliotheken notwendig (z.B. J2K.jar und JAMSComponents.jar). Über Edit -> Edit Options können dazu weitere Bibliotheken angegeben werden, die dem Modell dann bei der Ausführung zur Verfügung stehen. Nach Beendigung des JAMS-Launchers werden die vorgenommenen Einstellungen in der Systemkonfigurationsdatei gespeichert.

Hinweis: Nach Modifikationen an Modellkomponenten muss vor der Ausführung immer erst das JAR-File mit den Komponenten neu erzeugt werden (jeweils Schritt 6 in "NetBeans-Projekte aufsetzen")!