Kurzanleitung JAMS-Entwicklung

Installation der benötigter Software

1. Tortoise SVN (http://tortoisesvn.tigris.org/)
2. NetBeans/JDK5.0 (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://rhein.geogr.uni-jena.de/svn/jams/devel als URL des Repository’s angeben -> OK
5. rechte Mousetaste auf c:\jamsmodels -> SVN Checkout und http://rhein.geogr.uni-jena.de/svn/jamsmodels/devel als URL des Repositorys angeben -> OK
6. rechte Mousetaste auf c:\jamsdata -> SVN Checkout und http://rhein.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).

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

JAMS benötigt für die Ausführung eine Systemkonfigurationsdatei (z.B. "c:\jamsmodels\example.jap") und eine Modelldefinitionsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jam"). Detailinformationen über die verschiedenen JAMS-Ausführungsmodi sind hier zu finden. 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. Wurde zuvor bei den Argumenten die Modelldefinitionsdatei angegeben, so wird die Konfigurationsoberfläche für das Modell sofort geladen. Ansonsten kann das einfach über File -> Load Model Configuration passieren.

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")!