Kurzanleitung JAMS-Entwicklung

Version vom 22. September 2006, 11:30 Uhr

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) 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 JARs erzeugen)

J2K

1. File -> New Projekt -> Java Project with Existing Sources

2. Projektname (z.B. J2K) und Verzeichnis (z.B. c:\jamsprojects) 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 Konfigurationsdatei (z.B. "c:\jamsmodels\example.jap") 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)!