Kurzanleitung JAMS-Entwicklung

Installation der benötigter Software

1. Tortoise SVN (http://tortoisesvn.tigris.org/)
2. NetBeans/JDK5.0 (http://java.sun.com/j2se/1.5.0/download.jsp)

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:\modeldata)
4. rechte Mousetaste auf c:\jams -> SVN Checkout und svn://spree.geogr.uni-jena.de/jams/devel als URL des Repository’s angeben -> OK
5. rechte Mousetaste auf c:\jamsmodels -> SVN Checkout und svn://spree.geogr.uni-jena.de/jamsmodels/devel als URL des Repositorys angeben -> OK
6. rechte Mousetaste auf c:\modeldata -> SVN Checkout und svn://spree.geogr.uni-jena.de/modeldata als URL des Repositorys angeben -> OK

NetBeans-Projekte aufsetzen

JAMS

1. File -> New Projekt -> Java Project with Existing Sources
2. Projektname (z.B. JAMS) und Verzeichnis (z.B. c:\jamsprojects\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. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier jscience.jar und JTS-x.x.jar aus c:\jams\JAMS\libs hinzufügen
6. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JAMS.jar in c:\jamsprojects\JAMS\dist\ erzeugen)

JAMSComponents

1. File -> New Projekt -> Java Project with Existing Sources
2. Projektname (z.B. JAMSComponents) und Verzeichnis (z.B. c:\jamsprojects\JAMSComponents) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next
3. Source Package Folder -> Add Folder -> c:\jams\JAMSComponents\src -> OK
4. Import beenden
5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier alles aus c:\jams\JAMS\libs hinzufügen
6. rechte Mousetaste auf JAMSComponents -> Clean and Build Project (Projekt compilieren und JAMSComponents.jar in c:\jamsprojects\JAMSComponents\dist\ erzeugen)

J2K

1. File -> New Projekt -> Java Project with Existing Sources
2. Projektname (z.B. J2K) und Verzeichnis (z.B. c:\jamsprojects\J2K) vergeben (hier landen die compilierten Klassen und das JAR-File) -> Next
3. Source Package Folder -> Add Folder -> c:\jamsmodels\J2K\src -> OK
4. Import beenden
5. rechte Mousetaste auf Libraries -> Add JAR/Folder und hier JAMS.jar aus c:\jamsprojects\JAMS\dist hinzufügen
6. rechte Mousetaste auf J2K -> Clean and Build Project (Projekt compilieren und J2K.jar in c:\jamsprojects\J2K\dist\ erzeugen)

Template für JAMS-Komponenten

Bitte verwendet in NetBeans dieses Template, welches ihr folgendermaßen einbinden könnt:

1. Tools -> Template Manager -> Java Classes
2. rechte Mousetaste auf Java Class -> Copy
3. rechte Mousetaste auf Java Classes -> Paste -> Copy
4. Class_1.java auswählen und "Open in Editor", in die geöffnete Datei den Template-Code einfügen (den alten löschen), abspeichern und schließen
5. rechte Mousetaste auf Class_1.java -> Rename und z.B. nach "JAMSComponent" umbenennen

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"), eine Modellkonfigurationsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmc") und eine Modelldefinitionsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.jmd"). Detailinformationen über die Konfiguration des Systems mit diesen drei Dateien 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" die vollständigen Pfade einer Konfigurationsdatei und einer Modelldefinitionsdatei (in dieser Reihenfolge) angegeben. Die Modelldefinitionsdatei ist hierbei optional und kann 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")!