Kurzanleitung JAMS-Entwicklung

Aus ILMS-Wiki
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Einleitung

Die folgende Anleitung beschreibt die Einrichtung einer JAMS/J2000-Entwicklungsumgebung mit Tortoise (SVN-Client) und NetBeans (Java-IDE). Selbstverständlich kann auch alternative Software eingesetzt werden.

Diese Anleitung ist gedacht für Anwender, die JAMS erweitern neue Komponenten entwickeln oder einfach nur wissen wollen, was genau in JAMS und/oder den Prozesskomponenten passiert. Weiterhin kann das Aufsetzen der Entwicklungsumgebung dabei helfen, Fehlerquellen aufzufinden und zu beheben.

Installation der benötigter Software

  1. Tortoise SVN (http://tortoisesvn.tigris.org/)
  2. NetBeans/Java (http://java.sun.com/javase/downloads/netbeans.html)

Einrichten der SVN-Repositories

Hierfür wird ein gültiger SVN-Account benötigt.

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

Beispiel J2000

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

Diese Schritte werden für alle weiteren aufzusetzenden Projekte (z.B. J2000g und JAMSComponents) entsprechend wiederholt. Unterschiede gibt es jeweils im Umfang der benötigten Bibliotheken (J2000g benötigt z.B. auch J2000). In alle JAMS-Projekte muss generell wie bei J2000 das Projekt JAMS (oder die Bibliothek JAMS.jar, z.B. aus dem Verzeichnis c:\nbprojects\JAMS\dist) eingebunden werden. Weitere Bibliotheken, welche von JAMSComponents benötigt werden, befinden sich im lib-Verzeichnis des JAMS-Repositories (z.B. c:\jams\lib).

Achtung:

In JAMSComponents befindet sich auch eine 3D-Visualisierungkomponente (MapCreator3D und zugehörige Klasse Styled3DMapPane), welche plattformabhängige Bibliotheken benötigt, die sich nicht im o.g. lib-Verzeichnis befinden. Um diese Komponente übersetzen und nutzen zu können, muss zuvor Java3D für die entsprechende Plattform installiert werden. Eine Installationsdatei für Windows befindet sich im Rootverzeichnis des JAMS-Repositories (z.B. c:\jams) und heisst java3d-1_5_0-windows-i586.exe. Andere Versionen können unter http://java.sun.com/javase/technologies/desktop/java3d heruntergeladen werden.

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/J2000 ausführen

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 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. Über File -> Load Model Configuration kann nun eine Modelldefinitionsdatei geladen werden.

Für die Ausführung der meisten Modelle ist darüber hinaus die Bereitstellung zusätzlicher Bibliotheken notwendig (z.B. J2000.jar und JAMSComponents.jar). Über Edit -> Edit Options können dazu weitere Bibliotheken angegeben werden, die dem Modell dann bei der Ausführung zur Verfügung stehen. Nach Beendigung des JAMS-Launchers werden die vorgenommenen Einstellungen in der Systemkonfigurationsdatei gespeichert.

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“