Assemblage d'un fichier JAR client compatible avec les services web en fichier EAR

Une fois que vous avez généré vos artefacts d'application, vous devez assembler ces derniers pour créer un fichier EAR utilisé dans l'application de services web.

Avant de commencer

Pour les applications de services Web JAX-WS (Java™ API for XML-Based Web Services), les artefacts portables générés par l'outil de ligne de commande wsimport sont nécessaires lorsque vous exécutez cette opération à partir d'un fichier WSDL. L'outil wsimport traite un fichier WSDL en tant qu'entrée et génère les artefacts portables suivants :
  • Interface SEI (Service Endpoint Interface)
  • Classe de service
  • Classes d'exception mappées à partir de la classe wsdl:fault (le cas échéant)
  • Valeurs générées de type JAXB (Java Architecture for XML Binding), qui sont des classes Java mappées à partir de types de schéma XML.
  • Module de client assemblé contenant l'implémentation, toutes les classes générées par l'outil de ligne de commande wsimport et le descripteur de déploiement ejb-jar.xml ou application-client.xml. Ce module peut être :
    • Un module de client d'application qui contient le fichier META-INF/application-client.xml.
    • Un module EJB (Enterprise JavaBeans) qui contient le fichier META-INF/ejb-jar.xml.
Pour les applications de services Web JAX-RPC (Java API for XML-based RPC), vous avez besoin pour effectuer cette tâche, des artefacts suivants qui sont générés à partir de l'outil de ligne de commande WSDL2Java :
  • Un module de client assemblé qui contient l'implémentation, toutes les classes générées par l'outil de ligne de commande WSDL2Java et le descripteur de déploiement ejb-jar.xml ou le descripteur de déploiement application-client.xml. Ce module peut être :
    • Un module de client d'application qui contient le fichier META-INF/application-client.xml.
    • Un module EJB (Enterprise JavaBeans) qui contient le fichier META-INF/ejb-jar.xml.
  • Le fichier WSDL que vous avez utilisé pour développer le client.
  • Les modèles du descripteur de déploiement ibm-webservicesclient-ext.xmi et ibm-webservicesclient-bnd.xmi, s'ils sont utilisés.
  • Une API Java générée pour le descripteur de déploiement de mappage JAX-RPC (Java API for XML-based remote procedure call).
Restriction : N'insérez pas de signe dièse (#) dans le nom des fichiers intégrés dans une archive d'application. Si c'est le cas, le serveur d'applications ne peut pas déployer l'application pour des raisons de traitement interne. Si cette erreur se produit, une exception peut être générée au cours du traitement de l'application. De plus, une partie de l'application risque de manquer une fois le déploiement terminé. Pour corriger l'erreur, renommez les fichiers dans l'archive d'application afin qu'ils ne contiennent pas de signe dièse.

Pourquoi et quand exécuter cette tâche

Vous pouvez utiliser des outils d'assemblage fournis avec WebSphere Application Server pour assembler des applications de clients compatibles avec des services Web.

Assemblez le code du client et les artefacts pour activer le client d'application et accéder à un service web en procédant comme suit :

Procédure

  1. Démarrez un outil d'assemblage. Lisez la rubrique sur le démarrage de l'outil d'assemblage dans la documentation Rational Application Developer.
  2. Si vous ne l'avez pas déjà fait, configurez l'outil d'assemblage pour qu'il puisse fonctionner avec les modules J2EE (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.
  3. Importez l'implémentation client et les artefacts générés par les outils de ligne de commande dans l'outil d'assemblage.
  4. Faites migrer les fichiers JAR créés avec l'outil d'assemblage Rational Application Developer. Pour faire migrer les fichiers, importez les fichiers JAR 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.
  5. Assemblez le fichier JAR dans un fichier EAR à l'aide des techniques d'assemblage standard si le client s'exécute dans un conteneur.

Résultats

Vous avez assemblé les artefacts requis pour activer l'application client pour les services web dans un fichier EAR.

Exemple

Cet exemple de procédure d'assemblage utilise le fichier JAR AddressBookClient.jar et le fichier EAR AddressBookClient.ear :
META-INF/MANIFEST.MF
META-INF/application-client.xml
META-INF/wsdl/AddressBook.wsdl
META-INF/AddressBook_mapping.xml

com/ibm/websphere/samples/webservices/addr/Address.class
com/ibm/websphere/samples/webservices/addr/AddressBook.class
com/ibm/websphere/samples/webservices/addr/AddressBookClient.class
com/ibm/websphere/samples/webservices/addr/AddressBookService.class
...d'autres classes générées...
Après l'assemblage du fichier AddressBookClient.jar dans le fichier AddressBookClient.ear, le fichier AddressBookClient.ear contient les fichiers suivants :
META-INF/MANIFEST.MF 
AddressBookClient.jar 
META-INF/application.xml

Que faire ensuite

Pour les applications JAX-WS (Java API for XML-Based Web Services), vous êtes prêt pour le déploiement de l'application client des services Web.

Pour les applications JAX-RPC (Java API for XML-based RPC), vous devez configurer les liaisons du descripteur de déploiement du client à l'aide d'un outil d'assemblage pour que le client puisse communiquer avec un service web déployé sur un serveur.


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_assembclient
Nom du fichier : twbs_assembclient.html