Commande wsdeploy

La commande wsdeploy permet d'ajouter des classes de déploiement WebSphere spécifiques au produit à un fichier EAR (enterprise archive) d'application d'entreprise compatible avec les services Web ou à un fichier JAR (Java™ archive) de client d'application.

La commande wsdeploy est prise en charge par des applications Java API for XML-based RPC (JAX-RPC). Le modèle de programmation Java API for XML-Based Web Services (JAX-WS) qui est implémenté par le serveur d'applications ne prend pas en charge la commande wsdeploy. Si votre application de services Web contient uniquement des noeuds finaux JAX-WS, il n'est pas utile d'exécuter la commande wsdeploy, car elle n'est utilisée que pour traiter les noeuds finaux JAX-RPC.

Les classes de déploiement qui sont ajoutées par l'outil wsdeploy à un fichier EAR compatible aux services Web ou à un fichier JAR incluent :
  • des raccords (stubs),
  • des sérialiseurs et des désérialiseurs,
  • des implémentations d'interfaces de services.
Cette étape de déploiement doit être effectuée au moins une fois et peut l'être plusieurs fois. Le déploiement peut être effectué séparément à l'aide de la commande wsdeploy, des outils d'assemblage, ou lorsque l'application est installée. Lors de l'utilisation de la commande wsadmin pour l'installation, spécifiez l'option -deployws.
La commande wsdeploy opère de la façon suivante :
  • Chaque module de l'application d'entreprise ou du fichier JAR est examiné.
  • Si le module contient des implémentations de services Web, signalés par la présence du descripteur de déploiement webservices.xml, les fichiers WSDL associés sont localisés et la commande WSDL2Java est exécutée avec le rôle de serveur de déploiement.
  • Si le module contient des clients de services Web, signalés par la présence du descripteur de déploiement client, les fichiers WSDL associés sont localisés et la commande WSDL2Java est exécutée avec le rôle de client de déploiement.
  • Les fichiers générés par la commande WSDL2Java sont compilés et réintégrés.
Pour plus d'informations sur les fichiers générés pour le déploiement, voir les informations relatives à l'utilisation de la commande WSDL2Java avec les applications JAX-RPC.

Lorsque les fichiers générés sont compilés, ils peuvent faire référence à des classes spécifiques à l'application en dehors du fichier EAR ou JAR si ce dernier n'est pas autonome. Dans ce cas, utilisez l'option -jardir ou -cp pour spécifier les fichiers JAR ou compressés supplémentaires à ajouter à la variable CLASSPATH lorsque les fichiers générés sont compilés.

Syntaxe de la commande wsdeploy

La syntaxe de la commande est présentée ci-après :
wsdeploy Input_filename Output_filename [options] 
Options requises :
  • nom_fichier_entrée

    Indique le chemin d'accès au fichier EAR ou JAR à déployer.

  • nom_fichier_sortie

    Indique le chemin d'accès au fichier EAR ou JAR déployé. Si le nom_fichier_sortie existe déjà, il est automatiquement remplacé. Le nom_fichier_sortie peut être le même que le nom_fichier_entrée.

Autres options :
  • -jardir répertoire

    Indique un répertoire contenant les fichiers JAR ou compressés. Tous les fichiers JAR et compressés de ce répertoire sont ajoutés au chemin d'accès aux classes (CLASSPATH) utilisé pour compiler les fichiers générés. Cette option peut ne jamais être spécifiée ou l'être plusieurs fois.

  • -cp entrées

    Indique les entrées à ajouter à la variable CLASSPATH lorsque les classes générées sont compilées. Plusieurs entrées sont séparées de la même façon que dans la variable d'environnement CLASSPATH.

  • -codegen

    Indique la génération sans compilation du code déploiement. Cette option spécifie implicitement l'option -keep.

  • -debug

    Inclut les informations de débogage lors de la compilation, c'est-à-dire, l'utilisation de javac -g pour compiler.

  • -help

    Affiche un message d'aide et une sortie.

  • -ignoreerrors

    Le déploiement ne s'arrête pas si des erreurs de validation ou de compilation sont détectées.

  • -keep

    Les répertoires de travail contenant les classes générées ne sont pas supprimés. Un message s'affiche indiquant le nom du répertoire de travail retenu.

  • -novalidate

    Les descripteurs de déploiement des services Web ne sont pas validés dans le fichier d'entrée.

  • -trace

    Affiche les informations relatives au traitement, y compris les noms des fichiers générés.

  • -compliancelevel level

    Définit le niveau du kit Java JDK pour la conformité du compilateur. Les valeurs valides sont 1.4, 5.0, 6.0 (valeur par défaut) et 7.0. Ce paramètre est facultatif.

L'exemple suivant illustre les options utilisées avec la commande wsdeploy :
wsdeploy x.ear x_deployed.ear -trace -keep  
Processing web service module x_client.jar.   
Keeping directory: f:\temp\Base53383.tmp for module: x_client.jar.   
Parsing XML file:f:\temp\Base53383.tmp\WarDeploy.wsdl   
Generating f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java   
Generating f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java   
Generating f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java   
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java.   
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java.   
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java.   
Done processing module x_client.jar.  
Les messages suivants peuvent s'afficher :
  • L'indicateur -f n'est pas valide.

    L'option f n'a pas été reconnue comme étant une option valide.

  • L'indicateur -c est ambigu.

    Les options peuvent être abrégées, mais l'abréviation doit être unique. Dans ce cas, la commande wsdeploy ne peut pas déterminer l'option envisagée.

  • Le paramètre -p est manquant dans l'indicateur -c.

    Un paramètre requis a été omis pour une option.

  • Le paramètre p est manquant.

    Une option requise a été omise.


Icône indiquant le type de rubrique Rubrique de référence



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=rwbs_wsdeploy
Nom du fichier : rwbs_wsdeploy.html