Le client de service générique permet de tester une plus grande variété de services Web que d'autres mécanismes de test, tels que des services Web JMS ou des services Web sécurisés.
Le client de service générique invoque des appels de tout type de service utilisant un transport HTTP, JMS ou WebSphere MQ et affiche le message renvoyé par le service. Il est utile pour déboguer ou tester un service lorsque vous n'avez pas accès à un client dédié pour invoquer l'appel de service. Vous pouvez configurer une grande variété de configurations de transport et de sécurité pour le service, éditez les paramètres de l'appel et envoyer des pièces jointes.
Pour des informations détaillées sur l'utilisation du client de service générique pour tester des services Web, voir la rubrique relative à l'envoi de demandes de service avec le client de service générique.
Services pris en charge
Le client de service générique peut appeler des demandes pour de nombreux types de service qui utilisent les protocoles de transport suivants :
- HTTP
- Java™ Message Service (JMS),
y compris les implémentations JBoss et WebSphere
- WebSphere MQ
Actuellement, le client de service générique ne prend pas en charge le test des services Web sécurisés.
Regardez une démonstration de l'utilisation du client de service générique pour tester un service Web : Testing web services with the Generic Service Client
Lancement du client de service générique
Vous pouvez lancer le client de service générique de plusieurs façons :
- Cliquez avec le bouton droit de la souris sur un fichier WSDL dans la vue Explorateur d'entreprise et sélectionnez .
- Cliquez avec le bouton droit de la souris sur un noeud de service dans la vue Services et sélectionnez Tester avec le client de service générique.
- Dans le menu Exécuter, sélectionnez Lancer le client de service générique.
- Dans les assistants de services Web, sélectionnez le client de service générique comme fonction de test. Vous pouvez aussi le définir comme fonction de test par défaut dans les préférences des services Web.
- Cliquez sur l'icône Lancer le client de service générique dans la barre d'outils :
Appel du client de service générique depuis un fichier WSDL
Avant de commencer, vérifiez que vous disposez d'un fichier WSDL (Web Services Description Language) valide dans votre espace de travail (et non d'un fichier WSDL généré tel que pris en charge dans les services Web JAX-WS). Vérifiez que les fichiers WSDL utilisent la syntaxe appropriée pour l'environnement de test.
Le client de service générique peut ne pas fonctionner avec certains fichiers WSDL.
Pour invoquer un appel de service en fonction d'un fichier WSDL, procédez comme suit :
- Lancez le client de service générique et ajoutez-lui un fichier WSDL si nécessaire. Le fichier WSDL est ajouté à la bibliothèque des appels.
- Dans la bibliothèque des appels, développez le fichier WSDL, la liaison
et l'opération, puis sélectionnez l'élément d'appel. L'appel est automatiquement configuré avec les noeuds finaux SOAP ou JMS disponibles dans le fichier WSDL. Le client de service générique présente trois étapes : Editer les données, Appeler et Afficher la réponse. Les détails pour l'appel sont affichés sous l'étape
Editer les données.
- Dans la page Message, utilisez les vues Formulaire,
Arborescence ou Source pour éditer le contenu de l'appel. Chaque vue affiche les mêmes données différemment. Pour ajouter ou supprimer des éléments XML dans la vue Formulaire ou Arborescence, cliquez sur pour assurer la conformité avec une définition de schéma XML (XSD) spécifiée dans le catalogue de schémas.
- Dans la page Pièces jointes, spécifiez tout fichier joint à envoyer avec l'appel. Vous devez d'abord configurer l'environnement avec les bibliothèques et les fichiers de configuration appropriés pour gérer les fichiers joints.
- Dans la page Transport, indiquez une configuration de
transport HTTP, JMS ou WebSphere MQ que l'appel doit utiliser. Vous pouvez créer et éditer des configurations de transport et de sécurité en
cliquant sur l'onglet
Transport.
- Dans les pages Sécurité pour la demande et
Sécurité pour la réponse, indiquez si vous voulez écraser les paramètres de sécurité
pour le fichier WSDL. Pour éditer les paramètres de sécurité en cours pour le fichier
WSDL, cliquez sur Modifier la sécurité WSDL pour ouvrir
l'éditeur de sécurité WSDL.
- Une fois que vous êtes prêt, cliquez sur Appeler pour appeler le service. Le client de service générique envoie la demande et affiche le message renvoyé sous l'étape Afficher la réponse.
Limitations :
Les tableaux ne sont pas pris en charge.
Suite à un manque
de spécification, les pièces jointes ne sont pas prises en charge avec le transport JMS
(Java Message
Service).
L'enveloppe est directement envoyée avec le codage UTF-8.
Tous
les algorithmes de sécurité ne sont pas toujours disponibles pour chaque
implémentation de l'environnement d'exécution Java.
Si une implémentation de
sécurité déterminée n'est pas disponible, ajoutez les bibliothèques obligatoires au
chemin d'accès aux classes de l'environnement JRE utilisé par ce produit.
Le
testeur de service générique affiche l'enveloppe, comme indiqué dans le document XML. Toutefois, les algorithmes de
sécurité considèrent l'enveloppe comme un élément binaire. Par conséquent, vous devez configurer la sécurité SOAP de sorte que les messages entrants et sortants soient correctement chiffrés mais demeurent déchiffrés dans le test.