Procédure pas à pas : conception d'un service Web

Mise à jour : novembre 2007

Cette procédure pas à pas présente les aspects clés de la conception d'un service Web à l'aide du Concepteur d'applications dans Visual Studio Team System Architecture Edition. Cette procédure pas à pas explique comment :

• définir des opérations sur un service Web existant ;

• implémenter le service Web ;

• ajouter un service Web externe (un service Web à l'extérieur de la solution) et afficher les méthodes Web sur celui-ci ;

• connecter le service Web externe à d'autres applications.

Cette procédure pas à pas repose sur les concepts présentés dans la rubrique de procédure pas à pas d'introduction, Procédure pas à pas : définition d'applications dans les diagrammes d'application.

Pour définir des opérations sur le service Web Catalog

1. Chargez l'exemple disponible à l'adresse https://go.microsoft.com/fwlink/?LinkId=40867.

2. Double-cliquez sur le fichier Catalog.ad pour ouvrir le diagramme d'application.

   Le Concepteur d'applications affiche le diagramme d'application.

3. Cliquez avec le bouton droit sur le point de terminaison CatalogWebService dans Catalog, puis cliquez sur Définir les opérations pour afficher la fenêtre Détails de service Web.

4. Dans la fenêtre Détails de service Web, cliquez sur <ajouter une opération> et tapez GetProductDetails.

5. Sous Type, entrez ProductDetails.

   Le type d'opération saisi indique le type de retour de l'opération.

6. Développez le signe plus (+) situé à gauche de GetProductDetails pour ajouter des paramètres à l'opération.

7. Cliquez sur <ajouter un paramètre> et tapez ProductNumber. Sous Type, tapez Integer.

   Remarque :
   Lorsque vous commencez à renseigner la colonne Type, Visual Studio affiche la liste des types disponibles.

   Cette opération utilise un numéro de produit entier et retourne une structure ProductDetails.

L'opération définie est demande-réponse par défaut. Pour plus d'informations sur la façon de modifier cette propriété, consultez Comment : spécifier des opérations unidirectionnelles ou de demande-réponse pour les services Web ASP.NET.

Pour définir des propriétés de projet et implémenter le service Web Catalog

1. Cliquez sur le point de terminaison CatalogWebService de l'application Catalog.

2. Consultez la fenêtre Propriétés.

3. Modifiez la propriété Nom de liaison WSDL sur Catalog.

4. Modifiez la propriété Espace de noms de liaison WSDL sur http://Adventureworks/Products.

5. Cliquez sur l'application Catalog et affectez la valeur Visual C# à la propriété Langage.

   Remarque :
   Si vous avez installé tous les langages avec Visual Studio, la valeur par défaut de la propriété est Visual Basic.

6. Avec l'application Catalog sélectionnée, pointez sur Implémentation dans le menu Diagramme, puis cliquez sur Implémenter une application..

   La boîte de dialogue Confirmer l'implémentation de l'application s'affiche.

7. Passez en revueles détails d'implémentation de l'application Catalog, puis cliquez sur OK.

   Le processus d'implémentation génère un projet pour l'application avec les références Web appropriées. Une fois l'implémentation terminée, l'application s'affiche avec une ombre portée.

   Remarque :
   Lorsque la boîte de dialogue Avertissement de sécurité s'affiche, cliquez sur Fermer. Cette boîte de dialogue indique que la chaîne de connexion à la base de données pour la base de données sur le diagramme d'application est écrite dans le fichier de configuration non chiffré et en texte brut.

8. Examinez les classes proxy et la référence Web dans l'Explorateur de solutions.

9. Ouvrez le fichier CatalogWebService.cs et examinez le code de la méthode Web ProductDetails.

   Notez que Visual Studio a défini le nom et l'espace de noms de liaison WSDL et a généré la signature de méthode.

10. Dans le code, remplacez le nom d'opération GetProductDetails par GetProductInformation.

11. Sélectionnez le point de terminaison CatalogWebService et affichez la fenêtre Détails de service Web.

    Le nom d'opération a été modifié dans la fenêtre Détails de service Web pour refléter la modification apportée à la signature de méthode Web dans le code. Toute modification apportée au code est automatiquement répercutée dans la fenêtre Détails de service Web, et vice versa.

Pour ajouter un service Web externe et afficher les méthodes Web

1. Ouvrez la boîte à outils et faites glisser un ExternalWebService vers le diagramme d'application.

   La boîte de dialogue Ajouter une référence Web s'affiche.

2. Recherchez l'emplacement de LegacyCatalog.wsdl sur votre ordinateur local.

3. Dans la zone URL, tapez cet emplacement, puis cliquez sur Aller à.

   La description du fichier WSDL apparaît avec la méthode qu'il définit.

4. Cliquez sur Ajouter une référence.

   Le service Web externe apparaît sur le diagramme d'application.

5. Cliquez sur le point de terminaison GetLegacyInfo.

6. Dans le menu Affichage, pointez sur Autres fenêtres, puis cliquez sur Détails de service Web pour afficher la fenêtre Détails de service Web.

7. Examinez la méthode Web affichée dans la fenêtre Détails de service Web.

   Ce fichier WSDL particulier contient des méthodes pour accéder à des informations dans un catalogue hérité (legacy).

Pour connecter le service Web externe au service Web Catalog

• En maintenant la touche ALT enfoncée, faites glisser le point de terminaison GetLegacyInfo du service Web externe vers la bordure de l'application Catalog.

  Cette action entraîne la création d'un point de terminaison consommateur dans Catalog, indiquant que l'application Catalog consomme des services fournis par LegacyInfo. Lors de l'implémentation de l'application Catalog, Visual Studio génère des classes proxy pour les méthodes Web définies sur le point de terminaison GetLegacyInfo.

  Visual Studio ajoute également à la solution un fichier .sdm pour le service Web externe. Ce fichier contient des définitions SDM pour cette application. Pour plus d'informations, consultez Vue d'ensemble du modèle de définition de système (SDM).

Étapes suivantes

L'étape suivante consiste à travailler davantage sur les points de terminaison de service Web. Pour plus d'informations, consultez Procédure pas à pas : conception de service Web par contrat - Création d'un point de terminaison.

Voir aussi

Autres ressources

Procédures pas à pas relatives à la conception de services Web