Windows Communication Foundation (WCF)

Transcription

1 Windows Communication Foundation (WCF) Les chapitres du livre Avant-propos Les bases de WCF La création d un service WCF L hébergement d un service WCF La consommation d un service WCF Conclusion Pour plus d informations : Windows Communication Foundation (WCF) Maîtrisez la plateforme pas à pas 54 ISSN : sur : b Le projet Visual Studio de l exemple du livre. b Une base de données exemple. bu n fichier README.txt pour lier le projet VS à la base de données. b Des utilitaires. Loïc MONTAGNE est développeur, spécialiste des technologies Microsoft.Net depuis plus de 10 ans. La problématique de la mobilité au sein des entreprises l a conduit à s intéresser particulièrement à la plateforme WCF. À travers cet ouvrage c est toute l expérience qu il a acquise sur le sujet qu il transmet aux lecteurs. ISBN : Ce livre sur la plateforme WCF (Windows Communication Foundation) s adresse principalement aux développeurs connaissant déjà bien la plateforme Microsoft.Net et son outil de développement, Visual Studio et souhaitant maîtriser le développement d un service WCF. Les intégrateurs ou administrateurs réseaux ayant la volonté de bien comprendre comment configurer et déployer un service WCF pourront eux aussi tirer profit de ce livre, particulièrement grâce au chapitre 3 qui est dédié à l hébergement d un service WCF. L objectif de l auteur est de fournir les informations nécessaires pour rendre le lecteur le plus autonome possible dans le développement et le déploiement d un service WCF. Le livre est organisé en quatre chapitres qui offrent une trame logique en abordant toutes les étapes du cycle de vie d un service WCF. Le premier chapitre permet de faire un tour d ensemble de la plateforme WCF : Pourquoi a-t-elle été créée? Quels buts poursuit-elle? Dans quelle démarche globale s inscrit-elle? Quels sont ses avantages ou ses inconvénients? Quelles notions de bases est-il indispensable d acquérir? Quelles sont les étapes de sa mise en œuvre? Ce chapitre théorique apporte les bases solides nécessaires à la réussite de l apprentissage de l utilisation de la plateforme. Le second chapitre décrit toutes les briques techniques qui existent pour créer un service WCF. Ce chapitre montre comment réaliser un service WCF, de la création d un projet vierge aux tests finaux du service. Le troisième chapitre propose une description précise de ce que signifie héberger et configurer un service WCF. Les différents types d hébergement possibles sont ainsi expliqués et les configurations réalisables sont détaillées. Le quatrième chapitre explique quels sont les moyens techniques disponibles pour consommer un service WCF. Ce chapitre aborde aussitéléchargement quelques mécanismes qu il peut être intéressant de mettre en.fr placewww.editions-eni.fr dans une application consommant un tel service. Des éléments complémentaires sont en téléchargement sur le site WCF - Loïc MONTAGNE

2 Table des matières 1 Les éléments à télécharger sont disponibles à l'adresse suivante : Saisissez la référence de l'ouvrage EPWCF dans la zone de recherche et validez. Cliquez sur le titre du livre puis sur le bouton de téléchargement. Avant-propos Chapitre 1 Les bases de WCF 1. Présentation de WCF Définition et utilité Le fonctionnement du dialogue entre un client et un service WCF Les canaux Le cheminement des messages Les protocoles de transport Les formats d'échange Metadata Exchange (MEX) La sécurité des échanges WCF et services web : quelles différences? Notions de base de la communication entre applications Le point de terminaison de service L'ABC de la communication Les types de données transmissibles entre applications L'asynchronisme Mise en œuvre d'un service WCF Les étapes de mise en œuvre Les limites de la plateforme.net Les espaces de noms du framework.net

3 2 WCF Chapitre 2 La création d'un service WCF 1. Introduction Cas pratique : la création d un service de gestion de biens immobiliers Visual Studio Création d'un service sous Visual Studio Définition du contrat de service ServiceContract OperationContract DataContract DataMember Prise en charge des erreurs Exposition du service WCF via REST et JSON Mise en œuvre du contrat de service Implémentation du contrat de service Gestion d'une connexion à une base de données en mode asynchrone Prise en charge des erreurs Prise en charge du contexte REST Test du service WCF Chapitre 3 L'hébergement d'un service WCF 1. Les différents types d hébergement L'auto-hébergement L'hébergement sous IIS L'hébergement dans WAS Récapitulatif des hébergements

4 Table des matières 3 2. Le fichier de configuration Paramétrage du point de terminaison (endpoint) Le binding Le contrat L'adresse Paramétrage du comportement (behavior) Paramétrage de la publication des métadonnées (Metadata Exchange) Analyse détaillée d'un fichier de configuration Microsoft Service Configuration Editor Configuration pour REST Mise en œuvre de l'hébergement Via un serveur IIS Préparation du serveur IIS Création de l'hôte Hébergement de l'hôte dans IIS Via WAS Via une application WPF Chapitre 4 La consommation d'un service WCF 1. Référencement d'un service WCF Visual Studio La classe proxy Le fichier de configuration Le référencement d'un service sans métadonnées Écriture d'un client WCF Le choix de la technologie La création d'un projet L'appel aux méthodes du service WCF

5 4 WCF 2.4 L'utilisation des types de données fournis par le service WCF Les tests de l'application La gestion du mode asynchrone La gestion du mode déconnecté Conclusion Index

6 Chapitre 2 La création d'un service WCF 1. Introduction La création d'un service WCF Après toutes ces explications, il est temps de passer à la pratique afin de mettre en application tout ce qui a été vu jusqu'à maintenant. Dans ce chapitre, le but sera donc de nous servir de ces nouveaux acquis pour créer un service WCF. Pour cela, il faudra répondre à ces questions : Quel outil utiliser? Comment débuter la création d'un service WCF? Comment définir la liste des opérations accessibles par un client se connectant au service WCF? Comment faire transiter des données complexes du serveur vers le client ou inversement? Afin d'avoir une approche plus concrète, la réponse à ces questions se fera à travers la réalisation d'un projet précis.

7 36 WCF 2. Cas pratique : la création d un service de gestion de biens immobiliers Le projet qui sert d'exemple non seulement dans ce chapitre, mais aussi dans la suite de ce livre, est celui-ci : la création d'un service de gestion de biens immobiliers. L'objectif est de simplifier l'accès aux données à plusieurs agents immobiliers travaillant pour une même agence. Le but du service est donc d'accéder à une base de données contenant une liste de biens immobiliers. Chaque bien est défini par un identifiant unique. Il faut aussi définir le type de transaction (vente ou location), ainsi que différentes autres informations inhérentes à un bien immobilier : type de bien (maison, appartement, garage, terrain ), nombre de pièces, surface, type de chauffage, etc. Enfin, on doit également avoir la possibilité d'associer une ou plusieurs photos à un bien immobilier. Le service doit aussi permettre la mise à jour de la base de données, en fournissant aux agents immobiliers la possibilité d'ajouter, de modifier, ou de supprimer un bien immobilier. Et c'est tout. À charge ensuite au client de traiter les informations qui lui seront fournies par le service. Editions ENI - All rights reserved

8 La création d'un service WCF Chapitre 2 37 Afin de bien comprendre la structure de la base de données qui sera utilisée pour ce projet, voici un diagramme UML de celle-ci :

9 38 WCF Nous verrons plus loin comment cette base de données pourra être modélisée sous forme d'objet. Remarque Un exemple de base de données est proposé en téléchargement sur le site des Éditions ENI, ainsi que la solution complète de l'exemple de gestion de biens immobiliers contenant le service WCF, ses hôtes et son client. 3. Visual Studio Il existe plusieurs outils de développement permettant de créer un service WCF : Microsoft Visual Studio ; MonoDevelop ; SharpDevelop ; etc. L'outil le plus efficace et le plus agréable à utiliser est bien sûr Visual Studio. C'est en effet un des éditeurs les plus complets, qui simplifie beaucoup le développement, le débogage, les tests du service WCF. Les parties utilisées dans les exemples de cet ouvrage sont essentiellement l'explorateur de solutions, l'éditeur de code source, le débogueur, ainsi que l'éditeur graphique pour le client. Afin de pouvoir vous servir des exemples proposés, vous devez installer ce logiciel sur votre poste de travail (si ce n'est pas déjà fait), et être familiarisé avec son interface. Vous devez donc savoir où se situe l'explorateur de solutions par exemple, ou encore comment ajouter un point d'arrêt. Vous devez aussi être capable de lancer l'exécution d'un projet. Une version gratuite de Visual Studio est disponible à cette adresse : Editions ENI - All rights reserved

10 La création d'un service WCF Chapitre 2 39 Remarque Il est recommandé de démarrer Visual Studio en mode Administrateur, afin d'éviter des problèmes d'accès à la configuration d'iis (cf. chapitre L'hébergement d'un service WCF - Les différents types d hébergement). 4. Création d'un service sous Visual Studio Comme tout développement sous les technologies Microsoft.NET, il faut commencer par créer un projet sous Visual Studio. Une fois le logiciel démarré, voici la marche à suivre : dsélectionnez le menu Fichier - Nouveau - Projet. ddans la section Installé - Modèles, déroulez le langage que vous voulez utiliser, ici Visual C#. Ensuite, sélectionnez WCF, puis dans la partie centrale le modèle Bibliothèque de services WCF.

11 40 WCF ddonnez un Nom à votre projet (par exemple : ServiceAgence), choisissez l'emplacement d'enregistrement du projet et cliquez sur OK. À partir de là, Visual Studio se charge de créer un projet vierge, contenant tout ce qui est indispensable pour avancer dans la réalisation du service WCF. Détaillons un peu le contenu de la solution. Vous voyez apparaître trois fichiers importants : IService1.cs : il s'agit du contrat de service, que nous aborderons un peu plus loin (cf. section Définition du contrat de service plus loin dans ce chapitre). Service1.cs : c'est le service en lui-même, il implémente le contrat de service (cf. section Mise en œuvre du contrat de service plus loin dans ce chapitre). App.config : c'est le fichier de configuration, qui est très utile pour définir les paramètres de fonctionnement, d'accès, etc. (pour en savoir plus sur ce fichier, voir le chapitre L'hébergement d'un service WCF à la section Le fichier de configuration). Editions ENI - All rights reserved