Kurzanleitung JAMS-Entwicklung
Inhaltsverzeichnis |
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 alles 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)
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
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 und eine Modelldefinitionsdatei (z.B. "c:\modeldata\JAMS-Gehlberg\j2k_gehlberg.xml"). Für die JAMS-Ausführung wird dann wie folgt vorgegangen:
1. Pfadangaben in der Konfigurations- und Modelldefinitionsdatei anpassen
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.
3. rechte Mousetaste auf JAMS -> Clean and Build Project (Projekt compilieren und JARs erzeugen)
4. rechte Mousetaste auf J2K -> Clean and Build Project (Projekt compilieren und JARs erzeugen)
5. rechte Mousetaste auf JAMS -> Run Project
6. sich freuen, falls nichts abstürzt :)
Hinweis: Nach Modifikationen an Modellkomponenten muss vor der Ausführung immer erst das JAR-File mit den Komponenten neu erzeugt werden (Schritt 3)!
