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 Reference pour générer une classe cliente 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 Utilitaire de métadonnées ServiceModel (svcutil.exe) pour générer la classe cliente 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 recherche et de navigation 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"

Procédez comme suit 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

1. Dans l’Explorateur de solutions Visual Studio, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.

2. 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 des opérations Oracle dans Visual Studio pour vous connecter à la base de données Oracle et rechercher et rechercher des opérations. Pour créer une classe de client WCF pour les opérations que vous sélectionnez, assurez-vous que le client (opérations sortantes) est sélectionné dans la liste déroulante Sélectionner le type de contrat (il s’agit de la valeur par défaut).

3. Après avoir sélectionné toutes les opérations que vous souhaitez cibler, cliquez sur OK pour générer la classe cliente WCF.

   Le plug-in Add Adapter Service Reference ajoute deux fichiers à votre projet :

• OracleDBBindingClient.cs. Ce fichier contient la classe cliente WCF générée et le code d’assistance 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 Reference, 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 ces 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 agit comme client. Vous devez donc implémenter un service WCF qui peut recevoir l’opération POLLINGSTMT 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 exposé 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 génération d’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

1. Dans l’Explorateur de solutions Visual Studio, cliquez avec le bouton droit sur votre projet, puis cliquez sur Ajouter une référence de service d’adaptateur.

2. 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 des opérations Oracle dans Visual Studio pour vous connecter à la base de données Oracle. Il existe plusieurs propriétés de liaison et une propriété URI que vous souhaiterez peut-être définir 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.

3. 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 le type de contrat .

4. Dans la zone Sélectionner une catégorie , cliquez sur le nœud racine (/) et 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.

5. 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) généré et le code d’assistance 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 de point de terminaison de service basée sur les sélections que vous avez effectuées lorsque vous avez configuré la liaison et la connexion pour le plug-in de référence du service d’adaptateur.

  Important

  Lors de l’utilisation du plug-in Visual Studio Add Adapter Service Reference, 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 cliente 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 l’outil Utilitaire de métadonnées ServiceModel avec l’adaptateur BizTalk pour Oracle Database.

Svcutil.exe génère la classe cliente 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 d’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