Générer un client WCF ou un contrat de service WCF pour les artefacts de solution Oracle Database
Vous pouvez utiliser le plug-in Visual Studio Add Adapter Service pour générer une classe de client WCF ou un contrat de service WCF (interface) ciblant les opérations sélectionnées sur les artefacts de base de données Oracle. Vous pouvez également utiliser l’outil ServiceModel Metadata Utility Tool (svcutil.exe) pour générer la classe de client WCF ou le contrat de service WCF ; toutefois, le plug-in Add Adapter Service Reference expose les fonctionnalités de l’outil Utilitaire de métadonnées ServiceModel via une interface Microsoft Windows standard. Il fournit également des fonctionnalités de navigation et de recherche qui ne sont pas disponibles avec l’outil svcutil.exe, et génère un fichier de configuration basé sur les propriétés de liaison que vous sélectionnez lorsque vous vous connectez à la base de données Oracle.
Génération d’une classe cliente à l’aide du plug-in Add Adapter Service Reference
Effectuez les étapes suivantes pour générer une classe de client WCF à l’aide du plug-in Add Adapter Service Reference.
Pour générer une classe de client WCF
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence du service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence du service d’adaptateur ouverte, suivez les étapes décrites dans Récupérer les métadonnées pour les opérations Oracle dans Visual Studio pour vous connecter à la base de données Oracle et rechercher des opérations. Pour créer une classe de client WCF pour les opérations que vous sélectionnez, assurez-vous que Client (opérations sortantes) est sélectionné dans la liste déroulante Sélectionner un type de contrat (il s’agit de la valeur par défaut).
Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer la classe de client WCF.
Le plug-in Add Adapter Service Reference ajoute deux fichiers à votre projet :
OracleDBBindingClient.cs. Ce fichier contient la classe de client WCF et le code d’assistance générés pour les opérations que vous avez sélectionnées.
App.config. Ce fichier contient une configuration de liaison et des configurations de point de terminaison client. Ces configurations sont basées sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Service Reference.
Important
Lors de l’utilisation du plug-in Visual Studio Add Adapter Service, si vous ne spécifiez pas de valeur pour une propriété de liaison de type string et dont la valeur par défaut est null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Génération d’un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference
L’adaptateur expose les opérations entrantes pour permettre à la base de données Oracle d’envoyer des messages à un client d’adaptateur. Pour de telles opérations, vous devez générer un contrat de service WCF. Par exemple, l’adaptateur expose une opération POLLSTMT entrante pour interroger la base de données Oracle. L’adaptateur Oracle Database exécute la requête spécifiée par la propriété de liaison PollingStatement et envoie le jeu de résultats à l’application consommatrice dans un message POLLINGSTMT. Dans ce scénario, l’application consommatrice agit en tant que service et l’adaptateur Oracle Database en tant que client. Vous devez donc implémenter un service WCF qui peut recevoir l’opération POLLINGSTMT à partir de l’adaptateur. Pour ce faire, vous utilisez le plug-in Add Adapter Service Reference pour générer une interface .NET qui représente le contrat de service qui est mis en évidence par l’adaptateur pour l’opération POLLINGSTMT. Cette interface .NET est également appelée contrat de service WCF. Vous implémentez ensuite cette interface pour créer le service WCF que vous pouvez utiliser pour recevoir l’opération POLLINGSTMT.
Cette section fournit des informations sur la façon de générer un contrat de service WCF à l’aide du plug-in Add Adapter Service Reference pour les opérations entrantes exposées par l’adaptateur.
Pour générer un contrat de service WCF pour les opérations entrantes
Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence du service d’adaptateur.
Une fois la boîte de dialogue Ajouter une référence de service d’adaptateur ouverte, suivez les étapes décrites dans Récupérer les métadonnées pour les opérations Oracle dans Visual Studio pour vous connecter à la base de données Oracle. Vous pouvez définir plusieurs propriétés de liaison et une propriété URI lorsque vous vous connectez à la base de données Oracle pour les opérations entrantes. Par exemple, pour l’opération d’interrogation entrante (POLLINGSTMT), vous devez spécifier la propriété de liaison PollingStatement lorsque vous configurez la connexion à la base de données Oracle. L’adaptateur Oracle Database utilise l’instruction SQL SELECT spécifiée dans cette propriété pour générer la classe qui représente le jeu de résultats retourné par l’opération POLLINGSTMT.
Une fois que vous êtes connecté à la base de données Oracle, sélectionnez Service (opérations entrantes) dans la liste déroulante Sélectionner un type de contrat .
Dans la zone Sélectionner une catégorie , cliquez sur le nœud racine (/), puis accédez à l’opération pour laquelle vous souhaitez générer le contrat de service. Par exemple, pour l’opération d’interrogation, sélectionnez POLLINGSTMT dans la zone Catégories et opérations disponibles , puis cliquez sur Ajouter.
Pour générer le contrat de service WCF pour l’opération POLLINGSTMT, cliquez sur OK.
Le plug-in Add Adapter Service Reference ajoute trois fichiers à votre projet :
OracleDBBindingInterface.cs. Ce fichier contient le contrat de service WCF (interface) et le code d’assistance générés pour l’opération POLLINGSTMT.
OracleDBBindingService.cs. Ce fichier contient une classe qui implémente l’interface définie dans OracleDBBindingInterface.cs. Vous pouvez implémenter la logique métier qui traite les enregistrements retournés par la requête d’interrogation dans la méthode POLLINGSTMT de cette classe.
App.config. Ce fichier contient une configuration de liaison, des comportements de point de terminaison et une configuration du point de terminaison de service qui sont basés sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in Add Adapter Service Reference.
Important
Lors de l’utilisation du plug-in Visual Studio Add Adapter Service, si vous ne spécifiez pas de valeur pour une propriété de liaison de type string et dont la valeur par défaut est null, cette propriété de liaison ne sera pas disponible dans le fichier app.config. Vous devez ajouter manuellement la propriété de liaison et sa valeur dans le fichier app.config, si nécessaire.
Utilisation de svcutil.exe pour générer une classe de client WCF ou un contrat de service WCF
Vous pouvez utiliser svcutil.exe pour générer une classe de client WCF ou une interface de service WCF pour votre application. Vous devez configurer svcutil.exe pour l’utiliser avec l’adaptateur Oracle Database. Pour plus d’informations sur la configuration et l’utilisation de svcutil.exe avec l’adaptateur Oracle Database, consultez Utilisation de l’outil Utilitaire de métadonnées ServiceModel avec l’adaptateur BizTalk pour Oracle Database.
Svcutil.exe génère la classe de client WCF ou le contrat de service WCF dans un fichier de sortie. Le nom de fichier par défaut est output.cs. Vous devez inclure manuellement ce fichier dans votre projet Visual Studio.
Voir aussi
Développer des applications de base de données Oracle à l’aide du modèle de service WCF
Exécution des opérations d’insertion, de mise à jour, de suppression et de sélection de base dans SQL à l’aide du modèle de service WCF