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: 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
- 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.
- 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.
- (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.
- (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.
- (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.
- Effectuez l'implémentation de votre application de services Web.
- (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).
- Assemblez les artefacts de votre service Web.
- 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.
- 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.