Sie können Typen, Methoden, Felder und Parameter in Ihrer
Java™-Bean annotieren, um einen Web-Service anzugeben.
Vorbereitende Schritte
Voraussetzungen:- Ihr Arbeitsbereich enthält eine Java-Bean, die mindestens eine öffentliche
Methode hat.
- Diese Java-Bean befindet sich in einem Webprojekt oder in einem Java-Basisprojekt.
Informationen zu diesem Vorgang
Gehen Sie zum Annotieren Ihrer Java-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" 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.