Tutorial

Willkommen bei unserem Tutorial!

Auf der rechten Seite im Menü sind die einzelnen Schritte des Tutorials aufgeführt. Du kannst seriell lesen oder hin und her springen, wie es dir gefällt.

Vorbereitungen

Bitte entpacke das RAR-Archiv in ein Verzeichnis deiner Wahl. Die Dateien befinden sich unter dem Directory "D1-2.0.0" (je nach Version).

Zum Übersetzen der Java-Dateien benutzen wir das Build-System Gradle. Wenn es sich noch nicht auf deinem System befindet, lade es von der Gradle-Webseite herunter und installiere es.

Um die Beispiele zu verändern, installiere die JAVA™-IDE Eclipse. Die Eclipse-Homepage findest du hier.

Übersetzen der Beispiele und Download der benötigten Bibliotheken

Die Übersetzung mit Gradle ist recht einfach. Erzeuge eine Kommandozeilen-Shell und gehe in das Projektverzeichnis "D1-2.0.0/D1". Starte nun Gradle im "Continuous Build"-Modus mit gradle -t jar. Gradle wird die benötigten Dritt-Bibliotheken herunterladen und den Beispielcode übersetzen. Die Bibliotheken landen im Verzeichnis "D1-2.0.0/D1/lib", die PlugIn-JARs im Verzeichnis "D1-2.0.0/D1/plugins".

Nun kannst du einen oder mehrere NODEs starten. Wir haben 6 NODEs vorbereitet, die auf demselben Computer ausgeführt werden können. Wir verwenden für jeden NODE einfach unterschiedliche Ports. Gehe in das Verzeichnis node001 und siehe dir die Batchdatei start.cmd an. Du kannst den NODE damit einfach starten.

Der erste NODE (001) lädt noch ein paar PlugIns für ein User-Interface, den Monitor. Dieser dient zur Anzeige von LOG-Dateien und Message-Sequenzen (nicht nur der des lokalen NODEs). Zusätzlich lädt er das erste Beispiel-PlugIn.

Die NODEs 2-6 machen nichts besonderes. Sie starten ohne User-Interface. NODE 2 lädt noch zusätzlich das zweite Beispiele-PlugIn.

Starten aus Eclipse heraus

Starte Eclipse und wähle als Workbench-Verzeichnis das "D1-2.0.0"-Verzeichnis. Unter File/Import kannst du die Projekte der Beispiele laden. Im Dialog wähle "Existing Projects into Workspace".

Als "root directory" wählst du das "D1-2.0.0"-Verzeichnis. Wähle alle angezeigten Projekte aus und bestätige.

Die Projekte "D1ExamplesXXX" sind die Beispiel-Projekte. Sie werden zu PlugIns übersetzt und im NODE 001 bzw. 002 geladen.

Du kannst die Nodes im Menu starten: Run/Run Configurations.... Es ist problemlos möglich, mehrere NODEs gleichzeitig zu debuggen. Wenn du Gradle im "Continuous Build"-Modus gestartet hast, wird es dir bei jedem Speichern deiner Änderungen sofort die JAR-Dateien erstellen. Du kannst also nach dem Speichern deine Änderungen sofort ausprobieren.

Das PDF im D1-Verzeichnis zeigt dir eine Übersicht der 6 NODEs an:

Du kannst weitere NODEs anlegen (zum Beispiel durch Kopieren des node006-Verzeichnisses). Anschließend musst du die Konfiguration des neuen NODE anpassen, insbesondere die NODEID (die müssen alle unterschiedlich sein) und die TCP-Links.

Viel Spaß beim Spielen!