< Vorherige Lektion | Nächste Lektion >

Lerneinheit 2.1: Den Web-Service installieren und implementieren

In dieser Übung installieren Sie eine Beispiel-Unternehmensanwendungsdatei (EAR-Datei) auf WebSphere Application Server v6.1 und implementieren den Web-Service 'EmployeeDirectory'. Die Anwendung verwendet diesen Web-Service zum Erstellen, Lesen, Aktualisieren und Löschen von Mitarbeiterdatensätzen.

Bevor Sie beginnen, müssen Sie eine der folgenden Aufgaben ausführen, um sicherzustellen, dass sich das Projekt 'MyDirectory' am richtigen Ausgangspunkt befindet:
Das Java-Projekt 'MyDirectory' enthält eine Datei namens 'EmployeeDirectory.ear'. Sie verwenden die WebSphere-Administrationskonsole zum Installieren der Unternehmensanwendung 'EmployeeDirectory', die in der EAR-Datei enthalten ist. Wenn Sie die Anwendung installieren, implementieren Sie auch den in der Anwendung enthaltenen Web-Service. Die fertige Anwendung 'My Company Directory' verwendet diesen implementierten Web-Service.

Gehen Sie folgendermaßen vor, um die Beispielanwendung 'EmployeeDirectory' zu installieren und den Web-Service in ihrer WebSphere Application Server v6.1-Umgebung zu implementieren:

  1. Starten Sie ein Exemplar Ihres Anwendungsservers von der Workbench aus. Der Server kann auf verschiedene Arten gestartet werden. Die folgenden Schritte beschreiben das Starten von der Workbench:
    1. Öffnen Sie die Sicht 'Server'. Klicken Sie zum Hinzufügen der Sicht 'Server' zur Java-Perspektive auf Fenster > Sicht anzeigen > Andere und wählen Sie Server > Server aus.
    2. Die Sicht 'Server' führt die Server auf, die installiert und konfiguriert sind.
    3. Klicken Sie mit der rechten Maustaste auf Ihren Server, und wählen Sie Starten aus. Wenn in der Sicht 'Server' als Serverstatus Gestartet angezeigt wird, oder wenn in der Konsole der Hinweis Server 'server1' ist für e-business bereit angezeigt wird, wurde der Server erfolgreich gestartet. Sie können die Administrationskonsole nun ausführen.
    Anmerkung: Wenn in der Sicht 'Server' keine Serverinstanz vorhanden ist, müssen Sie einen neuen Server erstellen:
    1. Klicken Sie mit der rechten Maustaste auf die Sicht 'Server', und wählen Sie Neu > Server aus.
    2. Verwenden Sie den Assistenten 'Neuer Server', um WebSphere Application Server v6.1 hinzuzufügen.
  2. Führen Sie die WebSphere-Verwaltungskonsole aus. Auch hier stehen andere Möglichkeiten zum Ausführen der Verwaltungskonsole zur Verfügung. Die vorliegenden Anweisungen beschreiben jedoch das Ausführen von der Workbench:
    1. Klicken Sie in der Sicht 'Server' mit der rechten Maustaste auf den soeben gestarteten Server, und wählen Sie Administrationskonsole ausführen aus. Die WebSphere-Administrationskonsole wird daraufhin in einem Browserfenster geöffnet.
    2. Geben Sie eine Benutzer-ID ein, und klicken Sie auf Anmelden. Die Seite 'Willkommen' der Administrationskonsole wird geöffnet. Die von Ihnen eingegebene Benutzer-ID wird nur verwendet, um benutzerspezifische Änderungen an den Konfigurationsdaten des Servers zu protokollieren.
  3. Verwenden Sie die Administrationskonsole zum Installieren der Unternehmensanwendung 'EmployeeDirectory.ear', die sich im Projekt 'MyDirectory' befindet. In der Administrationskonsole wird eine Assistentenlösung verwendet, um Ihnen das Installieren von Anwendungen zu erleichtern. Bei diesem Assistenten klicken Sie auf Weiter, um von einer Seite zur nächsten zu gelangen, bis alle Optionen festgelegt sind. Gehen Sie wie folgt vor, um die Beispielunternehmensanwendung zu installieren, die den Web-Service für dieses Lernprogramm enthält:
    1. Erweitern Sie auf der linken Seite der Administrationskonsole die Option Anwendungsmenü, und klicken Sie anschließend auf Neue Anwendung installieren.
    2. Wählen Sie Lokales Dateisystem aus, und geben Sie im Feld Pfad angeben den vollständigen Pfad zur Datei EmployeeDirectory.ear ein, die sich in Ihrem Projekt 'MyDirectory' befindet. Tipp: Sie können den vollständigen Pfad abrufen, indem Sie mit der rechten Maustaste auf die Datei EmployeeDirectory.ear im Paketexplorer klicken, und die Option Eigenschaften auswählen. Auf der Seite 'Eigenschaften' wird die Position der Datei aufgelistet. Sie können diese Position kopieren und in das Feld Pfad angeben einfügen.
    3. Klicken Sie auf Weiter, bis Sie auf die Seite Installationsoptionen auswählen gelangen.
    4. Wählen Sie Web-Services implementieren aus.
    5. Klicken Sie auf Weiter, bis Sie auf die Seite Zusammenfassung gelangen, und klicken Sie anschließend auf Fertig stellen.
    6. Klicken Sie auf den Link In Masterkonfiguration speichern, wenn Sie aufgefordert werden, die von Ihnen vorgenommenen Änderungen auf die lokale Konfiguration anzuwenden. Überprüfen Sie die Änderungen, und klicken Sie auf die Schaltfläche Speichern.
  4. Verwenden Sie die Administrationskonsole, um die Anwendung 'EmployeeDirectory' zu starten:
    1. Klicken Sie auf Anwendungen > Unternehmensanwendungen. Die Anwendung 'EmployeeDirectory' wird als installierte Anwendung auf dem Server aufgelistet, ihr Status ist jedoch 'Gestoppt'.

      Unternehmensanwendungen in Administrationskonsole

    2. Wählen Sie das Markierungsfeld neben 'EmployeeDirectory' aus, und klicken Sie auf Starten. Eine Nachricht weist darauf hin, dass die Anwendung 'EmployeeDirectory' erfolgreich gestartet wurde, und das Symbol für den Status ändert sich in einen grünen Pfeil.

Die Anwendung 'EmployeeDirectory' wird auf dem lokalen Host bei Port 9080 ausgeführt, und der Zugriff auf den Web-Service ist nun möglich. Nach dem Beenden dieses Lernprogramms können Sie zur Administrationskonsole zurückkehren, die Anwendung 'EmployeeDirectory' stoppen und sie deinstallieren.

Wenn Sie die Datei 'EmployeeDirectory.wsdl' öffnen, die sich im Projekt 'MyDirectory' befindet (sie wird standardmäßig im grafischen WSDL-Editor geöffnet), können Sie den soeben implementierten Web-Service überprüfen. Wenn die WSDL-Datei nicht im WSDL-Editor geöffnet wird, ist die Web Service Developer-Funktionalität in der Workbench möglicherweise nicht aktiviert. Workbench-Funktionalitäten können Sie in den Benutzervorgaben angeben (Fenster > Benutzervorgaben > Workbench > Funktionalitäten).

In der folgenden Grafik aus dem WSDL-Editor werden die Operationen angezeigt, die im EmployeeDirectory-Service verfügbar sind:

Screenshot des Abschnitts 'Porttypen' des WSDL-Editors

Sie können den WSDL-Editor verwenden, um die einzelnen Operationen und deren zugehörige Anforderungs- und Antwortnachrichten zu überprüfen. Dies kann Ihnen dabei helfen, den Web-Service und seine Verwendung in den verbleibenden Übungen besser zu verstehen.

< Vorherige Lektion | Nächste Lektion >