Procédure pas à pas : création de services Web substituables

Mise à jour : novembre 2007

Cette procédure pas à pas explique comment dupliquer un service Web défini précédemment pour l'utiliser comme substitut. Cette application a été implémentée dans Procédure pas à pas : conception d'un service Web.

Composants requis

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

Pour créer une copie d'un service Web existant

1. Ouvrez Catalog.sln.

2. Consultez le diagramme d'application.

3. Cliquez avec le bouton droit sur l'application Catalog et cliquez sur Copier.

4. Collez l'application copiée dans le diagramme d'application.

5. Nommez la version collée CatalogFacade.

   CatalogFacade inclut les points de terminaison CatalogWebService et GetLegacyInfo apparaissant dans Catalog. Par conséquent, CatalogFacade est compatible avec toutes les applications compatibles avec Catalog. Toutes les connexions établies entre Catalog et d'autres applications, telles que CatalogDB, sont conservées. Toutefois, contrairement à Catalog, CatalogFacade n'apparaît pas comme implémentée.

   Remarque :
   Visual Studio ne copie pas certains paramètres entre les applications. En conséquence, bien que la connexion à la base de données soit conservée graphiquement, elle ne fonctionnera pas lors de l'exécution car Visual Studio ne copie pas certains éléments, tels que le mot de passe. Pour activer cette connexion, vous devez entrer les informations de connexion entre CatalogFacade et CatalogDB.

Vous pouvez donc utiliser l'application CatalogFacade en tant que service Web wrapper pour un catalogue hérité implémenté dans une application héritée non modélisée par les Concepteurs de systèmes distribués. Vous pouvez également représenter des applications héritées comme celle-ci dans le diagramme d'application à l'aide du type d'application générique. Par exemple, une telle application peut être un système de livre comptable qui s'exécute sur un ordinateur AS/400.

Vous allez maintenant modéliser une application héritée à l'aide du type d'application Générique.

Pour modéliser une application héritée (legacy)

1. À partir de la boîte à outils, faites glisser une application GenericApplication vers le diagramme et nommez-la LegacyCatalog.

2. À partir de la boîte à outils, faites glisser un point de terminaison .NETWebServiceEndpoint vers CatalogFacade et nommez-le LegacyInterface.

3. Tout en maintenant la touche ALT enfoncée, faites glisser le point de terminaison LegacyInterface vers LegacyCatalog pour les connecter.

   Un nouveau point de terminaison consommateur apparaît sur LegacyCatalog. LegacyCatalog est un espace réservé d'application pour l'ancien catalogue. Visual Studio ne génère pas de code pour LegacyCatalog. Toutefois, sa présence dans le diagramme documente l'existence de l'application héritée et de sa connexion au service Web CatalogFacade qui encapsule sa fonctionnalité. La procédure suivante montre comment CatalogFacade et Catalog fournissent le même contrat.

Pour concevoir un système de catalogue

1. Maintenez la touche MAJ enfoncée et cliquez sur Catalog et CatalogDB.

2. Dans le menu Diagramme, choisissez Concevoir un système d'applications.

3. La boîte de dialogue Concevoir un système d'applications s'affiche.

4. Sous Nom du système, tapez NewCatalogSystem.

   Le Concepteur de systèmes s'ouvre avec les applications sélectionnées incluses dans le nouveau système. Ajustez l'emplacement des applications selon vos besoins.

5. Cliquez avec le bouton droit sur le point de terminaison CatalogWebService et sélectionnez Ajouter un point de terminaison proxy.

   Cette action crée une voie de communication dans ce système.

6. Consultez le diagramme d'application.

7. Cliquez avec le bouton droit sur SalesWebClient, puis cliquez sur Concevoir un système d'applications.

8. Nommez le système CatalogSystem.

9. À partir de la fenêtre Vue système, faites glisser NewCatalogSystem dans CatalogSystem.

   Remarquez que NewCatalogSystem expose un point de terminaison afin que vous puissiez connecter le système. Ce point de terminaison est le point de terminaison proxy créé précédemment. Il fournit la connectivité à CatalogWebService de Catalog.

10. Connectez le point de terminaison proxy CatalogWebService de NewCatalogSystem au point de terminaison consommateur de SalesWebClient.

11. Consultez le diagramme d'application.

12. Créez un système contenant CatalogFacade et LegacyCatalog et nommez-le LegacyCatalogSystem.

13. Créez un point de terminaison proxy pour CatalogWebService dans LegacyCatalogSystem.

14. Affichez le système CatalogSystem.

15. Supprimez le système NewCatalogSystem de CatalogSystem.

16. À partir de la fenêtre Vue système, faites glisser le système LegacyCatalogSystem dans le système CatalogSystem.

17. Connectez le point de terminaison CatalogWebService du système LegacyCatalogSystem au point de terminaison consommateur de SalesWebClient.

    Les systèmes NewCatalogSystem et LegacyCatalogSystem contiennent chacun le point de terminaison CatalogWebService que vous avez exposé en tant que point de terminaison proxy. Vous pouvez donc remplacer les systèmes l'un par l'autre dans CatalogSystem.

Vous allez maintenant créer un prototype réutilisable d'une application contenant CatalogWebService et utilisant Visual C# comme langage par défaut. Vous pouvez ajouter ce prototype à la boîte à outils.

Pour créer un prototype réutilisable

1. Consultez le diagramme d'application.

2. À partir de la boîte à outils, faites glisser une application ASP.NETWebService vers le diagramme.

3. Copiez le point de terminaison CatalogWebService de Catalog et collez-le sur la nouvelle application de service Web ASP.NET.

4. Affectez la valeur Visual C# à la propriété Langage.

5. Dans le menu Diagramme, choisissez Ajouter à la boîte à outils.

   La boîte de dialogue Ajouter à la boîte à outils s'affiche.

6. Dans la zone Nom, tapez CatalogWebServiceApp et cliquez sur OK.

   La boîte de dialogue Enregistrer le fichier s'affiche. Visual Studio enregistre le fichier en tant que fichier .adprototype, correspondant au fichier de prototype d'application utilisé dans le Concepteur d'applications.

7. Cliquez sur Enregistrer.

8. Ouvrez la boîte à outils et faites glisser CatalogWebServiceApp vers le diagramme.

Vous avez créé une version réutilisable et personnalisée de l'application de service Web ASP.NET incluant également le point de terminaison CatalogWebService. Ce prototype apparaît dans la boîte à outils lorsque vous créez une solution de systèmes distribués.

Vous pouvez partager ce prototype avec d'autres utilisateurs du Concepteur de systèmes distribués en l'exportant à un emplacement partagé. Pour plus d'informations, consultez les rubriques suivantes :

• Comment : créer des prototypes personnalisés à partir d'applications configurées et de points de terminaison

• Comment : exporter des prototypes personnalisés de concepteurs de systèmes distribués

Étapes suivantes

Procédure pas à pas : représentation de connexions de service Web indirectes

Voir aussi

Autres ressources

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