Configuration de l'accès aux données pour le client d'application

La configuration de l'accès aux données pour un client d'application implique de spécifier la référence de ressource et les informations relatives à la base de données associée. Cette spécification a lieu dans le cadre des étapes d'assemblage et de déploiement du client d'application.

Pourquoi et quand exécuter cette tâche

Deux outils sont essentiels à la configuration des sources de données utilisées par les clients d'application J2EE :
  • Un outil d'assemblage pour définir la référence de ressource dans le descripteur de déploiement ; et
  • l'outil Application Client Resource Configuration Tool (ACRCT) qui permet de définir la connexion à la base de données dans l'environnement de déploiement du client.

L'accès aux données à partir d'un client d'application utilise directement les fonctionnalités de connexion du pilote JDBC côté client. Elle n'exploite pas la prise en charge de la mise en pool des connexions disponibles dans le contexte d'exécution (runtime) de WebSphere Application Server. La configuration de l'accès aux données pour un client d'application ne nécessite pas de configurer un fournisseur JDBC et une source de données sur la machine du serveur WebSphere Application Server.

Si vous voulez que votre application client puisse tirer parti des fonctionnalités de mise en pool des connexions et des autres fonctions de base de données fournies par le produit, concevez-la de sorte qu'elle accède aux données en utilisant un bean enterprises'exécutant côté serveur.

Définition de la référence de ressource d'un client d'application à l'aide d'un outil d'assemblage

Procédure

  1. Assemblez le module client d'application conformément aux instructions fournies dans Assemblage des applications client Java EE.
  2. Créez une référence de ressource :
    1. Dans une vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le module client d'application et cliquez sur Ouvrir avec > Editeur de descripteur de déploiement.
    2. Dans l'onglet Références, cliquez sur Ajouter > Références de ressources > Suivant.
    3. Dans la page Références de ressources, entrez le nom de cette référence de ressource. Le contexte d'exécution du client d'application pour WebSphere Application Server utilise ce nom pour deux raisons : pour lier l'objet dans la partie java:comp/env de l'espace de nom JNDI et pour rechercher les informations de configuration spécifiques du client. Si le code du client d'application recherche java:comp/env/jdbc/myDB, le nom de la référence de ressource doit être jdbc/myDB.
    4. Pour Type, sélectionnez javax.sql.DataSource pour les connexions JDBC.
    5. Pour Authentification, sélectionnez Application si l'application client doit fournir des informations d'authentification. Si les informations d'authentification sont fournies par le module d'exécution du client d'application (comme indiqué par l'outil Application Client Resource Configuration Tool), sélectionnez Conteneur.
    6. Ne tenez pas compte du paramètre Portée du partage car il n'est pas utilisé dans une référence de ressource de client d'application. Toutes les ressources du client d'applications ne sont pas partagées.
    7. Cliquez sur Finish.
    8. Fermez le descripteur de déploiement et sauvegardez vos modifications.

Résultats

La zone du nom JNDI apparaît sous Liaisons WebSphere une fois qu'une référence a été ajoutée.

Configuration du client avec l'outil ACRCT

Pourquoi et quand exécuter cette tâche

Deux ressources sont à configurer dans l'outil ACRCT pour permettre l'accès aux données à partir d'un client d'application : un fournisseur de source de données et une source de données.
Restriction : Les objets suivants, qui peuvent être liés dans l'espace de nom du serveur, ne sont pas supportés dans le client :
  • Objets Java 2 Connector (J2C)
  • Objets gestionnaires de connexion

Le client d'application ne fournit pas de pilotes de bases de données pour les clients. Si votre application cliente accède directement à une base de données au lieu de passer par un bean enterprise s'exécutant sur le serveur d'applications, vous devez fournir le pilote de cette base de données sur la machine du client. Pour cela, il se peut que vous deviez contacter le fournisseur de votre base de données afin d'acquérir le code et la licence d'utilisation du pilote adéquat.

Au lieu que votre client d'application accède directement à la base de données, il est préférable qu'il utilise un bean enterprise. En effet, l'accès à travers un bean enterprise élimine la nécessité d'installer un pilote de base de données sur la machine du client, car l'accès à la base de données est alors pris en charge par le bean enterprise qui est exécuté sur le serveur d'applications. Les beans enterprise utilisés peuvent aussi tirer parti des fonctions de base de données additionnelles fournies par le contexte d'exécution.

Procédure

  1. Configurez un nouveau fournisseur de source de données en suivant les instructions de la rubrique Configuration de nouveaux fournisseurs de sources de données. Ce fournisseur décrit l'implémentation de base de données JDBC à votre application cliente.
  2. Entrez les informations suivantes dans l'onglet Général :
    1. nom de ce fournisseur de source de données,
    2. Facultatif : description.
    3. chemin d'accès (classpath) aux classes d'implémentation ou aux fichiers JAR du fournisseur de source de données. Cette information n'est pas indispensable si les classes d'implémentation ou les fichiers JAR se trouvent déjà dans le chemin d'accès aux classes du client.
    4. nom de la classe d'implémentation. Par exemple, dans le cas de DB2, la valeur est COM.ibm.db2.jdbc.DB2DataSource. N'oubliez pas que cette classe doit implémenter javax.sql.DataSource. L'outil ACRCT ne vérifie pas ce point. Aussi, vous recevrez une erreur à l'exécution de votre application client si la classe n'implémente pas javax.sql.DataSource.
    Utilisez l'onglet Personnalisé pour configurer les propriétés non standard du fournisseur de source de données. Cette page vous permet d'entrer des paires propriété-valeur. Lors de l'exécution, le nom de classe d'implémentation sera créé et les propriétés personnalisées ajoutées sur cette page seront définies, en utilisant la réflexion Java, sur l'objet source de données nouvellement créé. A chaque propriété spécifiée sur cette page doit correspondre une méthode de définition (set) dans la classe de la source de données. Considérons par exemple qu'une propriété use2Phase est définie et que sa valeur est 1. Dans la page Personnalisé, vous entrez la valeur use2Phase dans la colonne nom et la valeur 1 dans la colonne valeur. Le contexte d'exécution du client d'application utilise alors la réflexion pour rechercher une propriété dans la classe de la source de données, appelée généralement setUse2Phase, et l'appeler en lui transmettant la valeur 1. Consultez la documentation de votre base de données pour connaître les propriétés valides pour votre implémentation de source de données.
  3. Cliquez sur OK.
  4. Configurez une nouvelle source de données en suivant les instructions de la rubrique Configuration de nouvelles sources de données pour les clients d'application. Cette ressource décrit les propriétés de la base de données que votre application cliente utilise.
  5. Entrez les informations suivantes dans l'onglet Général :
    1. Un nom. Cette information est obligatoire. Il s'agit d'un nom destiné à l'usage de l'outil de configuration des ressources du client d'application. Ce nom n'est pas utilisé par votre programme d'application client.
    2. Facultatif : description.
    3. Un nom JNDI. Cette information est indispensable et doit correspondre à la valeur entrée dans la zone Nom de la page Ajout d'une référence de ressource de l'outil d'assemblage. Dans le cas de l'exemple précédent, définissez la valeur jdbc/myDB.
    4. Facultatif : Nom de la base de données.
    5. Facultatif : Votre ID utilisateur dans la zone Utilisateur.
    6. Facultatif : Votre mot de passe dans la zone Mot de passe. Le mot de passe saisi ne s'affiche pas.
    7. Votre mot de passe à nouveau pour le confirmer (dans la zone Confirmation du mot de passe). Remarque : Les données entrées dans les zones Utilisateur et Mot de passe ne sont utilisées que si vous avez choisi Conteneur dans la zone Authentification de la page Ajout d'une référence de ressource de l'outil d'assemblage.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tatk_condacli
Nom du fichier : tatk_condacli.html