Configuration du descripteur de déploiement webservices.xml pour les classes de gestionnaire
Vous pouvez utiliser l'outil d'assemblage pour configurer le descripteur de déploiement webservices.xml pour les classes de gestionnaire fournies par l'utilisateur.
Avant de commencer
Vous pouvez configurer des descripteurs de déploiement à l'aide des outils d'assemblage fournis avec le serveur d'applications.
Une classe de gestionnaire est une classe qui est écrite pour modifier un message SOAP représentant une demande ou une réponse RPC. Des gestionnaires peuvent être associés à un service web ou à un client de service Web.
Comme pour les services Web JAX-RPC (Java™ API for XML-based RPC), vous pouvez utiliser des descripteurs de déploiement pour décrire les services web JAX-WS (Java API for XML Web Services). Pour les services Web JAX-WS, l'utilisation du descripteur de déploiement webservices.xml est facultatif car vous pouvez utiliser des annotations pour spécifier toutes les informations contenues dans le fichier de descripteur de déploiement. Vous pouvez utiliser ce fichier pour augmenter ou remplacer des annotations JAX-WS existantes. Toutes les informations que vous définissez dans le descripteur de déploiement webservices.xml remplacent les informations correspondantes spécifiées par les annotations.
Pour effectuer cette tâche, vous devez utiliser un fichier EAR pour les applications que vous voulez configurer. Pour certaines tâches du gestionnaire, comme la consignation ou le traçage, seule l'application serveur ou client doit être configurée. Dans d'autres situations, comme l'envoi des informations des en-têtes SOAP, les applications client et serveur doivent être configurées avec des gestionnaires symétriques.
Pourquoi et quand exécuter cette tâche
Les modules du fichier EAR comportent les classes du gestionnaire à configurer. Ces classes implémentent l'interface javax.xml.rpc.handler.Handler. Pour plus d'informations sur l'écriture des classes Handler, voir le chapitre 6 de la spécification Web Services for Java EE. Pour plus d'informations sur l'infrastructure du gestionnaire de votre modèle de programmation, voir le chapitre 9 dans la spécification JAX-WS ou le chapitre 12 dans la spécification JAX-RPC. Les modules d'application doivent contenir le descripteur de déploiement webservices.xml. Consultez la documentation sur l'API et les spécifications des services web pour plus d'informations sur la spécification JAX-RPC et pour obtenir une liste complète des spécifications et des normes prises en charge.
Procédure
- Démarrez un outil d'assemblage. Lisez la rubrique sur le démarrage de l'outil d'assemblage dans la documentation Rational Application Developer.
- Si vous ne l'avez pas déjà fait, configurez l'outil d'assemblage pour qu'il puisse fonctionner avec les modules Java EE. Vous devez vous assurer que les catégories Java EE et Web sont activées. Lisez la rubrique sur la configuration de l'outil d'assemblage dans la documentation Rational Application Developer.
- Faites migrer les fichiers WAR (fichiers d'archive Web) créés à l'aide d'Assembly Toolkit, d'Application Assembly Tool (AAT) ou d'un autre outil vers l'outil d'assemblage Rational Application Developer. Pour faire migrer les fichiers, importez les fichiers WAR dans l'outil d'assemblage. Lisez la rubrique sur la migration des artefacts de code vers un outil d'assemblage dans la documentation Rational Application Developer.
- Configurez le descripteur de déploiement du client. Lisez la rubrique sur la configuration du descripteur de déploiement client dans la documentation Rational Application Developer.