Création, édition du fichier de redirection du point d'accès d'un service web
[Axis1 / jusqu'à Adélia Studio 11 inclus]
Contexte C Windows :
. Créer (ou éditer) un fichier "cfgWebServices.ini" dans un répertoire se trouvant dans le PATH
. Créer un label [cWebServices]
. Sous ce label, créer une entrée pour le service web à monitorer :
Contexte Java : Créer un fichier "cfgWebServices.properties" dans un répertoire se trouvant dans le CLASSPATH ou dans WEB-INF\classes (pour une webapp)
. créer une entrée pour le service web à monitorer :
Exemple :
Monitorer la consommation du service web de nom Adélia GESTIONCHAINES (Cf. base de connaissance).
On suppose que le nom réel du service web est "GestiondesChaines" et que son point d'accès (URL) est http://www.monsite.fr:80/adelia/services/GestiondesChaines
Créer une entrée pour GESTIONCHAINES dans le fichier CfgWebServices.ini (ou CfgWebServices.properties) permet de modifier le point d'accès du service web à consommer. Le but de la manoeuvre est de modifier le point d'accès pour monitorer, sur la machine où s'exécute le programme de consommation (localhost), les messages envoyés et reçus par ce programme avec le service web.
Pour cela on modifie l'URL en précisant par exemple localhost:NumPortLocal
NumPortLocal est un numéro de port local TCP non encore utilisé libre par la machine. Nous prendrons de façon arbitraire la valeur de 5000 pour le port local.
Soit une redirection d'URL vers http://localhost:5000/adelia/services/GestiondesChaines
[cWebServices] GESTIONCHAINES=http://localhost:5000/adelia/services/GestiondesChaines
[Axis2 / à partir d'Adélia Studio 12]
. Créer (ou éditer) un fichier "cfgWebServices.xml" dans un répertoire se trouvant
- dans le PATH (contexte C)
- dans le CLASSPATH (contexte client java)
- dans WEB-INF\classes (contexte d'une webapp)
. Créer un élément <Service> et son élément fils <AdeliaName> précisant le nom Adélia du service à monitorer
. Créer un autre élément fils <Epr> précisant l'URL remappée du service web
<Configuration> ... <Service> <AdeliaName>NomAdeliaServiceWeb</AdeliaName> <Epr>URLremappée du service web</Epr> </Service> ... </Configuration>
Exemple :
Monitorer la consommation du service web de nom Adélia GESTIONCHAINES (Cf. base de connaissance).
On suppose que le nom réel du service web est "GestiondesChaines" et que son point d'accès (URL) est http://www.monsite.fr:80/adelia/servaxis2/GestiondesChaines
Créer une entrée pour GESTIONCHAINES dans le fichier cfgWebServices.xml permet de modifier le point d'accès du service web à consommer. Le but de la manoeuvre est de modifier le point d'accès pour monitorer, sur la machine où s'exécute le programme de consommation (localhost), les messages envoyés et reçus par ce programme avec le service web.
Pour cela on modifie l'URL en précisant par exemple localhost:NumPortLocal
NumPortLocal est un numéro de port local TCP non encore utilisé libre par la machine. Nous prendrons de façon arbitraire la valeur de 5000 pour le port local.
Soit une redirection d'URL vers http://localhost:5000/adelia/servaxis2/GestiondesChaines
<Configuration> ... <Service> <AdeliaName>GESTIONCHAINES</AdeliaName> <Epr>http://localhost:5000/adelia/servaxis2/GestiondesChaines</Epr> </Service> ... </Configuration>
Utilisation de TcpMon
a. Exécuter la commande suivante
java -classpath "%ADELIWS%\javarun\axis.jar" org.apache.axis.utils.tcpmon
b. La fenêtre suivante s'ouvre
c. Saisir la valeur 5000 dans le champ "Listen Port #", [Port de re-direction pour le monitoring]
Saisir les informations correpondant au point d'accès réel du service web pour le champ "Act as a...", "Listener"
Dans notre cas :
. Target hostname = www.monsite.fr
. Target port # = 80
puis appuyer sur le bouton [Add]
d. Cliquer sur l'onglet [Port 5000] nouvellement créé
e. Cocher, [Xml Format] et [Numeric]
f. Exécuter le programme de consommation du service web puis retourner dans TcpMon, les messages échangés sont consignés dans le panneau supérieur (envoi) et dans le panneau inférieur (réception).
Le panneau supérieur montre l'en-tête HTTP et le message SOAP envoyés vers le service web. Le message SOAP (XML) contient principalement la définition des paramètres d'entrée.
Le panneau inférieur montre l'en-tête HTTP et le message SOAP retournés par le service web vers le client. Le message SOAP (XML) contient principalement le(s) résultat(s) retourné(s) par le service web.
g. N'oubliez pas de supprimer ou de modifier le fichier CfgWebServices.ini (ou .properties) ou encore cfgWebServices.xml pour un retour à la normale
Articles connexes