Vous pouvez annoter des types, des méthodes, des zones et des paramètres dans votre bean Java™ pour spécifier un service Web.
Avant de commencer
Conditions prérequises :- Votre espace de travail contient un bean Java qui possède au moins une méthode publique.
- Ce bean Java se trouve dans un projet Web ou dans un projet Java de base.
Pourquoi et quand exécuter cette tâche
Pour annoter votre bean Java :
Procédure
- Dans la vue Explorateur d'entreprise, cliquez deux fois sur votre bean Java pour ouvrir le fichier correspondant dans
l'éditeur Java.
- Dans la classe Java qui implémente votre service Web, spécifiez l'annotation @WebService.
Spécifiez également des attributs pour l'annotation, le cas échéant.
- La plupart des erreurs qui s'affichent lors de l'ajout d'annotations peuvent être résolues à l'aide des correctifs rapides suggérés. Pour afficher les correctifs rapides, cliquez sur le marqueur d'erreur.
- Pour ajouter des annotations ou des attributs à des annotations existantes, vous pouvez utiliser la vue Annotations plutôt que d'ajouter manuellement ces informations à la classe. Cette vue propose une validation et des instructions de base lors de l'utilisation d'annotations.
- Facultatif : utilisez ces annotations, et d'autres, pour personnaliser plus en détail votre service Web :
- Dans la classe Java qui implémente votre service Web, spécifiez l'annotation @WebMethod dans chaque méthode à personnaliser pour le service. Vous pouvez utiliser cette annotation pour exclure une méthode de votre service. Par défaut,
toutes les méthodes publiques sont exposées dans un service, y compris les méthodes héritées
qui se trouvent sous la classe Object.
- Dans les méthodes qui sont exposées dans votre service Web, utilisez les annotations
@WebParam et @WebResult pour personnaliser le mappage de vos paramètres et des résultats à des parties de message et des éléments XML.
- Dans une classe d'exception, spécifiez l'annotation @WebFault pour mapper votre classe à une erreur WSDL.
Résultats
Une fois les annotations ajoutées au bean, la vue Services répertorie le service Web sous l'en-tête JAX-WS. A partir de cette vue, vous pouvez tester le service Web en cliquant dessus avec le bouton droit de la souris et en sélectionnant
Tester avec l'explorateur de services Web ou
Tester avec le client de service générique. Vous pouvez aussi générer des descripteurs de déploiement et gérer les ensembles de règles associés au service dans cette vue.