Partager via

Configurer une liaison cliente pour la base de données Oracle

  • Article

Une fois que vous avez généré la classe de client WCF, vous pouvez créer un client WCF (instance) et appeler ses méthodes pour utiliser l’adaptateur Oracle Database. Pour plus d’informations sur la façon de générer la classe de client WCF et le code d’assistance pour les opérations exposées par l’adaptateur Microsoft BizTalk pour Oracle Database, consultez Générer un client WCF ou un contrat de service WCF pour oracle Database Solution Artifacts.

Pour créer le client WCF, vous devez spécifier une adresse de point de terminaison et une liaison. L’adresse du point de terminaison doit contenir un URI de connexion Oracle valide, et la liaison doit être une instance d’une liaison de base de données Oracle (OracleDBBinding). Pour plus d’informations sur l’URI de connexion Oracle, consultez Créer l’URI de connexion Oracle Database. Nous vous recommandons de ne pas spécifier les informations d’identification de l’utilisateur dans le cadre de l’URI de connexion. Vous pouvez plutôt utiliser la propriété ClientCredentials du client WCF, comme expliqué dans cette rubrique.

Vous pouvez spécifier la liaison de base de données Oracle et l’adresse du point de terminaison dans votre code ou dans un fichier de configuration. Lorsque vous utilisez le plug-in Visual Studio Add Adapter Service pour générer la classe de client WCF, un fichier de configuration (app.config) est également créé pour votre projet. Ce fichier contient des paramètres de configuration qui reflètent les propriétés de liaison et les informations de connexion (à l’exception des informations d’identification) que vous avez spécifiées lorsque vous vous êtes connecté à la base de données Oracle avec le plug-in Add Adapter Service Reference.

Spécification de la liaison et de l’adresse de point de terminaison dans le code

Le code suivant montre comment créer un client WCF en spécifiant la liaison et l’adresse de point de terminaison dans le code. Il est recommandé de spécifier les informations d’identification Oracle à l’aide de la propriété ClientCredentials du client WCF plutôt que dans l’URI de connexion fourni pour l’adresse du point de terminaison.

// A WCF client that targets the /SCOTT/EMP table is created  
// by using a binding object and endpoint address  
OracleDBBinding odbBinding = new OracleDBBinding();  
EndpointAddress odbAddress = new EndpointAddress("OracleDb://ADAPTER");  
  
SCOTTTableEMPClient empClient = new SCOTTTableEMPClient(odbBinding, odbAddress);  
  
empClient.ClientCredentials.UserName.UserName = "SCOTT";  
empClient.ClientCredentials.UserName.Password = "TIGER";  
  
empClient.Open();

Spécification de la liaison et de l’adresse de point de terminaison dans un fichier de configuration

Le code suivant montre comment créer un client WCF en spécifiant la liaison et l’adresse de point de terminaison dans un fichier app.config.

// A WCF client that targets the /SCOTT/EMP table is created  
// by specifying the client endpoint information in app.config  
SCOTTTableEMPClient empClient = new SCOTTTableEMPClient("OracleDBBinding_SCOTT.Table.EMP");  
  
empClient.ClientCredentials.UserName.UserName = "SCOTT";  
empClient.ClientCredentials.UserName.Password = "TIGER";  
  
empClient.Open();

Le code XML suivant montre le fichier de configuration créé pour la table EMP par le plug-in Add Adapter Service Reference. Ce fichier contient la configuration du point de terminaison client référencée dans l’exemple précédent.

\<?xml version="1.0" encoding="utf-8"?>  
<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">  
    \<system.serviceModel>  
        <bindings>  
            <oracleDBBinding>  
                <binding name="OracleDBBinding" closeTimeout="00:01:00" openTimeout="00:01:00"  
                    receiveTimeout="00:10:00" sendTimeout="00:01:00"  
                    dataFetchSize="65536" metadataPooling="true" statementCachePurge="false"  
                    statementCacheSize="10" longDatatypeColumnSize="32767" pollingStatement=""  
                    postPollStatement="" pollingInterval="500" useOracleConnectionPool="false"  
                    minPoolSize="1" maxPoolSize="100" incrPoolSize="5" decrPoolSize="1"  
                    connectionLifetime="0" transactionIsolationLevel="ReadCommitted"  
                    enablePerformanceCounters="false" acceptCredentialsInUri="false"  
                    enableBizTalkCompatibilityMode="false" />  
            </oracleDBBinding>  
        </bindings>  
        <client>  
            <endpoint address="oracledb://adapter/" binding="oracleDBBinding"  
                bindingConfiguration="OracleDBBinding" contract="SCOTTTableEMP"  
                name="OracleDBBinding_SCOTT.Table.EMP" />  
        </client>  
    \</system.serviceModel>  
</configuration>

Si un projet a plusieurs clients WCF, plusieurs entrées de point de terminaison client sont définies dans le fichier de configuration. Chaque entrée de client WCF aura un nom unique en fonction de sa configuration de liaison et de son artefact de base de données Oracle cible ; par exemple, « OracleDBBinding_SCOTT. Table.EMP ». Si vous vous connectez plusieurs fois pour créer les clients WCF dans votre projet, plusieurs entrées de configuration de liaison seront créées, une pour chaque connexion. Ces entrées de configuration de liaison seront nommées de la manière suivante : OracleDBBinding1, OracleDBBinding2, etc. Chaque entrée de point de terminaison client créée lors d’une connexion spécifique référencera l’entrée de liaison créée pendant cette connexion.

Voir aussi

Développer des applications de base de données Oracle à l’aide du modèle de service WCF
Générer un client WCF ou un contrat de service WCF pour oracle Database Solution Artifacts
Créer l’URI de connexion de base de données Oracle
Développer des applications de base de données Oracle à l’aide du modèle de canal WCF