Activation d'un fichier EAR pour des services Web à l'aide de la commande endptEnabler

L'outil de ligne de commande endptEnabler permet d'activer un fichier d'archive d'entreprise (EAR) pour des modules EJB qui contiennent des services Web et pour indiquer si les services Web sont exposés à l'aide de SOAP sur JMS (Java™ Message Service) ou de SOAP sur HTTP.

Pourquoi et quand exécuter cette tâche

L'outil de ligne de commande endptEnabler ajoute un ou plusieurs modules de routeur au fichier EAR pour chaque module JAR (Java archive) de bean enterprise compatible avec des services Web basés sur JAX-WS (Java API for XML Web Services) ou JAX-RPC (Java API for XML-based RPC). Un module de routeur fournit le point de contact des services Web contenus dans un module JAR d'EJB particulier.

Chaque module de routeur prend en charge un transport spécifique comme HTTP ou JMS. Un module de routeur HTTP est un module WAR (web application archive) qui fournit un noeud final HTTP pour chacun des services Web contenu dans un module JAR de bean enterprise particulier. De la même manière, un module de routeur JMS est un module JAR de bean enterprise qui contient un bean géré par message (MDB) servant de programme d'écoute pour des demandes à l'attention des noeuds finaux de services Web.

Si le fichier EAR ne comporte aucun module JAR de bean enterprise, il n'est pas nécessaire d'utiliser cet outil.

Procédure

  1. [IBM i]Appelez le script endptEnabler en ligne de commande Qshell à partir du répertoire racine_serveur_app/bin. [AIX Solaris HP-UX Linux Windows][z/OS]Appelez la commande endptEnabler à partir du répertoire racine_install/bin.
  2. A l'invite, entrez le nom du fichier EAR.
  3. Saisissez les différentes valeurs d'entrée demandées par la commande endptEnabler. Vous êtes invité à spécifier diverses valeurs d'entrée pour chaque module JAR de bean enterprise activé pour des services Web dans le fichier EAR. En général, vous devez accepter les valeurs par défaut de chaque invite. Pour plus d'informations sur les propriétés de cette commande, voir la documentation de la commande endptEnabler.
    1. Indiquez un module de routeur HTTP pour le transport de votre service Web basé sur EJB. Utilisez l'option -transport http pour indiquer que le service Web est accessible via HTTP. Un module de routeur est créé pour chaque fichier JAR de bean enterprise qui contient des services Web JAX-WS ou JAX-RPC.
    2. Indiquez un module de routeur JMS pour le transport de votre service Web basé sur EJB. Utilisez l'option -transport jms pour indiquer que le service Web est accessible via JMS. Un module de routeur est créé pour chaque fichier JAR de bean enterprise qui contient des services Web JAX-WS ou JAX-RPC.

Résultats

Un module de routeur HTTP ou JMS est ajouté au fichier EAR pour chaque module JAR de bean enterprise dans le fichier EAR qui contient des noeuds finaux de services Web. Pour HTTP, une racine de contexte (context-root) est configurée pour l'application afin que le service Web puisse être appelé via une adresse Web. L'adresse Web utilisée pour appeler le service Web est la suivante :
http://host[:port]/<context-root>/services/<port-component-name>

Vérifiez que vous avez installé le module de routeur HTTP ou JMS (Java Message Service), généré avec la commande endptEnabler, sur la même cible que vos fichiers JAR de bean enterprise pour les services Web. Ces modules de routeur HTTP ou JMS sont inclus dans votre application de services Web et doivent utiliser les bibliothèques d'exécution du serveur d'applications.

Que faire ensuite

Déployez le fichier EAR sur votre serveur d'applications. Un fichier EAR assemblé et activé pour les services Web est nécessaire au déploiement.

Si vous utilisez JMS comme transport pour vos demandes de services Web, définissez les divers objets JMS (files d'attente, rubriques ou fabriques de connexions, etc) que votre application utilisera préalablement à l'installation de l'application.


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_endptenablerendpt
Nom du fichier : twbs_endptenablerendpt.html