< Zurück | Weiter >

Lerneinheit 3: EGL-Service-Client erstellen

Der nächste Schritt ist die Erstellung eines Clientprojekts für die Verwendung des Service. Obwohl sich der Client, den Sie in diesem Lernprogramm erstellen, im selben Arbeitsbereich befindet, können Sie sich ihn so vorstellen, als ob er sich an einem völlig anderen Ort oder auf einer anderen Plattform befindet. Da Services und Clients nicht in derselben Sprache codiert sein müssen, können Sie sich auch vorstellen, dass diese Clientanwendung in einer anderen Sprache geschrieben oder mit einer vollkommen anderen Gruppe von Tools erstellt worden sein kann.

So geht's

  1. Klicken Sie auf Datei > Neu > Projekt.
  2. Erweitern Sie EGL, und klicken Sie auf EGL-Projekt.
  3. Klicken Sie auf Weiter.
  4. Nennen Sie das neue EGL-Projekt EGLClient.
  5. Klicken Sie auf Webprojekt.
  6. Klicken Sie auf Weiter.
  7. Stellen Sie sicher, dass die Option Neuen Erstellungsdeskriptor erstellen ausgewählt ist. Sie müssen die erweiterten Einstellungen nur ändern, falls Sie WAS einsetzen und vorher die Einstellungen geändert haben, mit denen das Hinzufügen des Projekts zu einer EAR inaktiviert wird.
  8. Möglicherweise werden Sie in einem Fenster gefragt, ob Sie zur J2EE-Perspektive wechseln möchten. Falls dieses Fenster angezeigt wird, klicken Sie auf Nein.

Client-Web-Seite erstellen

Zur Verwendung des Service erstellen Sie eine Webseite im Client, um die Eingabe abzurufen, diese Eingabe dem Service zu übergeben und die Ausgabe des Service anzuzeigen. Sie beginnen, indem Sie einen JSF-Handler erstellen. Ein JSF-Handler ist ein logischer EGL-Abschnitt, der eine Webseite steuert. Anschließend erstellt EGL eine Webseite, die mit diesem JSF-Handler arbeitet.
  1. Klicken Sie in der Sicht 'Projektexplorer' auf das Projekt EGLClient, um es auszuwählen.
  2. Klicken Sie auf Datei > Neu > Andere.
  3. Erweitern Sie EGL, und klicken Sie auf JSF-Handler.
  4. Klicken Sie auf Weiter.
  5. Prüfen Sie im Fenster JSF-Handler, ob das Feld Quellenordner auf den Ordner EGLSource des Projekts gesetzt ist:
    EGLClient\EGLSource
  6. Geben Sie in das Feld Paket den folgenden Namen ein:
    jsfhandlers
  7. Geben Sie in das Feld Name der EGL-Quellendatei den folgenden Namen ein:
    ClientPage
    Das Fenster sollte nun wie folgt aussehen>
    Fenster 'Neuer EGL-JSF-Handler'
  8. Klicken Sie auf Fertig stellen. Der neue JSF-Handler wird im Editor geöffnet.

    Speichern Sie die Datei erst, wenn Sie über diese Anweisungen dazu aufgefordert werden. Wenn Sie einen JSF-Handler speichern, prüft EGL, ob die Webseite, die in der Eigenschaft view angegeben ist, vorhanden ist. Wenn nicht, erstellt EGL die Datei und fügt automatisch Felder hinzu. Dabei werden als Grundlage Variablen im JSF-Handler und in der jeweiligen Eigenschaft DisplayUse dieser Variablen herangezogen. Wenn Sie die Datei speichern, bevor Sie alle Variablen hinzugefügt haben, schließt die Webseite nicht alle Variablen mit ein. Wenn diese Situation eintritt, können Sie die JSP-Datei löschen (nicht die JSF-Handler-Datei) und den JSF-Handler zum Abruf einer neuen Seite neu generieren.

  9. Entfernen Sie den Mustercode aus dem neuen JSF-Handler, so dass nur Folgendes übrig bleibt:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. Setzen Sie den Wert für die Eigenschaft view auf ClientPage.jsp (siehe folgendes Beispiel):
    {view = "ClientPage.jsp"}
  11. Erstellen Sie innerhalb des JSP-Handlers die folgenden Variablen:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. Fügen Sie unterhalb der Variablen die folgende Funktion hinzu:
    function getHello()
    
    end
    Später werden Sie dieser Funktion Code hinzufügen. Der JSF-Handler sollte nun wie folgt aussehen:
    Code im JSF-Handler
  13. Speichern Sie die Datei. Wenn Sie die Datei speichern, erstellt EGL automatisch aus der Datei eine Webseite. Diese Datei wird mit dem Wert der Eigenschaft view, ClientPage.jsp, benannt, und die Datei wird in den Ordner WebContent Ihres Projekts gestellt.
    Wenn Sie keine JSP-Datei abrufen konnten, ist EGL nicht zur automatischen Generierung von JSP-Handler-Abschnitten konfiguriert. Sie können JSF-Handler manuell generieren, indem Sie entweder in der Sicht 'Projektexplorer' oder im EGL-Editor mit der rechten Maustaste klicken und anschließend auf Generieren klicken. Führen Sie anschließend die folgenden zusätzlichen Schritte zur Einrichtung der automatischen Generierung von JSF-Handlern aus:
    1. Klicken Sie auf die Optionen Fenster > Benutzervorgaben.
    2. Erweitern Sie im Fenster 'Benutzervorgaben' EGL, und klicken Sie anschließend auf Generierung.
    3. Wählen Sie auf der Seite Generierung das Kontrollkästchen Handler aus.
    4. Klicken Sie auf OK.

    Nun werden JSF-Handler automatisch generiert, sobald Sie sie speichern.

  14. Öffnen Sie die Datei ClientPage.jsp im Editor. Diese Seite weist Felder auf, die auf den Variablen basieren, die Sie im JSF-Handler erstellt haben. Dieser Felder sind bereits mit der Variablen verknüpft. Auf diese Weise werden die Variablen entsprechend geändert, sobald sich die Werte dieser Felder auf der Seite ändern. In ähnlicher Weise werden die Werte der Felder auf der Seite bei Änderung der Variablenwerte im JSF-Handler in Übereinstimmung gebracht.

    Diese Seite enthält darüber hinaus einige Felder für Fehlernachrichten. Dies bedeutet nicht, dass die Seite Fehler enthält. Diese Felder zeigen lediglich Fehler auf der Seite an, falls bei der Ausführung der Seite Fehler auftreten.

  15. Lokalisieren Sie die Sicht 'Seitendaten'. Falls Sie diese Sicht nicht finden, können Sie auf die Optionen Fenster > Sicht anzeigen > Seitendaten klicken. Diese Sicht enthält die Daten, die auf der Seite verfügbar sind, einschließlich der Variablen, die Sie im JSF-Handler erstellt haben. Außerdem enthält sie Funktionen im JSF-Handler.
  16. Erweitern Sie in der Sicht 'Seitendaten' die Optionen JSF-Handler > Aktionen, und suchen Sie die Funktion getHello().
  17. Ziehen Sie die Funktion getHello() aus der Sicht 'Seitendaten' direkt auf den unteren Teil der Seite. Auf der Seite wird eine Schaltfläche angezeigt, die mit der Funktion verknüpft ist. Wenn der Benutzer zur Laufzeit die Schaltfläche auf der Seite auswählt, wird die Funktion im JSF-Handler ausgeführt.
  18. Speichern Sie die Seite.
Die Seite sollte nun wie folgt aussehen:
Aussehen der Client-Web-Seite

Nun haben Sie eine Webseite zur Verwendung des Web-Service fertig gestellt. In der nächsten Lerneinheit werden Sie das Projekt so einrichten, dass es über diese Webseite als Client für den Service fungiert.

< Zurück | Weiter >