Construction des exemples de services Web JAX-WS avec l'utilitaire de génération Ant.


Portabilité J2EE
Reconstitution des exemples de services Web JAX-WS
Mise en route
Identification de l'arborescence de la génération des exemples
Reconstitution et réinstallation du fichier JaxWSServicesSamples.ear

Portabilité J2EE

La portabilité est l'un des principaux avantages du développement d'applications sur une plateforme J2EE.  Tous les programmes exemple de la Samples Gallery sont développés sur une station de travail et s'exécute sur les systèmes z/OS sans changer une ligne de code.  En construisant les applications J2EE sur Intel ou des systèmes d'exploitation tels qu'AIX ou Linux, un développeur peut éliminer les problèmes liés aux conversions de fichiers EBCDIC vers ASCII ou ASCII vers EBCDIC.  La disponibilité des outils facilite le travail d'écriture et de test du développeur sur un poste de travail de développement et l'installation des fichiers EAR (Enterprise Archive) sur les systèmes z/OS.

Reconstitution des exemples JAX-WS

Chaque instance WebSphere Application Server pour le client z/OS est autorisée à accéder aux supports Application Server multi-plateformes. Si vous installez le produit WebSphere Application Server de base et les exemples sur l'une des plateformes prises en charge par ce package, vous obtenez la même galerie d'exemples. Cependant il y a une différence. quand vous cliquez sur nom_exemple > Génération avec Ant > platform > Régénération et installation du fichier, les instructions pour régénérer le fichier EAR sont spécifiques à votre plateforme.  Etant donné que les fichiers texte dans un fichier EAR tels que les fichiers XML, xmi, JSP (JavaServer Pages), doivent être au format ASCII, il est plus facile de modifier ces fichiers sur une machine ASCII.  Si vous effectuez des modifications sur une machine ASCII, vous pouvez ensuite réinstaller le fichier EAR obtenu sur la plateforme z/OS sans conversion EBCDIC en ASCII. 

Mise en route

Installez WebSphere Application Server sur la plateforme distribuée de votre choix et indiquez qu'il convient d'installer également les modèles d'application. Sur le panneau Install Sample Applications, sélectionnez Installer les modèles d'application.

Générez une copie de sauvegarde du répertoire <racine_profil>/samples/src/JaxWSServicesSamples avant de modifier ou de régénérer les exemples.

Identification de l'arborescence de la génération des exemples

Les exemples sont installés dans les répertoires suivants :

<racine_profil>/samples/src/JaxWSServicesSamples Contient le code source des exemples Ping, Echo et MTOM.
<racine_profil>/samples/lib/JaxWSServicesSamples Contient les fichiers WAR (Web Archive), les fichiers JAR (Java Archive) et le fichier JaxWSServicesSamples.ear final des exemples. Ce répertoire est créé une fois l'exemple régénéré.
<racine_profil>/samples/javadoc/JaxWSServicesSamples Contient la documentation Javadoc des exemples. Ce répertoire est créé une fois l'exemple régénéré.
<racine_profil>/samples/bld/JaxWSServicesSamples Contient les fichiers de classe générés. Ils servent à générer le fichier JaxWSServicesSamples.ear final. Ce répertoire est créé une fois l'exemple régénéré.

Régénération et réinstallation du fichier JaxWSServicesSamples.ear

Le fichier EAR des exemples de services Web JAX-WS est installé en même temps que le serveur d'applications WebSphere. Il n'est pas nécessaire de générer les exemples pour pouvoir les utiliser. Les instructions ci-dessous décrivent la procédure à suivre pour régénérer les exemples et fournissent des informations complémentaires sur la manière de les modifier.

Exécution du script de génération des exemples

Transfert du fichier JaxWSServicesSamples.ear régénéré
Suppression et réinstallation du fichier JaxWSServicesSamples.ear

Exécution du script de génération des exemples

Pour régénérer le fichier EAR des exemples de services Web JAX-WS, procédez comme suit :

  1. Vérifiez que <racine_profil>/bin figure dans votre variable d'environnement PATH.
  2. Accédez au répertoire <racine_profil>/samples/src/JaxWSServicesSamples.
  3. Exécutez le script de génération de l'exemple.
    • Sur les plateformes Windows, entrez buildJaxWSSamples sur la ligne de commande.
    • Sur les plateformes telles qu'AIX ou Linux, entrez buildJaxWSSamples.sh sur la ligne de commande.

L'exemple est à présent généré.

Les scripts buildJaxWSSamples se trouvent dans le répertoire <racine_profil>/bin. Les scripts définissent les informations de chemin d'accès aux classes appropriées et exécutent l'utilitaire de génération Ant. Cet utilitaire lit les fichiers build.xml, qui décrivent comment générer les exemples. Pour obtenir plus d'informations sur Ant, reportez-vous au site Web Apache Ant.

Important Au cours du processus de génération, seuls les fichiers de classe ayant été modifiés sont régénérés. Les autres fichiers de classe sont intégrés dans le nouveau fichier EAR.

Transfert du fichier JaxWSServicesSamples.ear régénéré

Utilisez le protocole FTP (File Transfer Protocol) pour transférer le fichier EAR binaire sur le serveur z/OS en suivant les instructions ci-dessous.

  1. Recherchez le fichier EAR régénéré dans le répertoire <racine_profil>/samples/lib/JaxWSServicesSamples.
  2. Ouvrez une session FTP vers WebSphere Application Server pour z/OS à partir de la plateforme de développement.
  3. Accédez au répertoire <racine_profil>/samples/lib/JaxWSServicesSamples.
  4. Supprimez le fichier JaxWSServicesSamples.ear. Entrez la commande : del JaxWSServicesSamples.ear
  5. Pour transférer le fichier au format binaire, entrez la commande : bin
  6. Déplacez le fichier régénéré JaxWSServicesSamples.ear de votre plateforme de développement vers le serveur d'applications cible. Entrez la commande : put JaxWSServicesSamples.ear
  7. Mettez fin à la session FTP. Entrez quit.

Suppression et réinstallation du fichier JaxWSServicesSamples.ear

Par défaut, l'exemple de services Web JAX-WS est installé dans le répertoire <racine_profil>/installedApps/<nom de cellule>, où <nom de cellule> est le nom de la cellule dans laquelle l'application est installée. Réinstallez l'exemple en suivant la procédure ci-dessous :

  1. Arrêtez le serveur d'applications.
  2. Supprimez le fichier EAR de l'exemple de services Web JAX-WS :
    1. Entrez les commandes suivantes :

      cd <racine_profil>\bin
      setupCmdLine

      cd <racine_profil>/bin
      . ./setupCmdLine.sh

      cd <racine_profil>/bin
      . ./setupCmdLine.sh

      cd <racine_profil>/bin
      . ./setupCmdLine

      <racine_profil> représente le répertoire d'installation du profil.
    2. Tapez la commande suivante pour désinstaller l'application (<racine_profil>/bin doit se trouver dans la variable d'environnement PATH) :

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

  3. Réinstallez l'exemple :
    • Accédez au répertoire <racine_profil>/samples/lib/JaxWSServicesSamples
    • Recherchez le fichier JaxWSServicesSamples.ear
    • Entrez les commandes suivantes :

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>' ] )"
                
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>' ] )"
                
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>' ] )"
                
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>' ] )"
                
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
  4. Démarrez le serveur d'applications.

Vous avez régénéré et réinstallé l'application exemple de services Web JAX-WS. Vous pouvez configurer et exécuter les clients des exemples Ping, Echo et MTOM.