Didacticiel 1 : Développer l’adaptateur Echo
Dans ce tutoriel, vous allez développer un adaptateur fonctionnel à l’aide du Kit de développement logiciel (SDK) de l’adaptateur métier WCF. L’adaptateur simule les opérations d’un système métier fictif pour illustrer un grand nombre des fonctionnalités clés du Kit de développement logiciel (SDK) WCF LOB Adapter, notamment :
Entrant synchrone
Trafic sortant synchrone
Métadonnées Parcourir
Recherche de métadonnées
Résolution des métadonnées
Cette section contient différentes fonctionnalités prises en charge par l’adaptateur d’écho. Il s’agit de l’échange de messages, des métadonnées d’opération, des propriétés de connexion et des propriétés d’adaptateur.
Modèles d’échange de messages
L’adaptateur écho prend en charge les deux modèles d’échange de messages suivants :
Le trafic sortant synchrone, autrement dit, le client consommateur envoie le message de demande WCF via l’adaptateur au système cible, puis attend de recevoir un message de réponse WCF du système cible via l’adaptateur. Il s’agit du modèle d’échange de messages le plus courant pour un adaptateur. Pour prendre en charge le trafic sortant synchrone, implémentez l’interface
Microsoft.ServiceModel.Channels.Common.IOutboundHandler.Entrant synchrone, c’est-à-dire que le client consommateur écoute les données ou les événements du système cible via l’adaptateur. Pour prendre en charge le trafic entrant synchrone, implémentez l’interface
Microsoft.ServiceModel.Channels.Common.IInboundHandler.Pour plus d’informations sur les modèles d’échange de messages, consultez Vue d’ensemble de l’architecture.
Notes
L’Assistant Développement d’adaptateur affiche le modèle d’échange de messages sous forme de flux de données dans l’interface utilisateur.
Prise en charge des métadonnées
L’adaptateur d’écho prend en charge les fonctionnalités de navigation, de recherche et de résolution des métadonnées. En règle générale, la navigation et la recherche récupèrent des opérations à partir d’un système métier. Pour l’adaptateur d’écho, un système métier est un ensemble d’opérations prédéfinies, comme indiqué ci-dessous :
EchoMainCategory
Echo/EchoStrings
Echo/EchoGreetings
Echo/EchoCustomGreetingFromFile
Echo/OnReceiveEcho
Voici la définition de chaque opération :
| Nom | Définition de l’opération | Description | Sens |
|---|---|---|---|
| EchoMainCategory | Category | Catégorise les opérations. | N/A |
| Echo/EchoStrings | string[] EchoStrings(string data) | Renvoie la chaîne entrante un nombre spécifié de fois au client appelant. | Règle de trafic sortant |
| Echo/EchoGreetings | Greeting[] EchoGreetings(Greeting Greeting) | Renvoie l’objet Greeting entrant un nombre spécifié de fois au client appelant. | Règle de trafic sortant |
| Echo/EchoCustomGreetingFromFile | CustomGreeting EchoCustomGreetingFromFile(Uri greetingInstancePath) | Fait écho à l’objet Greeting en lisant son instance à partir d’un fichier. Les métadonnées de l’objet Greeting sont obtenues à partir d’un fichier XSD prédéfini. | Règle de trafic sortant |
| Echo/OnReceiveEcho | void OnReceiveEcho(Chemin d’uri, contenu long) | Renvoie l’emplacement et la longueur d’un fichier déposé dans le dossier spécifié. | Trafic entrant |
Propriétés de l'adaptateur
L’adaptateur expose les propriétés de l’adaptateur suivantes.
| Nom | Catégorie | Type de données | Description |
|---|---|---|---|
| Count | Divers | System.Int32 | Utilisé pour faire écho à l’entrée le nombre spécifié de fois au client appelant. Valeur par défaut = 5 |
| ActiverConnectionPooling | Divers | System.Boolean | Permet d’activer ou de désactiver le regroupement de connexions pour l’adaptateur. Valeur par défaut = true, ce qui signifie que le regroupement de connexions est activé dans le moteur d’exécution du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF. |
| InboundFileFilter | Trafic entrant | System.String | Utilisé uniquement pour le scénario entrant et utilisé par FileSystemWatcher pour surveiller les fichiers de l’extension. Default=*.txt |
| InboundFileSystemWatcherFolder | Trafic entrant | System.String | Permet de définir le dossier dans lequel les fichiers seront supprimés pour FileSystemWatcher afin de déclencher une notification à l’adaptateur. Valeur par défaut = c :\inbound\watcher. |
Propriétés de connexion
L’adaptateur écho expose les propriétés de connexion suivantes.
| Nom | Type de données | Description |
|---|---|---|
| Application | System.String | Nom de l’application dans le système métier. Cette propriété est à des fins d’illustration. L’adaptateur écho n’implique aucun système métier. Valeur par défaut = lobapplication |
| Activer l’authentification | System.Boolean | Quand la valeur est true, l’adaptateur attend une valeur dans le champ nom d’utilisateur dans les informations d’identification du client. Valeur par défaut = false |
| HostName | System.String | Nom du serveur où réside un système métier. Cette propriété est à des fins d’illustration. L’adaptateur écho n’implique aucun système métier. Default = lobhostname |
Implémentation d’interface
Le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF définit une collection de classes et d’interfaces qui doivent être implémentées pour prendre en charge des fonctionnalités spécifiques de l’adaptateur. Le tableau suivant décrit ces classes et interfaces, leurs descriptions et quand les implémenter.
| Classe/interface | Quand implémenter | Description |
|---|---|---|
| Microsoft.ServiceModel.Channels.Common.IConnection | Si vous devez définir la connexion au système cible. | Définit la connexion au système cible. |
| Microsoft.ServiceModel.Channels.Common.IConnectionFactory | Si vous devez créer une connexion au système cible. | Crée la connexion au système cible. |
| Microsoft.ServiceModel.Channels.Common.ConnectionUri | Si vous avez besoin de gérer un URI de connexion. Si vous devez catégoriser la propriété de connexion dans l’outil Ajouter un plug-in de référence du service d’adaptateur. |
Gère un URI de connexion pour le système cible. |
| Microsoft.ServiceModel.Channels.Common.IMetadataResolverHandler | Votre adaptateur doit prendre en charge la fonctionnalité de résolution des métadonnées. | Résout les métadonnées d’opération et de type. |
| Microsoft.ServiceModel.Channels.Common.IMetadataSearchHandler | Si votre adaptateur prend en charge la fonctionnalité de recherche de métadonnées. | Recherche les opérations dans le système cible. |
| Microsoft.ServiceModel.Channels.Common.IMetadataBrowseHandler | Votre adaptateur doit prendre en charge la fonctionnalité de navigation | Recherche les opérations dans le système cible. |
| Microsoft.ServiceModel.Channels.Common.IOutboundHandler | Si votre adaptateur doit généralement prendre en charge la fonctionnalité sortante. | Transforme le message de requête WCF entrant en message système cible, appelle une fonction spécifique au système cible, puis transforme la réponse en message de réponse WCF sortant. |
| Microsoft.ServiceModel.Channels.Common.IInboundHandler | Si votre adaptateur prend en charge la fonctionnalité entrante. | Écoute les données et/ou les événements du système cible. |
Pour simplifier le développement de votre carte, utilisez l’Assistant Développement d’adaptateur pour générer votre projet d’adaptateur, qui crée un ensemble de classes dérivées adaptées aux fonctionnalités de votre adaptateur.
Pour personnaliser l’adaptateur et les propriétés de connexion via les outils Add Adapter Service Reference Plug-in et Consume Adapter Service Add-in, modifiez les fichiers suivants générés par l’Assistant Développement d’adaptateur.
{Nom du projet} BindingElement.cs
{Nom du projet} BindingElementExtensionElement.cs
{Nom du projet} ConnectionUri.cs
Pour plus d’informations sur la procédure à suivre, consultez Étape 2 : Catégoriser les propriétés de l’adaptateur et de la connexion.
Voir aussi
Tutoriels pour découvrir le Kit de développement logiciel (SDK) de l’adaptateur métier WCF