Partager via


Composants clés du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF

Le développement d’un adaptateur à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF nécessite l’utilisation de la plupart des composants de base suivants :

  • Composants de connexion pour aider à établir et à maintenir une connexion au système métier.

  • Les composants de gestionnaire définissent et implémentent les procédures utilisées pour travailler avec les opérations de métadonnées et de messages entrants et sortants.

  • Les composants de métadonnées définissent et manipulent les métadonnées utilisées pour communiquer avec le système métier.

  • Les composants personnalisés prennent en charge les transactions, la messagerie fiable et la sécurité.

  • Les composants principaux relient tous les composants ensemble et garantissent une intégration transparente à WCF.

    Ces composants sont au centre de cette rubrique.

Composants de connexion

Les composants de connexion incluent des interfaces et des classes qui permettent de définir et de contrôler la durée de vie des connexions, ainsi que de gérer les attributs de requête uri (Uniform Resource Identifiers) et les attributs utilisateur. Les composants de connexion incluent les interfaces et les classes décrites dans le tableau suivant.

Composant de connexion Requis ? Description
Microsoft.ServiceModel.Channels.Common.ConnectionUri Obligatoire Classe de base pour fournir une expérience de création d’URI personnalisée pour les utilisateurs qui consommeront votre adaptateur.
Microsoft.ServiceModel.Channels.Common.IConnection Obligatoire Interface qui définit le comportement d’une connexion. Les développeurs doivent implémenter cette interface pour définir une connexion au système cible.
Microsoft.ServiceModel.Channels.Common.IConnectionFactory Obligatoire Classe de base pour une fabrique de connexion. Les développeurs effectuent une sous-classe lors de la définition de la fabrique de connexion pour le système cible.
Microsoft.ServiceModel.Channels.Common.ConnectionPoolSettings Facultatif Contient des paramètres qui contrôlent le comportement du pool de connexions. Les développeurs peuvent vouloir régler ces valeurs en fonction du comportement du système cible.
Microsoft.ServiceModel.Channels.Common.ConnectionManagerSettings Facultatif Contient des paramètres statiques qui contrôlent le comportement du pool de connexions. Les développeurs peuvent vouloir régler ces valeurs pour leur système cible.

L’Assistant Développement d’adaptateur métier WCF crée des implémentations de Microsoft.ServiceModel.Channels.Common.IConnection``Microsoft.ServiceModel.Channels.Common.ConnectionUri et Microsoft.ServiceModel.Channels.Common.IConnectionFactory quelles que soient les options de l’Assistant choisies. Ces implémentations contiennent du code pour les options de prise en charge choisies dans l’Assistant (y compris les propriétés de connexion dans l’URI de connexion), mais le développeur de l’adaptateur doit fournir des implémentations pour Open, Close et d’autres méthodes de Microsoft.ServiceModel.Channels.Common.IConnection et Microsoft.ServiceModel.Channels.Common.ConnectionUri.

Composants du gestionnaire

Les composants du gestionnaire prennent en charge différents modèles d’échange de messages, notamment les opérations entrantes, sortantes, asynchrones, sortantes, sortantes et de recherche, de navigation et de résolution des métadonnées. Les composants de gestionnaire incluent les interfaces et les classes décrites dans le tableau suivant.

Composant gestionnaire Requis ? Description
Microsoft.ServiceModel.Channels.Common.IAsyncInboundHandler Facultatif Utilisé pour recevoir des messages de manière asynchrone à partir du système cible. La prise en charge asynchrone est facultative.
Microsoft.ServiceModel.Channels.Common.IAsyncOutboundHandler Facultatif Utilisé pour envoyer des messages de manière asynchrone à partir du système cible. La prise en charge asynchrone est facultative.
Microsoft.ServiceModel.Channels.Common.IInboundHandler Facultatif Utilisé pour recevoir des messages du système cible. Les développeurs doivent implémenter ce gestionnaire si l’adaptateur doit écouter les messages du système cible.
Microsoft.ServiceModel.Channels.Common.IOutboundHandler Facultatif Prend en charge l’envoi de messages au système cible. Bien qu’elle soit facultative, elle est requise pour le modèle de message de demande-réponse. La plupart des technologies de communication fondamentales sont basées sur ce modèle, notamment HTTP, RPC et bien d’autres.
Microsoft.ServiceModel.Channels.Common.IMetadataBrowseHandler Facultatif Ce gestionnaire est implémenté lorsque l’adaptateur prend en charge l’accès aux métadonnées. Bien que facultatif, les développeurs implémentent souvent ce gestionnaire pour fournir une liste des opérations disponibles dans le système cible.
Microsoft.ServiceModel.Channels.Common.IMetadataResolverHandler Facultatif Ce gestionnaire doit être implémenté lorsque l’adaptateur récupère et retourne des métadonnées à partir du système cible qui représente des logiques et des types de données spécifiques au système. Les métadonnées peuvent être récupérées à partir du système cible réel ou elles peuvent être créées pour représenter les fonctionnalités du système cible. Par exemple, un adaptateur FTP peut créer des opérations GET et PUT.

Bien qu’il ne soit pas obligatoire, les développeurs implémentent généralement ce gestionnaire pour fournir des informations sur une opération spécifique.
Microsoft.ServiceModel.Channels.Common.IMetadataSearchHandler Facultatif Ce gestionnaire est implémenté lorsque l’adaptateur prend en charge la recherche de métadonnées.

L’Assistant Développement d’adaptateur crée des implémentations de Microsoft.ServiceModel.Channels.Common.IAsyncOutboundHandler, Microsoft.ServiceModel.Channels.Common.IOutboundHandlerMicrosoft.ServiceModel.Channels.Common.IInboundHandler et des gestionnaires de métadonnées en fonction des choix effectués par le développeur. Le code de support est fourni ; toutefois, le développeur de l’adaptateur doit fournir du code pour démarrer et arrêter l’écouteur entrant et tout autre code marqué par les commentaires TODO.

Composants de métadonnées

Les composants de métadonnées prennent en charge la gestion des demandes de métadonnées et la description des types et des opérations dans l’application cible. Les composants du gestionnaire contrôlent la façon dont les demandes de métadonnées sont traitées. Les composants de métadonnées décrivent les types de données et les opérations exposés par le système cible.

Les composants de métadonnées sont conçus pour contenir deux types d’informations de métadonnées : les métadonnées de type et les métadonnées d’opération.

  • Les métadonnées de type décrivent les types de données disponibles dans le système cible et incluent le nom du type, ses propriétés de tableau s’il s’agit d’un tableau et s’il s’agit d’un type de schéma XSD simple ou d’un type complexe.

  • Les métadonnées d’opération décrivent les opérations disponibles dans le système cible. Les propriétés incluent un type de retour, une liste de paramètres et le nom de l’opération.

    La prise en charge des métadonnées au sein d’un adaptateur est facultative, mais recommandée. L’un des avantages de l’utilisation du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF pour créer une carte par rapport à l’implémentation de fonctionnalités en tant que service WCF est la possibilité d’exposer et de se lier à un ensemble dynamique d’opérations.

Notes

Si vous devez exposer un ensemble limité de méthodes statiques, vous devez envisager d’utiliser WCF.

Les composants disponibles pour la gestion, la description et l’utilisation des métadonnées sont décrits dans le tableau suivant.

Composant métadonnées Description
Microsoft.ServiceModel.Channels.Common.ComplexQualifiedType Classe représentant un type qualifié complexe pour un adaptateur. Par exemple, si le système cible est une base de données relationnelle, une table, une ligne ou un type de retour de procédure défini par l’utilisateur peut tous être des types qualifiés personnalisés.
Microsoft.ServiceModel.Channels.Common.OperationMetadata Classe de base pour la représentation des métadonnées d’opération pour le système cible. Par exemple, vous pouvez sous-classer OperationMetadata pour contenir des informations sur les procédures stockées dans une carte ciblant une base de données relationnelle.
Microsoft.ServiceModel.Channels.Common.OperationMetadataTraceRecord Fournit un moyen de capturer les métadonnées d’opération dans un fichier de trace. La trace collecte des informations telles que l’ID unique, l’heure du dernier accès, l’horodatage, le nom d’affichage, le nom d’origine, les paramètres et d’autres détails.
Microsoft.ServiceModel.Channels.Common.ParameterizedOperationMetadata Fournit un moyen de définir les attributs d’une opération, tels que les paramètres et le type de retour.
Microsoft.ServiceModel.Channels.Common.OperationParameter Décrit un paramètre utilisé pour appeler une opération sur le système cible. Les propriétés incluent le nom, le nom d’origine, la direction du paramètre et un indicateur indiquant si le paramètre est vide ou non.
Microsoft.ServiceModel.Channels.Common.OperationParameterDirection Type énuméré qui décrit la direction d’un paramètre pour une opération. Un paramètre peut être entrant uniquement (In), sortant uniquement (Out) ou bidirectionnel (InOut).
Microsoft.ServiceModel.Channels.Common.OperationResult Représente un résultat d’opération. Peut être OperationResult.Empty pour les opérations qui retournent void ou null et une chaîne, un entier ou une autre valeur en fonction de l’opération.
Microsoft.ServiceModel.Channels.Common.QualifiedType Conçu pour être la classe de base pour les propriétés de type qualifiés et est utilisé pour décrire les propriétés des métadonnées de type pour un système cible.
Microsoft.ServiceModel.Channels.Common.QualifiedTypeContainer Fournit un conteneur pour un ensemble de types qualifiés associés.
Microsoft.ServiceModel.Channels.Common.SimpleQualifiedType Décrit les propriétés des métadonnées de type pour un système cible lorsque ce type est mappé directement à un type de schéma XSD W3C. Pour obtenir la liste des types autorisés, consultez Énumération XmlTypeCode.
Microsoft.ServiceModel.Channels.Common.TypeMember Permet de définir un membre de données simple ou complexe dans les métadonnées de type structuré.
Microsoft.ServiceModel.Channels.Common.TypeMetadata Classe de base pour la représentation des métadonnées de type pour le système cible.
Microsoft.ServiceModel.Channels.Common.StructuredTypeMetadata Permet de définir une structure de données qui contient des membres de type complexes et/ou simples.
Microsoft.ServiceModel.Channels.Common.TypeMetadataCollection Fournit un conteneur pour un ensemble de métadonnées de type associées.
Microsoft.ServiceModel.Channels.Common.TypeMetadataTraceRecord Fournit un moyen de capturer des métadonnées de type dans un fichier de trace. La trace collecte des informations telles que l’ID unique, l’heure du dernier accès, l’horodatage et d’autres détails.

Composants personnalisés

Les composants personnalisés prennent en charge les transactions, la sécurité, la messagerie fiable et d’autres fonctionnalités qui dépendent fortement du système cible. En tant que développeur d’adaptateurs utilisant le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF, vous devez comprendre les fonctionnalités du système cible et déterminer dans quelle mesure vous souhaitez les prendre en charge.

Composants principaux

Les composants principaux fournissent un ensemble de classes de base et d’interfaces qui permettent à l’adaptateur d’être branché à WCF. Les composants principaux sont décrits dans le tableau suivant.

Composant principal Requis ? Description
Microsoft.ServiceModel.Channels.Common.Adapter Obligatoire Classe de base d’un adaptateur écrit à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF. Il est chargé d’interagir avec l’architecture de canal WCF
Microsoft.ServiceModel.Channels.Common.AdapterBinding Obligatoire Classe qui contient des paramètres qui contrôlent différents paramètres de l’adaptateur, notamment le pool de connexions (Microsoft.ServiceModel.Channels.Common.ConnectionPoolSettings), le cache (Microsoft.ServiceModel.Channels.Common.CacheSettings), les métadonnées (Microsoft.ServiceModel.Channels.Common.MetadataSettings) et la messagerie (Microsoft.ServiceModel.Channels.Common.MessagingSettings).

Les adaptateurs personnalisés sont exposés via des liaisons WCF. Pour plus d’informations, consultez la documentation WCF à l’adresse https://go.microsoft.com/fwlink/?LinkId=100308.

L’Assistant Développement d’adaptateur crée des implémentations de Microsoft.ServiceModel.Channels.Common.Adapter, Microsoft.ServiceModel.Channels.Common.AdapterBinding, System.ServiceModel.Configuration.StandardBindingElementet System.ServiceModel.Configuration.StandardBindingCollectionElement pour exposer la liaison d’adaptateur au système de configuration WCF. L’Assistant Développement d’adaptateur génère également une implémentation de System.ServiceModel.Configuration.BindingElementExtensionElement pour activer Microsoft.ServiceModel.Channels.Common.Adapter l’utilisation dans une liaison personnalisée WCF à partir d’un fichier de configuration d’ordinateur ou d’application.

Pour plus d’informations sur StandardBindingElement, StandardBindingCollectionElement et BindingElementExtensionElement, consultez la documentation WCF.

Pour plus d’informations sur la configuration d’un adaptateur écrit avec le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF, consultez Déployer un adaptateur à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF.

Voir aussi

Comprendre le système métier avec le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF