< Zurück | Weiter >

Lerneinheit 2: Projekte erstellen und Datenbank importieren

In dieser Lerneinheit erstellen Sie Projekte zur Aufnahme Ihrer EGL-Anwendung und fügen eine zu verwendende Datenbank hinzu.

In diesem Lernprogramm verbringen Sie die meiste Zeit damit, mit Dateien in einem EGL-Webprojekt zu arbeiten. Dieses Projekt enthält den EGL-Code, Webseiten und eine Musterdatenbank, die die Logik, die Schnittstelle und die Daten für die Anwendung bilden. Bevor Sie mit dem Erstellen von Projekten beginnen, müssen Sie aber festlegen, welchen Server Sie im Lernprogramm verwenden wollen.

Bei Auswahl von WebSphere Application Server benötigen Sie neben dem EGL-Webprojekt auch ein EAR-Projekt (Enterprise Application Resource - Unternehmensanwendungsressource). Das EAR-Projekt enthält Informationen zur Implementierung einer Anwendung in das J2EE-Framework sowie deren Ausführung auf einem Server und die Verbindung mit Datenquellen. Ein EAR-Projekt kann mindestens ein weiteres Projekt enthalten, d. h. dass das EAR-Projekt Informationen zur Implementierung dieser Projekte enthält. Die in einem EAR-Projekt enthaltenen Projekte werden Module genannt. In diesem Fall ist Ihr EGL-Webprojekt ein Modul innerhalb des EAR-Projekts. In einer großen Anwendung könnte ein EAR-Projekt viele verschiedene Typen von Modulen haben, die verschiedene Aufgaben erledigen.

Bei Auswahl von Apache Tomcat benötigen Sie allerdings kein EAR-Projekt, genau genommen können Sie auch kein EAR-Projekt verwenden. WebSphere Application Server ist ein mit vielen Funktionen ausgestatteter Anwendungsserver, der jeden Modultypen im J2EE-Framework, einschließlich Webprojekte (wie Ihr EGL-Webprojekt), EAR-Projekte und EJB-Projekte (Enterprise JavaBean), ausführen kann. Tomcat hingegen ist ein Web-Server, der für die Ausführung von Webprojekten entworfen wurde; Tomcat unterstützt keine anderen Typen von J2EE-Projekten, wie z. B. EAR-Projekte oder EJB-Projekte.

Die Lernprogrammanwendung wird ungeachtet des verwendeten Servers in derselben Weise ausgeführt, Sie sollten sich jedoch der Unterschiede zwischen den beiden Servern bewusst sein. Bei Verwendung von WebSphere Application Server erstellen Sie ein EAR-Projekt und platzieren die Datenbankverbindungsinformationen in diesem EAR-Projekt. Bei Verwendung von Tomcat platzieren Sie die Datenbankverbindungsinformationen direkt in dem EGL-Webprojekt.

Beachten Sie im verbleibenden Lernprogramm die unterschiedlichen Abschnitte, die für WebSphere Application Server bzw. für Apache Tomcat gelten. Wenn sich die Anweisungen auf Projekte, Dateien oder Optionen beziehen, über die Sie nicht verfügen, überprüfen Sie, ob der Abschnitt überhaupt für Ihren jeweiligen Server gilt.

Den Server (WebSphere Application Server) installieren

WebSphere Application Server erfordert in der Regel einen separaten Installationsprozess von Ihrem EGL-Produkt. Sie müssen WebSphere Application Server in der gleichen Paketgruppe installieren, die auch Ihr EGL-Produkt enthält. Wenn WebSphere Application Server in der Sicht Server angezeigt wird, standardmäßig im unteren Teil der Workbench, dann ist das Produkt installiert. Ist dies nicht der Fall, müssen Sie das Produkt erwerben, oder stattdessen Tomcat verwenden.
Das Produkt wird in der Sicht 'Server' angezeigt.

Den Server (Tomcat) installieren

Die Installation von Tomcat ist in der Regel unkompliziert und umfasst das Herunterladen und Dekomprimieren der Serverdateien. Im Anschluss hieran müssen Sie der Workbench mitteilen, wo sich die betreffenden Dateien befinden. Führen Sie diese Schritte aus, um Tomcat 6.0 zu installieren und zu konfigurieren:
  1. Klicken Sie in der Sicht Server, die standardmäßig im unteren Teil der Workbench angezeigt wird, mit der rechten Maustaste auf eine beliebige Stelle im freien Bereich und klicken Sie anschließend auf Neu > Server.
  2. Erweitern Sie im Fenster Neuen Server definieren den Eintrag 'IBM', falls erforderlich, und wählen Sie die Version von Tomcat aus, die auf Ihrem System installiert ist oder die EGL für Sie auf dem System installieren soll. Wenn Sie eine Version mit Debugunterstützung auswählen, können Sie Ihre Programme schrittweise im EGL-Debugger durchgehen.
    Der Tomcat-Server im Fenster Neuer Server.
  3. Im Fenster 'Tomcat-Server' steht eine Option zur Verfügung:
    • Wenn Tomcat bereits auf Ihrem System installiert ist, suchen Sie nach dem Tomcat-Installationsverzeichnis.
    • Ist Tomcat noch nicht installiert, klicken Sie auf Herunterladen und installieren und folgen den Anweisungen in der Anzeige. Wiederholen Sie diesen Schritt, nachdem Sie die Software installiert haben.
    Das Fenster 'Tomcat-Server'.
  4. Klicken Sie auf Fertig stellen. Der neue Server wird im Fenster Server angezeigt.
  5. Verlassen Sie die EGL-Workbench kurz und verwenden Sie Windows Explorer, um nach dem Ordner zu suchen, in dem Sie Tomcat installiert haben. Suchen Sie in diesem Ordner nach dem Ordner lib. Der Pfad kann z. B. wie folgt aussehen:
    D:\Program Files\Apache\lib
    Stellen Sie sicher, dass dieser Ordner eine Datei mit dem Namen derby.jar enthält. Ist dies nicht der Fall, kopieren Sie die Datei aus dem folgenden Ordner in Ihrem Installationsverzeichnis in den Ordner lib:
    installationverzeichnis\plugins\org.apache.derby.core_10.1.2.1

Das EGL-Webprojekt erstellen (beide Server)

Da Ihr Projekt eine Webseitenschnittstelle haben wird, müssen Sie ein EGL-Webprojekt erstellen. Ein EGL-Webprojekt kombiniert die Merkmale eines dynamischen Webprojekts und eines EGL-Projekts. Wenn Sie WebSphere Application Server verwenden, werden Sie außerdem ein EAR-Projekt erstellen.

  1. Klicken Sie auf das Symbol 'Neues EGL-Projekt' oben links in der Workbench.
    Das Symbol 'Neues EGL-Projekt'.
    EGL zeigt den Assistenten Neues EGL-Projekt an.
  2. Alternativ können Sie auf Datei > Neu > Weitere klicken; anschließend erweitern Sie im Dialogfenster 'Assistent auswählen' den Ordner EGL und klicken auf EGL-Projekt und dann auf Weiter.
    Der Dialog 'Assistent auswählen' zeigt den EGL-Ordner und das Symbol 'EGL-Projekt' darin an.
    EGL zeigt den Assistenten Neues EGL-Projekt an.
  3. Im Feld Projektname geben Sie diesen Namen für Ihr Projekt ein:
    EGLWeb
  4. Klicken Sie unter EGL-Projekttypen auf die Option Webprojekt. Klicken Sie auf Weiter.
    Der Assistent 'Neues EGL-Projekt' zeigt die verschiedenen Projekttypen an.
  5. Klicken Sie auf Weiter.
  6. Wählen Sie im Feld Ziellaufzeit den Namen des Anwendungsservers aus, den Sie am Anfang dieser Lerneinheit überprüft haben.
  7. Stellen Sie sicher, dass unter Optionen für Builddeskriptor die Option Neuen Erstellungsdeskriptor erstellen ausgewählt ist.
  8. Wählen Sie das Markierungsfeld Erweiterte Einstellungen anzeigen aus und klicken Sie auf Weiter.
  9. Lassen Sie das Markierungsfeld Standardposition für das Projekt verwenden ausgewählt.
  10. Wenn Sie WebSphere Application Server verwenden, muss das Markierungsfeld Projekt zu einem EAR hinzufügen ausgewählt werden und der Name EGLWebEAR muss für den EAR-Projektnamen angezeigt werden. Akzeptieren Sie beide dieser Standardwerte.
  11. Sie brauchen nichts im Abschnitt Projektfacetten ändern zu ändern.
  12. Deaktivieren Sie das Markierungsfeld EGL-Implementierungsdeskriptor erstellen. EGL-Implementierungsdeskriptordateien enthalten Informationen zum Implementieren und Verwenden von Web-Services. Dieses Lernprogramm stellt keine Verbindung zu Web-Services her.
    Bild des Fensters 'Neues EGL-Webprojekt', das WebSphere Application Server verwendet
  13. Klicken Sie auf Fertig stellen.
  14. Eventuell wird die Frage, ob Sie zur J2EE-Perspektive umschalten möchten, angezeigt. Wenn Sie diese Nachricht sehen, klicken Sie auf Nein.
Das neue Projekt wird bzw. die neuen Projekte werden in Ihrem Arbeitsbereich erstellt. In der Workbench kann das Fenster 'Technology Quickstarts' mit Hilfeinformationen angezeigt werden. Die können dieses Fenster schließen.

Die Datenbank importieren

Dieses Lernprogramm beinhaltet eine Derby-Beispieldatenbank zur Verwendung in Ihrer Anwendung. In diesen Schritten fügen Sie diese Datenbank zu Ihrem Projekt hinzu. Weitere Informationen über Apache Derby, eine relationale Open-Source-Datenbank, finden Sie unter http://db.apache.org/derby/.
  1. Klicken Sie auf den folgenden Link und laden Sie die Beispieldatenbank in einen temporären Ordner, z. B. den Desktop, auf Ihrem Computer herunter:

    Beispieldatenbank

    Es spielt keine Rolle, wo Sie die Datenbank speichern. Sie müssen sie später nur wiederfinden können.

    Alternativ finden Sie diese Beispieldatenbank in dem Installationsverzeichnis Ihres Produkts an der folgenden Position:
    gemeinsam_genutzte_ressourcen/plugins/com.ibm.etools.egl.tutorial0001.doc_version/
       resources/EGLDerbyDB.zip
    gemeinsam_genutzte_ressourcen
    Das Produktverzeichnis für gemeinsam genutzte Ressourcen, z. B. C:\Programme\IBM\SDP70Shared unter Windows oder /opt/IBM/SDP70Shared unter Linux. Wenn Sie vor der Installation des aktuellen Produkts eine frühere Version eines IBM® Produkts installiert und beibehalten haben, das EGL enthält, müssen Sie ggf. das bei der früheren Installation eingerichtete Verzeichnis für gemeinsam genutzte Ressourcen angeben.
    version
    Die installierte Version des Plug-ins. Falls mehrere Plug-ins vorhanden sind, verwenden Sie dasjenige mit der neuesten Versionsnummer, es sei denn, Sie benötigen eine ältere Version.
  2. In der Workbench klicken Sie auf Datei > Importieren.
  3. Im Fenster 'Importieren' erweitern Sie Allgemein, klicken auf Archivdatei und anschließend auf Weiter.
  4. Geben Sie im Fenster 'Archivdatei' Im Feld Aus Archivdatei die Position der Datei ein, die Sie gerade herunterladen haben. Sie können die Schaltfläche Durchsuchen verwenden, um sie zu suchen.
  5. Unten im Assistenten, neben dem Feld In Ordner klicken Sie auf die Schaltfläche Durchsuchen.
  6. Im Fenster In Ordner importieren erweitern Sie EGLWeb und klicken auf den Ordner WebContent, um diesen auszuwählen; klicken Sie anschließend auf OK. Dies ist der Ordner, in dem die Datenbank zu Ihrem Projekt hinzugefügt wird. Das Fenster 'Importieren' sieht wie folgt aus:
    Bild des Fensters 'Importieren'
  7. Klicken Sie auf Fertig stellen.
Die Datenbank wird Ihrem Arbeitsbereich im Ordner 'WebContent' des Projekts 'EGLWeb' hinzugefügt. Bearbeiten Sie keine der Dateien in der Datenbank direkt. Zu einem späteren Zeitpunkt werden Sie eine EGL-Anwendung zur Anzeige und Bearbeitung dieser Datenbank erstellen.

Prüfpunkt für die Lerneinheit

In dieser Lerneinheit haben Sie abhängig von Ihrem Server ein oder zwei Projekte erstellt. Sie können das Projekt bzw. die Projekte in der Sicht Projektexplorer durchsuchen:
  • Das Projekt 'EGLWeb' enthält den EGL-Code, Webseiten und andere, der Anwendung zugeordnete Dateien. Insbesondere werden Sie mit den Ordnern 'EGLSource' und 'WebContent' arbeiten, die die EGL-Quellcodedateien bzw. die Webseiten für die Anwendung enthalten.
  • Das Projekt 'EGLWebEAR' ist die Enterprise-Anwendungsressource für das Projekt 'EGLWeb'. Sie verfügen nur dann über dieses Projekt, wenn Sie WebSphere Application Server verwenden.

Die Sicht 'Enterprise Explorer' sieht wie folgt aus, wenn Sie WebSphere Application Server:

Bild der Sicht 'Enterprise Explorer' mit dem EGL-Webprojekt und dem EAR-Projekt

Die Sicht 'Enterprise Explorer' sieht wie folgt aus, wenn Sie Tomcat verwenden:

Die Sicht 'Enterprise Explorer' enthält das EGL-Webprojekt

< Zurück | Weiter >

Feedback