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


Portabilité J2EE
Régénération des exemples livrés dans cette galerie
Mise en route
Identification de l'arborescence de la génération des exemples
Régénération et réinstallation du fichier WebServicesSamples.ear

Portabilité J2EE

La portabilité est l'un des principaux avantages du développement d'applications sur une plateforme J2EE.  Tous les programmes exemples de la galerie d'exemples sont développés sur un poste de travail et peuvent être exécutés sur des systèmes z/OS sans qu'il soit nécessaire de modifier une seule ligne du code Java.  En créant des applications J2EE sur des systèmes Intel ou UNIX, un développeur évite l'écueil des conversions de fichiers EBCDIC en ASCII ou ASCII en 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.

Régénération des exemples livrés dans cette galerie

Chaque instance WebSphere Application Server (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. Il y a une exception : quand vous cliquez sur nom_exemple > Génération avec Ant > plateforme > Régénération et installation du fichier sample.ear, vous recevez des instructions pour régénérer le fichier EAR sur cette plateforme.  Etant donné que les fichiers texte dans un fichier EAR (fichiers XML, xmi, JSP (JavaServer Pages), etc.) 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'applications.

Faites une copie de sauvegarde du répertoire <racine_profil>/samples/src/WebServicesSamples 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/WebServicesSamples Contient le code source des exemples AddressBook et Stock Quote.
<racine_profil>/samples/lib/WebServicesSamples Contient les fichiers WAR (Web Archive), les fichiers JAR (Java Archive) et le fichier WebServicesSamples.ear final des exemples. Ce répertoire est créé une fois l'exemple régénéré.
<racine_profil>/samples/javadoc/WebServicesSamples Contient la documentation Javadoc des exemples. Ce répertoire est créé une fois l'exemple régénéré.
<racine_profil>/samples/bld/WebServicesSamples Contient les fichiers de classe générés. Ils servent à générer le fichier WebServicesSamples.ear final. Ce répertoire est créé une fois l'exemple régénéré.

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

Le fichier d'archive d'entreprise (EAR) des exemples de services Web JAX-RPC est fourni lors de l'installation du 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 WebServicesSamples.ear régénéré
Suppression et réinstallation du fichier WebServicesSamples.ear

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

Pour régénérer cet exemple, vérifiez que <racine_profil>/bin figure dans votre variable d'environnement PATH. Suivez les étapes ci-après pour exécuter le script de génération de l'exemple, qui régénére l'exemple :

  1. Ouvrez une invite de commande.
  2. Sur la ligne de commande, accédez au répertoire <racine_profil>/samples/src/WebServicesSamples.
  3. Exécutez le script de génération de l'exemple :
  4. Entrez buildWebServiceSamples sur la ligne de commande.
    • Sur les plateformes de développement Windows, entrez buildWebServiceSamples sur la ligne de commande.
    • Sur les plateformes de développement UNIX et Linux, entrez buildWebServiceSamples.sh sur la ligne de commande.

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

Les scripts buildWebServicesSamples.bat et buildWebServicesSamples.sh du répertoire <racine_profil>/samples/bin/WebServicesSamples ont défini les informations du chemin d'accès aux classes appropriées et exécuté l'utilitaire de génération Ant. Ant lit les fichiers build.xml qui décrivent le mode de génération de l'exemple. Pour plus d'informations sur Ant, voir le site Web Jakarta.

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 WebServicesSamples.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/WebServicesSamples.
  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/WebServicesSamples.
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

Suppression et réinstallation du fichier WebServicesSamples.ear

Par défaut, l'exemple de services Web JAX-RPC 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-RPC :
    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('WebServicesSamples')" 

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

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

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

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

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>', '-deployejb' ] )"
                
      <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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>', '-deployejb' ] )"
                
      <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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>', '-deployejb' ] )"
                
      <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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', 
                  '-server', '<serveur>', '-deployejb' ] )"
                
      <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 des exemples de services Web JAX-RPC. Vous pouvez configurer et exécuter les clients des exemples Address Book et Stock Quote.