Accès à des services Web XML à partir d'un navigateur

Article
04/11/2008

Après avoir publié un service Web XML créé à l'aide d'ASP.NET, vous pouvez tester sa fonctionnalité en utilisant un navigateur pour appeler l'une de ses méthodes. Pour cela, déployez votre service Web XML vers un serveur Web puis créez un lien vers le service à partir d'un navigateur. Une fois le fichier .asmx déployé vers un serveur Web, vous pouvez tester votre service Web XML dans un navigateur à l'aide de HTTP-GET ou HTTP-POST.

**Remarque **Par défaut, un service Web XML créé à l'aide d'ASP.NET peut prendre en charge de nombreux protocoles dont HTTP-GET, HTTP-POST et HTTP-SOAP.

Pour tester un service Web XML dans un navigateur à l'aide de HTTP-GET

Déployez votre service Web XML vers un serveur Web. Pour plus d'informations, consultez Publication et déploiement de services Web XML.

Accédez à un navigateur Web et entrez l'URL de votre service Web XML dans la barre d'adresses, selon le format suivant :

https://servername/apppath/webservicename.asmx

Paramètre	Valeur
servername	Nom du serveur sur lequel votre service Web XML a été déployé.
Apppath	Nom de votre répertoire virtuel et reste du chemin de l'application Web.
webservicename.asmx	Nom du fichier .asmx du service Web XML.

Le fichier de description HTML du service Web XML est affiché.

La page de description HTML du service Web XML vous montre toutes les méthodes prises en charge par un service particulier. Créez un lien vers la méthode de service Web XML souhaitée et entrez les paramètres nécessaires.

Supposez, par exemple, que vous avez publié un service Web XML appelé StockServices. StockServices contient une méthode de service Web XML appelée GetQuote qui requiert le symbole d'une action comme paramètre. Une fois publiée, l'URL de base de ce service est http://<nomserveur>/apppath/StockServices.asmx. Vous pouvez tester ce service en entrant la demande HTTP-GET suivante dans la ligne d'URL du navigateur :
```
http://<servername>/apppath/StockServices.asmx
```
Le serveur, en réponse à cette demande, affiche la page de description HTML du service Web XML. Cette page répertorie chaque méthode du service Web XML. Elle vous propose également un moyen de tester les méthodes et de voir leurs réponses XML.

Vous pouvez aussi être plus spécifique en entrant la méthode exacte que vous souhaitez tester. Vous pouvez par exemple entrer ce qui suit pour tester la méthode GetQuote de votre service :
```
http://<servername>/apppath/StockServices.asmx/GetStockQuote?tickerName=MSFT
```
Le serveur affiche une réponse XML qui donne le prix actuel de l'action que vous demandez. Si le type de données retourné pour GetQuote est un nombre à virgule flottante double précision, le résultat aura probablement l'apparence suivante :
```
<?xml version="1.0" ?>
<double>74.5</double>
```

Autre méthode de test d'un service Web XML dans un navigateur à l'aide de HTTP-GET

Déployez votre service Web XML vers un serveur Web. Pour plus d'informations, consultez Publication et déploiement de services Web XML.

Accédez à un navigateur Web et entrez l'URL pour votre service Web XML dans la barre d'adresses, selon ce format :

https://servername/vdir/webservicename.asmx/Methodname?parameter=value

Paramètre	Valeur
servername	Nom du serveur sur lequel votre service Web XML est déployé.
Apppath	Nom de votre répertoire virtuel et reste du chemin de l'application Web.
webservicename.asmx	Nom du fichier .asmx du service Web XML.
Methodname	Nom d'une méthode publique exposée par votre service Web XML. En l'absence de nom, la page de description du service Web XML s'affiche, répertoriant chaque méthode publique disponible dans le fichier .asmx. (Optionnel)
parameter	Nom et valeur appropriés pour les paramètres requis par votre méthode. En l'absence de nom, la page de description du service Web XML s'affiche, répertoriant chaque méthode publique disponible dans le fichier .asmx. (Optionnel)

Remarque Le nom de la méthode de service Web XML dans cette syntaxe respecte la casse mais les noms de serveur, de projet et de service Web XML ne la respectent pas.

Supposez par exemple que vous avez publié un service Web XML appelé StockServices. StockServices contient une méthode de service Web XML appelée GetQuote ; celle-ci accepte le symbole d'une action comme paramètre et retourne le prix sous la forme d'un nombre en virgule flottante double précision. Une fois publiée, l'URL de base de ce service est http://<nomserveur>/apppath/StockServices.asmx. Vous pouvez tester ce service en entrant la demande HTTP-GET suivante dans la ligne d'adresse du navigateur :

http://<servername>/apppath/StockServices.asmx/GetStockQuote?tickerName=MSFT

Le serveur affiche une réponse XML avec le prix actuel de l'action que vous demandez. Si le type de données retourné pour GetQuote est un nombre à virgule flottante double précision, le résultat aura probablement l'apparence suivante :

<?xml version="1.0" ?>
<double>74.5</double>

Pour tester un service Web XML dans un navigateur à l'aide de HTTP-POST

Pour tester un service Web XML à l'aide de HTTP-POST, vous devez créer une page HTML avec un formulaire dont l'attribut method a la valeur POST. Les étapes ci-dessous vous montrent comment créer un client HTTP-POST pour le service Web XML suivant.

<%@ WebService Language="C#" Class="Math" %>
using System.Web.Services;
public class Math : WebService {
     [ WebMethod ]
     public int Add(int num1, int num2) {
          return num1+num2;
     }

     [ WebMethod ]
     public int Subtract(int num1, int num2) {
          return num1-num2;
     }
}
[Visual Basic]
<%@ WebService Language="VB" Class="Math" %>
Imports System.Web.Services

Public Class Math
    Inherits WebService

    <WebMethod> _
    Public Function Add(num1 As Integer, num2 As Integer) As Integer
        Return num1 + num2
    End Function    
    
    <WebMethod> _
    Public Function Subtract(num1 As Integer, num2 As Integer) As Integer
        Return num1 - num2
    End Function
End Class

Déployez votre service Web XML vers un serveur Web. Pour plus d'informations, consultez Publication et déploiement de services Web XML.

Créez un document HTML avec un formulaire selon le format suivant :

   <form method=POST action='https://www.contoso.com/math.asmx/Subtract'>
       <input type="text" size="5" name='num1'\"></td> -
       <input type="text" size="5" name='num2'\"></td> =
       <input type=submit value="Subtract"> </td>
   </form>

Paramètre	Valeur
method	POST. Si vous souhaitez tester votre service Web XML à l'aide de HTTP-POST, utilisez POST.
action	URL vers la méthode de service Web XML. Dans l'exemple précédent, math.asmx est le service Web XML et `Subtract` est la méthode du service.
type="text"	Pour chaque paramètre de la méthode de service Web XML, créez les balises input avec "text" affecté à l'attribut de type. Ceci vous permet de taper une valeur de paramètre dans le contrôle d'entrée de texte.
name='num1'	Nom du paramètre de la méthode de service Web XML. Ajoutez autant de contrôles d'entrée de texte sur le formulaire qu'il y a de paramètres dans la méthode de service Web XML. Par exemple, si une méthode de service Web XML a trois paramètres, trois contrôles d'entrée de texte sont nécessaires et l'attribut name de chacun a pour valeur le nom du paramètre.
type=submit	Ajoutez un bouton Envoyer de sorte que vous puissiez renvoyer les données à la méthode.

Accédez à un navigateur Web et entrez l'URL pour le document HTML créé à l'étape précédente.

Le document HTML créé à l'étape précédente est affiché.
Entrez les valeurs appropriées pour la méthode de service Web XML dans les zones de texte puis cliquez sur le bouton envoyer.

Par exemple, si vous avez entré 6, puis 3 dans les deux zones de texte de la méthode Subtract ci-dessus, le résultat suivant est retourné :
```
<?xml version="1.0" ?> 
<int xmlns="http://tempuri.org/">3</int>
```

Voir aussi

Création de clients de service Web XML | Découverte des services Web XML | Création de clients pour les services Web XML | Exploration des services Web XML existants créés à l'aide d'ASP.NET | Accès à des services Web XML à partir d'un navigateur

Partager via

Accès à des services Web XML à partir d'un navigateur

Voir aussi

Ressources supplémentaires