Implémentation d'applications de services Web à partir de fichiers WSDL existants à l'aide de JAX-WS

Lorsque vous utilisez un fichier WSDL (Web Services Description Language) existant, vous pouvez suivre une approche descendante pour développer des services Web JAX-WS selon le modèle de programmation JAX-WS (Java™ API for XML-Based Web Services).

Avant de commencer

Pratiques recommandées Pratiques recommandées: IBM® WebSphere Application Server prend en charge les modèles de programmation JAX-WS (Java API for XML-Based Web Services) et JAX-RPC (Java API for XML-based RPC). JAX-WS représente la future génération du modèle de programmation des services Web qui étend la base du modèle JAX-RPC. L'utilisation du modèle de programmation JAX-WS stratégique simplifie le développement des services et des clients Web par la prise en charge d'un modèle d'annotations normalisé. Bien que le modèle de programmation et les applications JAX-RPC soient toujours pris en charge, vous avez tout avantage à recourir au modèle de programmation JAX-WS, facile à mettre en oeuvre, pour développer de nouvelles applications et de nouveaux clients de services Web. best-practices

Identifiez le fichier WSDL définissant le service Web que vous souhaitez implémenter. Vous pouvez développer un fichier WSDL ou en obtenir un à partir d'un service Web, par email, téléchargement ou à partir d'une URL.

Pourquoi et quand exécuter cette tâche

Pour développer des services Web sur la base d'un modèle de programmation JAX-WS, vous pouvez utiliser une approche ascendante à partir d'un JavaBeans ou d'un bean enterprise existant, ou utiliser une approche descendante à partir d'un fichier WSDL (Web Services Description Language) existant. Cette tâche décrit le déroulement d'une approche descendante.

Considérations relatives à l'utilisation de JavaBeans
  • Les JavaBeans exposés en tant que services Web JAX-WS sont pris en charge uniquement via un transport HTTP.
  • JavaBeans peut utiliser Contexts and Dependency Injection (CDI). Notez que l'injection du constructeur n'est pas prise en charge.
Considérations liées à l'utilisation de beans enterprise
  • Le bean enterprise doit être un bean session sans état ou un singleton.
  • Les beans enterprise exposés en tant que services Web JAX-WS doivent être inclus dans les modules EJB 3.0 ou version supérieure.
  • Les applications Web JAX-WS contenant des beans enterprise doivent être déployés à l'aide de la commande endptEnabler.
  • Les services Web JAX-WS utilisant les beans enterprise sont pris en charge via un transport HTTP JMS (Java Message Service).
  • Les beans enterprise peuvent utiliser CDI. Notez que l'injection du constructeur n'est pas prise en charge.

Procédure

  1. Configurez un environnement de développement pour les services Web. Il n'est pas nécessaire de configurer un environnement de développement si vous utilisez Rational Application Developer.
  2. Développez les artefacts Java pour les applications JAX-WS à l'aide de l'outil de ligne de commande wsimport. L'outil wsimport traite un fichier WSDL et génère des artefacts Java portables, utilisés pour créer un service Web.
  3. (Facultatif) Activez MTOM pour les services Web JAX-WS. Vous pouvez utiliser SOAP MTOM (Message Transmission Optimization Mechanism) pour optimiser la transmission de pièces jointes binaires comme les images ou les fichiers avec des demandes de services Web.
  4. (Facultatif) Forcez le respect des liaisons WSDL dans les services Web JAX-WS. La fonction RespectBindingFeature peut être utilisée pour contrôler si une implémentation JAX-WS est requise pour respecter le contenu d'un élément wsdl:binding associé à un noeud final.
  5. (Facultatif) Développez et configurez un descripteur de déploiement webservices.xml pour les applications JAX-WS. Vous pouvez en option utiliser le descripteur de déploiement webservices.xml pour augmenter ou pour remplacer les métadonnées d'application indiquées dans les annotations à l'intérieur des services Web JAX-WS.
  6. Effectuez l'implémentation de votre application de services Web.
  7. (Facultatif) Personnalisez les modèles d'URL dans le fichier web.xml. Quand les JavaBeans sont exposés en tant que noeuds finaux JAX-WS, vous pouvez en option personnaliser les modèles d'URL dans le descripteur de déploiement web.xml contenu dans le fichier web application archive (WAR).
  8. Assemblez les artefacts de votre service Web.
  9. Déployez le fichier EAR dans le serveur d'applications. Vous pouvez maintenant déployer le fichier EAR qui a été configuré et activé pour les services Web sur serveur d'applications.
  10. Testez le service Web pour vous assurer qu'il fonctionne avec le serveur d'applications.

Résultats

Vous avez créé un service Web JAX-WS à partir d'un fichier WSDL existant.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devwbsjaxwswsdl
Nom du fichier : twbs_devwbsjaxwswsdl.html