Kurzanleitung JAMS-Entwicklung

Aus ILMS-Wiki
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

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\JAMS\libs hinzufügen
  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 StandardComponents) 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).

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\lib sowie JAMS.jar aus c:\jamsprojects\JAMS\dist 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")!

Von „https://jams.uni-jena.de/ilmswiki/de/index.php/Kurzanleitung_JAMS-Entwicklung“
Meine Werkzeuge