Sie können Typen, Methoden, Felder und Parameter in Ihrer EJB-Bean annotieren, um einen Web-Service zu
spezifizieren.
Vorbereitende Schritte
Voraussetzungen:- Ihr Arbeitsbereich enthält eine EJB 3.x-Session-Bean, die mindestens eine öffentliche Methode hat.
- Diese EJB-Bean ist in einem JAX-WS-fähigen EJB-Projekt enthalten.
- Die Ziellaufzeitumgebung des Projekts ist WebSphere Application Server Version 7.0 oder höher.
Informationen zu diesem Vorgang
Die Schritte zum Erstellen eines Web-Service aus einer EJB-Bean mithilfe von Annotationen sind im Folgenden beschrieben:
- Annotieren Sie Ihre EJB-Bean mit der Annotation "@WebService" und allen weiteren für Ihre Implementierung erforderlichen
Annotationen.
- Erstellen Sie JMS- oder HTTP-Routermodule für den Web-Service gemäß der Beschreibung im Abschnitt
Routermodule für Web-Service erstellen.
Neuerung in WebSphere Application Server Version 8: Wenn Sie Ihre
EJB-Anwendung in ein WAR-Modul packen, müssen Sie keine Routermodule erstellen.
- Veröffentlichen Sie die Anwendung gemäß der Beschreibung im Abschnitt
Web-Service aus einer annotierten EJB-Bean durch Veröffentlichung auf einem Server erstellen auf einem Server.
Gehen Sie zum Annotieren Ihrer EJB-Bean wie folgt vor:
Vorgehensweise
- Klicken Sie in der Ansicht "Enterprise-Explorer" doppelt auf Ihre
Java™-Bean, um die Datei im Java-Editor zu öffnen.
- Geben Sie in der Java-Klasse, die Ihren Web-Service implementiert,
die Annotation "@WebService" sowie die Annotation "@Stateless", "@Stateful" oder "@Singleton" an.
Geben Sie außerdem die gewünschten Attribute für die Annotation an.
- Die meisten Fehler, die beim Hinzufügen von Annotationen angezeigt werden, können mithilfe der vorgeschlagenen
Schnellkorrekturen (Quickfix) behoben werden. Zum Anzeigen der Schnellkorrekturen klicken Sie
auf die Fehlermarkierung.
- Wenn Sie vorhandenen Annotationen weitere Annotationen oder Attribute hinzufügen möchten, können Sie dazu die
Ansicht "Annotationen" verwenden, anstatt diese Informationen der Klasse manuell hinzuzufügen.
Diese Ansicht ermöglicht eine Basisvalidierung und enthält Anleitungen für die Arbeit mit Annotationen.
- Optional: Verwenden Sie diese und weitere Annotationen, um Ihren Web-Service weitere anzupassen:
- Geben Sie in der Java-Klasse, die Ihren Web-Service implementiert,
die Annotation "@WebMethod" in jeder Methode an, die Sie für den Service anpassen möchten.
Sie können diese Annotation verwenden, um eine Methode von Ihrem Service auszuschließen.
Standardmäßig werden alle öffentlichen Methoden in einem Service bereitgestellt, einschließlich übernommener Methoden unterhalb
der Klasse "Object".
- Verwenden Sie in den Methoden, die in Ihrem Web-Service bereitgestellt werden, die Annotationen
"@WebParam" und "@WebResult", um die Zuordnung Ihrer Parameter und Ergebnisse zu Nachrichtenteilen und XML-Elementen
anzupassen.
- Geben Sie in einer Ausnahmeklasse die Annotation "@WebFault" an, um Ihre Klasse einem WSDL-Fehler zuzuordnen.
Ergebnisse
Sobald die Annotationen der Bean hinzugefügt wurden, muss der Web-Service in der Ansicht "Services" unter der Überschrift "JAX-WS"
aufgelistet werden. In dieser Ansicht können Sie den Web-Service testen, indem Sie mit der rechten Maustaste auf den Service
klicken und dann
Mit Web-Service-Explorer testen oder
Mit generischem Service-Client testen auswählen.
Außerdem können Sie in dieser Ansicht Implementierungsdeskriptoren generieren und die dem Service zugeordneten
Richtliniensätze verwalten.