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
- 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.
- 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).
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
- 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 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.
- Importez l'implémentation client et les artefacts générés par les outils de ligne de commande dans l'outil d'assemblage.
- 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.
- 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
Exemple
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...
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.