Services Web JAX-RPC |
Construction des exemples de services Web JAX-RPC avec l'utilitaire de génération Ant
|
![]() |
Génération avec Ant | Exemples de services Web JAX-RPC |
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 |
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.
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.
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.
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é. |
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 |
Suppression et réinstallation du fichier WebServicesSamples.ear |
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 :
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.
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.
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 :
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')"
wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>', '-deployejb' ] )"où <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' ] )"où <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' ] )"où <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' ] )"où <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
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.