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 der NetBeans (Java-IDE). Selbstverständlich kann auch alternative Software eingesetzt werden.

Diese Anleitung ist gedacht für Anwender, die

  • neue Komponenten entwickeln wollen oder
  • Probleme bei der Anwendung von JAMS haben oder
  • einfach nur wissen wollen, was genau in JAMS und/oder den Prozesskomponenten passiert.

In letzterem Fall 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:\jamsdata)
  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. In alle JAMS-Projekte wird wie bei J2000 das Projekt JAMS (oder die 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).

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/J2K 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 org.unijena.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. J2K.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“