> Inhalt: JavaScout-Fat-Client-Framework (JS-FCF) 

Tutorial: Programmierung mit dem JS-FCF 

Tutorial:
JavaScout ProjectAssist, Start-Frame Grundlagen (Java_Fatclient_01) –
Einrichten von Project und Integrieren von Java-Bibliotheken

* Bitte beachten Sie die Hinweise und Bestimmungen bezüglich Urheberrecht, Haftungsausschluß und geschützte Marken oder Warenzeichen die für dieses Web-Dokument und möglicherweise auch für 'verlinkte' Dokumente gelten.

  • Der Betreiber dieser Web-Site (www.javascout.biz) ist nicht verantwortlich für den Inhalt von Web-Sites, die innerhalb dieses Web-Dokumentes oder anderer Dokumente von www.javascout.biz verlinkt sind.

  • Wenn dieses Web-Dokument oder andere Dokumente dieser Web-Site (www.javascout.biz) Rechte von Ihnen verletzen, oder sie glauben, daß Rechte Anderer (Dritter Personen) dadurch verletzt werden, informieren Sie bitte den Betreiber dieser Web-Site.
    Eine E-Mail können Sie ganz einfach durch anklicken des Symbols oder Textes im Frame rechts oben senden.

Dieses Dokument drucken.

 Letzte Bearbeitung dieses  Dokuments:
2009-09-09

Voraussetzungen für das Verständnis dieses Dokuments:

Grundkenntnisse in der Programmierung von Java (Klassen, Methoden, Schleifen) oder anderer Objekt-Orientierter Programmiersprachen (z.B. C++, Modula-2, Pascal).

Tutorial Datenbank-Ladeprogramm mit Graphischer Benutzeroberfläche (Java_Intro_02) durchgearbeitet.

Ungefährer Zeitbedarf zum Durcharbeiten dieses Dokuments:

Arbeitszeit:
Ca. 20 bis 60 Minuten; abhängig von der bei den vorigen Beispielen
erworbenen Routine.

Dieses Dokument enthält die Anleitung für die Einrichtung eines Project wie bereits in den vorausgesetzten Tutorial geübt.
Die Einrichtung des Project wird noch einmal komplett mit allen Screenshots dokumentiert.

Neu gegenüber einfacheren Tutorials ist, dass mehrere Java-Bibliotheken aus dem Internet heruntergeladen und in den 'Build Path' des Project aufgenommen werden.

Inhaltsverzeichnis:

Vorbemerkung 
Vorbedingungen 
Eclipse Workspace und Project eröffnen 
* Workspace eröffnen 
* Project eröffnen 
* Verzeichnisse für Quell-Code und kompilierte Java-Klassen festlegen 
* Standard-Source-Verzeichnis prüfen und bei Bedarf korrigieren 
* Herunterladen der notwendigen Java-Bibliotheken aus dem Internet 
* Einbindung der Libraries (Programm-Bibliotheken) in den Java Build Path 
Weitere Schritte und verwandte Dokumentation 

Nächster Schritt: Klasse für das StartFrame eröffnen 

Vorbemerkung

Obwohl Eclipse in 'deutscher Version' installiert werden kann, sind die Abbildungen in diesem Dokument mit der 'english Version' erstellt.
Grund ist, daß zum Zeitpunkt der Erstellung dieses Dokumentes (Oktober 2007) die Eclipse-Texte nur sehr unvollständig ins Deutsche übersetzt sind.
Damit ist (meiner Meinung nach)
1.) Eclipse in deutscher Version wesentlich schwerer verständlich als in englischer Version und
2.) wenn Eclipse weiter übersetzt wird, ist dieses Dokument stark abweichend von den dann vorhandenen deutschen Texten.

zum Inhaltsverzeichnis

Vorbedingungen:

zum Inhaltsverzeichnis

Eclipse Workspace und Project eröffnen

Kriterien für das Gruppieren von Projects in einen Workspace wurden in Tutorial: Hello World (Java_Intro_01) > Eclipse Workspace und Project eröffnen diskutiert.
Dort ist auch eine Beschreibung mit Screenshots enthalten wie ein Workspace eingerichtet wird – diese Anleitung wird in diesem Dokument nicht mehr wiederholt.

zum Inhaltsverzeichnis

Workspace eröffnen

Kurz nach dem Starten von Eclipse erscheint das abgebildete Fenster.
Darin kann ein bestehender Workspace ausgewählt oder – wie in diesem Beispiel – durch Eingabe des Workspace-Verzeichnis-Namens (
/home/kurti-o/java_fatclient im Beispiel) neu eröffnet werden.

Durch Klicken der Schaltfläche [ OK ] wird das Erstellen des neuen Workspace begonnen.

Für jeden neuen Workspace wird einmalig das abgebildete Fenster angezeigt.
Darauf kann ein Eclipse-Tutorial, eine Liste der Neuerungen der aktuellen Eclipse-Version oder ein Beispiels-Project ausgewählt werden.
Bei Interesse können Sie gerne eines oder mehrere Themen auswählen bevor Sie sich wieder diesem Dokument zuwenden.

Für das Fortsetzen dieses Tutorials klicken Sie bitte [Workbench] an.

zum Inhaltsverzeichnis

Project eröffnen

Um ein neues Project zu beginnen wird >File>New>Project... (unterer Eintrag) ausgewählt.


  

Im anschließenden Fenster (New Project) wird Java > Java Project ausgewählt und durch Klicken der Schaltfläche [ Next > ] fortgesetzt.

Im Fenster (New Java Project) wird

  • Der 'Project name' (Java_Fatclient_01) festgelegt.

  • Das verwendete 'JRE' (Java-Runtime-Environment) gewählt
    (Use default JRE belassen).

  • Das 'Project layout' festgelegt.
    (Create separate folders for sources and class files) wird gewählt weil es zweckmäßig ist, nur den Source-Code alleine in einem Verzeichnis zu haben und nicht auch noch pre-compiled Java-Klassen.

Durch Anklicken der Schaltfläche [Next > ] wird das nächste Fenster mit weiteren Einstellungsmöglichkeiten aufgerufen.

zum Inhaltsverzeichnis

Verzeichnisse für Quell-Code und kompilierte Java-Klassen festlegen

Im geänderten Fenster (New Java Project) wird

  • Zuerst der 'Default output folder' geändert (Java_Fatclient_01/gen/classes).

    Das Verzeichnis gen enthält dann alle Dateien, die generiert werden:
    neben dem Verzeichnis für die kompilierten Java-Klassen werden später auch noch Verzeichnisse für 'Steuer'-Dateien des Enterprise Java Beans festgelegt.

  • Durch anklicken des Textes Create new source folder ein weiteres Fenster (zum Festlegen eines Verzeichnisses für den Quell-Code der Java-Klassen) geöffnet.

Im erscheinenden Fenster (New Source Folder) wird

  • Der 'Folder Name' (im Beispiel auf src/java) festgelegt.

    Im Verzeichnis src/java werden dann von Eclipse die Java-Packages (als weitere Verzeichnisse) und Java-Klassen mit dem Quell-Code (als Dateien) angelegt wenn eine neue Java-Klasse (Class) eröffnet wird.

    Da vorher (automatisch)
    src als Verzeichnis für die Dateien mit dem Quell-Code definiert war, wird eine Nachricht angezeigt, daß dieses Verzeichnis nicht weiter verwendet wird.

Durch Anklicken der Schaltfläche [ Finish ] wird das neue Verzeichnis erstellt und das Fenster geschlossen.

Es wird auch noch eine Schaltfläche [ Next > ] als aktiv angezeigt.
Damit würden verfeinerte Definitionen ermöglicht, welche Dateien automatisch innerhalb des Verzeichnisses angelegt würden.
Diese Verfeinerung ist für dieses Tutorial aber nicht notwendig.

Im noch immer offenen Fenster (New Java Project) werden jetzt die neu erstellten Verzeichnisse angezeigt.

Durch Anklicken der Schaltfläche [ Finish ] wird das neue Project erstellt und das Fenster geschlossen.

zum Inhaltsverzeichnis

Standard-Source-Verzeichnis prüfen und bei Bedarf korrigieren

Die Meldung im vorigen Absatz ließe darauf schließen, daß das Standard-Source-Verzeichnis (Java_Fatclient_01/src) als Source-Verzeichnis gelöscht ist.
Bei meiner installierten Version von Eclipse (Version: 3.2.2., Build id: M20070212-1330) ist das wider Erwarten nicht der Fall.

Aus diesem Grund ist die folgende Beschreibung vorhanden.
Überprüfen Sie bitte die Definition der Source-Verzeichnisse bei Ihrer Installation und wenn der beschriebene 'Fehler' auch bei Ihnen aufgetreten ist, führen Sie die beschriebenen Korrektur durch.

Die definierten Source-Verzeichnisse sind unter 'Java Build Path' in den 'Properties' (Eigenschaften) des Projects definiert.

Um die Properties ansehen und ändern zu können, wird das Project mit der rechten Maustaste angeklickt, dann 'Properties' ausgewählt und mit der linken Maustaste angeklickt.

Im anschließend geöffneten Fenster wird im linken Teil Java Build Path ausgewählt und dann der Reiter Source angeklickt.

Unter den gelisteten Verzeichnissen wird vom Java-Compiler Quell-Code erwartet.
Mit anderen Worten: Quell-Code in anderen Verzeichnissen wird vom Java-Compiler nicht gefunden und damit auch nicht kompiliert.
Weiters wird das Verzeichnis für den Quell-Code bei der Eröffnung von Java-Klassen oder -Interfaces vorgeschlagen bzw. die Eingabe gegen hier definierte Verzeichnisse geprüft.

Um eine spätere irrtümliche Verwendung eines unerwünschten Verzeichnis zu vermeiden, ist es empfehlenswert hier nur ein Verzeichnis (nämlich Java_Fatclient_01/src/java) zu erlauben.

Sollte noch das ungewünschte Verzeichnis (Java_Fatclient_01/src) aufscheinen, so wird es mit der linken Maustaste markiert und dann die Schaltfläche [ Remove ] angeklickt.

Anschließend wird im Fenster nur mehr das gewünschte Verzeichnis angezeigt.

Durch Anklicken der Schaltfläche [ OK ] wird die neue Einstellung gesichert und das Fenster geschlossen.

zum Inhaltsverzeichnis

Herunterladen der notwendigen Java-Bibliotheken aus dem Internet.

Im Gegensatz zu einfacheren Tutorials, bei denen Java-Bibliotheken erst dann eingebunden wurden, wenn deren Klassen und Methoden gebraucht wurden, werden in diesem Tutorial alle notwendigen JAR-Dateien von Anfang an eingebunden.
Aus dem Internet werden folgende JAR-Dateien mit Java-Bibliotheken heruntergeladen:
*  Verbindung ('Connection') zum MySQL-Datenbanksystem.  
*  JavaScout-Basisklassen für die Entwicklung von Fat-Clients.  
*  Methoden zum Verarbeiten einer XML-Struktur entsprechend dem Document-Object-Model (DOM).  

Das Verzeichnis, auf dem die JAR-Dateien mit den Java-Bibliotheken gespeichert werden, ist abhängig von der Version Ihrer installierten Java-Laufzeitumgebung.
In diesem Dokument wird als Beispiel das Verzeichnis '/usr/java/jdk1.6.0_03/lib' verwendet.
Abhängig vom Zeitpunkt Ihrer Installation von Java wird dieses Verzeichnis differieren.
Ihre Benutzerrechte werden wahrscheinlich nicht ausreichen um Dateien im Verzeichnis '/usr/java/jdk1.6.0_03/lib' zu speichern.
Führen Sie deswegen das Herunterladen als 'root' aus bzw. speichern Sie die heruntergeladenen Dateien in einem Verzeichnis, für das Sie berechtigt sind, melden sich anschließend als 'root' an und kopieren die Dateien in das endgültige Verzeichnis.

Connection zum MySQL-Datenbanksystem
Das Herunterladen der Daten ist unter MySQL-Datenbank für die Verwendung mit Java-Programmen einrichten > Java-Archiv (JAR) Datei mit dem 'Connector' zu MySQL installieren beschrieben. 

JavaScout Basisklassen herunterladen
Die Datei mit den JavaScout-Basisklassen hat den Namen JSBS.jar und ist nicht komprimiert.
Speichern Sie diese Datei in einem Verzeichnis Ihrer Wahl.
Für die weitere Verwendung in diesem Tutorial wurde die Datei im Verzeichnis '/usr/java/jdk1.6.0_03/lib' gespeichert. 
Wenn Sie einen Fehler in den JavaScout Basisklassen vermuten und den Code debuggen wollen, verwenden Sie bitte die Datei JSBS_With_Source.jar.

Methoden zum Verarbeiten einer XML-Struktur

Alles ist in Bewegung – und das schneller als ich die Dokumentation ändern kann.
Ich verzichte bereits darauf, den genauen Link für den Download zu dokumentieren und beschränke mich auf die Übersichtsseite.
Möglicherweise ist aber auch der angegebene Link bereits nicht mehr gültig wenn Sie das Dokument lesen. In diesem Fall vertraue ich voll auf Ihre detektivischen Fähigkeiten, die aktuelle Datei für den Download zu finden ;-) .

Die aktuellste Version der JAR-Datei ist unter
http://www.jdom.org/dist/binary
zu finden
.

Klicken Sie auf 'jdom-1.1.tar.gz',
wählen Sie dann 'Öffnen mit Archivmanager (Standard)' und
Klicken Sie dann auf die Schaltfläche
[  OK  ].

Durch Doppelklicks auf ein Verzeichnis werden die darin enthaltenen Verzeichnisse und Dateien angezeigt.
Manövrieren Sie auf diese Weise in das Verzeichnis 'jdom-1.1/build' und markieren Sie die Datei 'jdom.jar'.

Durch Anklicken der Schaltfläche [  Entpacken  ] wird ein Fenster zur Auswahl des Ziel-Verzeichnisses geöffnet.
Manövrieren Sie zur 'lib'-Datei Ihrer installierten Java-Runtime ('/usr/java/jdk1.6.0_03/lib'
im nebenstehenden Beispiel) und speichern Sie die Datei durch Anklicken der Schaltfläche [  Entpacken  ].

zum Inhaltsverzeichnis

Einbindung der Libraries (Programm-Bibliotheken) in den Java Build Path

In diesem Project wird der Code (Klassen) in Programmteilen, die nicht innerhalb des Projects oder der Eclipse-Workspace vorhanden sind, eingebunden.

Für die Entwicklung mit dem JS-FCF (JavaScout-Fat-Client-Framework) sind folgende Java-Bibliotheken erforderlich:
JSBS.jar . . . Bibliothek mit den Basis-Klassen für das JS-FCF.
jdom.jar . . . Bibliothek mit den Klassen für das Lesen aus einer XML-Struktur.
mysql-connector-java-5.1.5-bin.jar . . . Bibliothek mit den Klassen für die Verbindung zum MySQL-Datenbanksystem.

Wenn das zu entwickelnde Programm eine Client-Server-Version mit einer Verbindung zu einem Java-Application-Server (JAS) ist, ist noch folgende Datei einzubinden:
/opt/jboss/client/jbossall-client.jar 

Die Dateien mysql-connector-java-5.1.5-bin.jar und /opt/jboss/client/jbossall-client.jar werden mit MySQL bzw. JBoss mitgeliefert.
Für dieses Tutorial wird angenommen, daß beide Programme installiert wurden.
Wenn Sie mit einem anderen Datenbanksystem bzw. einem anderen JAS arbeiten, brauchen Sie zum Testen des Programmes die entsprechenden Dateien Ihres verwendeten Datenbanksystems bzw. JAS.


Der Java Build Path ist in den 'Properties' (Eigenschaften) des Projects definiert.

Um die Properties ansehen und ändern zu können, wird das Project mit der rechten Maustaste angeklickt, dann 'Properties' ausgewählt und mit der linken Maustaste angeklickt.

Im anschließend geöffneten Fenster wird im linken Teil Java Build Path ausgewählt und dann der Reiter Libraries angeklickt.

Nach Anklicken der Schaltfläche [ Add External JARs... ] wird ein Fenster geöffnet, über das die einzubindende Datei ausgewählt werden kann.

Manövrieren Sie in das entsprechende Verzeichnis und wählen sie die einzubindende Datei aus.
Bestätigen Sie die Auswahl durch Anklicken der Schaltfläche
[  OK  ].

Wiederholen Sie das Einbinden für alle erforderlichen Dateien.

Die eingebundenen Bibliotheks-Dateien sollten wie in der nebenstehenden Abbildung gelistet sein.

Durch Anklicken der Schaltfläche [  OK  ] wird die Auswahl wirksam und das Fenster geschlossen.

zum Inhaltsverzeichnis

Weitere Schritte und verwandte Dokumentation

Dokument

Inhalt

Tutorial: JavaScout ProjectAssist (Java_Fatclient_01) – Klasse für das StartFrame eröffnen  

Im nächsten Schritt des Tutorials wird der Code für das Java-Programm mit Graphischer Benutzeroberfläche (GUI) vorgestellt.

zum Inhaltsverzeichnis