Web-Service aus einer Java-Bean unter Verwendung der Apache Axis-Laufzeitumgebung erstellen

Der Web-Service-Assistent unterstützt Sie dabei, einen neuen Web-Service zu erstellen, ihn für die Implementierung zu konfigurieren und den Web-Service auf einem Server zu implementieren. Wenn Ihr Web-Service implementiert ist, unterstützt Sie der Assistent bei der Generierung des Client-Proxys und der Musteranwendung, um Ihren Web-Service zu testen. Wenn Sie den Test abgeschlossen haben, können Sie Ihren Web-Service mit Hilfe des Exportassistenten in einer UDDI-Geschäftsregistry publizieren.

Voraussetzungen:
  1. Erstellen oder importieren Sie eine Bean in den Java-Quellenordner des Webprojekts.
Gehen Sie wie folgt vor, um einen Web-Service aus einer Bean mit Hilfe der Apache Axis-Laufzeitumgebung zu erstellen:
  1. Wechseln Sie zur J2EE-Perspektive (Fenster > Perspektive öffnen > J2EE).
  2. Wählen Sie in der Sicht 'Projektexplorer' die Bean aus, die Sie erstellt oder in den Quellenordner Ihres Webprojekts importiert haben.
  3. Klicken Sie auf Datei > Neu > Andere. Wählen Sie Web-Services aus, um die verschiedenen Web-Service-Assistenten anzuzeigen. Wählen Sie den Assistenten Web-Service aus. Klicken Sie auf Weiter.
  4. Seite 'Web-Services': Wählen Sie 'Bottom-up' 'Java-Bean für Web-Service' als Ihren Web-Servicetyp aus, und geben Sie die URI für die WSDL-, WSIL-, oder HTML-Datei an, die verwendet werden soll, um den Service zu generieren.
    1. Verwenden Sie den Schieberegler, um die Stufen der Web-Service-Entwicklung auszuwählen, die Sie durchführen möchten:
      • 'Entwickeln': Hier wird der Service-Code erzeugt
      • 'Assemblieren':
      • 'Implementieren': Hier wird der Implementierungscode für den Service erzeugt
      • 'Installieren': Hier wird der Service auf dem ausgewählten Server installiert
      • 'Starten': Der Server wird gestartet, sobald der Service auf ihm installiert wurde
      • 'Testen': Hier stehen verschiedene Optionen zum Testen des Service zur Verfügung
    2. Wählen Sie Ihren Server aus: der Standardserver wird angezeigt. Wenn Sie Ihren Service auf einem anderen Server implementieren möchten, klicken Sie auf den Link, um einen anderen Server anzugeben.
    3. Wählen Sie Ihre Laufzeit aus: die Standardlaufzeit wird angezeigt. Wenn Sie Ihren Service in einer anderen Laufzeit implementieren möchten, klicken Sie auf den Link, um eine andere Laufzeit anzugeben.
    4. Wählen Sie das Serviceprojekt aus: Das Projekt wird angezeigt, das das in Ihrem Arbeitsbereich ausgewählte Projekt enthält. Klicken Sie auf den Projektlink, um ein anderes Projekt und eine andere EAR auszuwählen. Stellen Sie sicher, dass das als Client-Webprojekt ausgewählte Projekt ein anderes ist, als das Service-Webprojekt, sonst wird der Service durch die generierten Artefakte des Clients überschrieben.
    5. Wenn Sie einen Client erstellen möchten, wählen Sie den zu generierenden Proxy-Typ aus, und wiederholen Sie die oben genannten Schritte für den Client.
    6. Web-Service publizieren: Hierdurch wird der Web-Services-Explorer gestartet, um den Web-Service in einer UDDI-Registry zu publizieren.
    7. Den Web-Service überwachen: Dadurch wird der Datenverkehr des Web-Service über das TCP/IP-Überwachungsprogramm gesendet, wodurch Sie den vom Web-Service generierten SOAP-Datenverkehr überwachen und diesen im Hinblick auf WS-I-Konformität testen können. Alternativ können Sie ein TCP/IP-Überwachungsprogramm auch manuell einrichten, wie unter Den TCP/IP-Überwachungsprogramm zum Testen von Web-Services verwenden beschrieben.
  5. Seite 'Identität der Java-Bean für den Web-Service': Der WSDL-Name des Web-Service wird aufgelistet. Sie haben die folgenden Optionen:
    • Wählen Sie die zugänglich zu machenden Methoden aus.
    • Wählen Sie die Codierungsdarstellung aus. Die empfohlene Codierungsdarstellung für die Axis-Laufzeitumgebung ist 'RPC/Codiert'. Diese Codierungsmethode ist nicht WS-I-konform.
    • Wählen Sie aus, ob Sie die Zuordnungen Paket-zu-Namensbereich anpassen möchten.
    Klicken Sie auf Weiter
  6. Seite 'Paket-zu-Namensbereich-Zuordnung für Web-Service': Wenn Sie auf der vorherigen Anzeige Definieren Sie angepasste Zuordnungen zwischen Namensbereichen und Paketen ausgewählt haben, können Sie auf dieser Seite Ihre benutzerdefinierten Zuordnungspaare angeben, indem Sie auf Hinzufügen klicken.
  7. Seite 'Web-Service-Test': Wenn Sie ausgewählt haben, dass der Web-Service getestet werden soll, wählen Sie für den generierten Web-Service die Testfunktion aus. Dadurch wird der Web-Service im Web-Services-Explorer gestartet. Wählen Sie die Operation aus, die Sie testen möchten, geben Sie die erforderlichen Informationen an, und klicken Sie auf Los. Das Ergebnis wird im Statusfenster dargestellt. Klicken Sie auf Weiter.
  8. Seite 'Web-Service-Proxy': Wenn Sie ausgewählt haben, dass ein Proxy generiert werden soll, wählen Sie aus, ob Sie die Paket-zu-Namensbereich-Zuordnungen anpassen möchten.
  9. Seite 'Test des Web-Service-Clients': Auf dieser Seite können Sie die folgenden Optionen auswählen:
    1. Wählen Sie die gewünschte Testfunktion aus. Sie können den generierten Proxy im Web-Service-Explorer testen, oder eine Web-Service-JSP-Musterdatei erstellen.
    2. Wenn Sie ausgewählt haben, dass der Proxy über eine JSP-Datei getestet werden soll, können Sie hier den Ordner auswählen, in dem die JSP gespeichert werden soll, und Sie können die in die JSP aufzunehmenden Methoden auswählen.
    3. Wählen Sie Test auf Server ausführen aus, damit der Server automatisch gestartet wird.
  10. Seite 'Web-Service-Publizierung': Wählen Sie aus, ob Sie diesen Web-Service in einer UDDI- Registry publizieren möchten. Klicken Sie auf Fertig stellen Hinweis: Möglicherweise wird die folgende Warnung angezeigt: Fehler bei Generierung von WSDL aus Java. ClassNotFound: <bean-name>. Dieser Fehler kann gefahrlos ignoriert werden.
Nachdem der Web-Service erstellt wurde, kann Folgendes auftreten, je nach den Optionen, die Sie ausgewählt haben:
  • Wenn Sie ausgewählt haben, dass der generierte Proxy mit Web-Service-JSPs getestet werden soll, wird der Proxy in einem Web-Browser unter der folgenden URL gestartet: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Sie können diese Musteranwendung zum Testen des Web-Service verwenden, indem Sie eine Methode auswählen, einen Wert für die Methode eingeben und auf Aufrufen klicken. Das Ergebnis der Methode wird in der Ergebnisanzeige dargestellt.
  • Wenn Sie ausgewählt haben, dass der Web-Service mit dem Web-Services-Explorer getestet werden soll, wird der Explorer geöffnet. Wählen Sie die Operation aus, die Sie testen möchten, geben Sie die erforderlichen Informationen an, und klicken Sie auf Los. Das Ergebnis wird im Statusfenster dargestellt.
  • Wenn Sie ausgewählt haben, dass der Web-Service publiziert werden soll, wird der Web-Services-Explorer gestartet und eine Seite angezeigt, die für die Publizierung Ihres Web-Services erforderlich ist. Folgen Sie den Anleitungen in Web-Service-Publizierung, um diese Task durchzuführen.

Wichtig: Wenn Ihre Methoden Typen enthalten, die im Beispiel nicht unterstützt werden, wie z. B. Arrays, indexierte Eigenschaften und Objektgruppen, werden die Methoden aus dem Beispiel ausgeschlossen, und Sie erhalten eine Warnung.