EJB-Bean zum Erstellen eines Web-Service annotieren

Sie können Typen, Methoden, Felder und Parameter in Ihrer EJB-Bean annotieren, um einen Web-Service zu spezifizieren.

Vorbereitende Schritte

Voraussetzungen:

Informationen zu diesem Vorgang

Die Schritte zum Erstellen eines Web-Service aus einer EJB-Bean mithilfe von Annotationen sind im Folgenden beschrieben:
  1. Annotieren Sie Ihre EJB-Bean mit der Annotation "@WebService" und allen weiteren für Ihre Implementierung erforderlichen Annotationen.
  2. 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.
  3. 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

  1. Klicken Sie in der Ansicht "Enterprise-Explorer" doppelt auf Ihre Java™-Bean, um die Datei im Java-Editor zu öffnen.
  2. 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.
  3. 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.
Symbol das den Typ des Artikels anzeigt. Taskartikel
Nutzungsbedingungen für Information Center | Feedback

Symbol für Zeitmarke Letzte Aktualisierung: 29.04.2014

Dateiname: twsanbuejb.html