Guide du développeur d`applications bases de données

Guide du développeur
d’applications
bases de données
VERSION 8
Borland®
JBuilder®

Consultez le fichier deploy.html situé dans le répertoire redist de JBuilder pour avoir la liste complète des fichiers
que vous pouvez distribuer en accord avec votre contrat de licence JBuilder.
Les applications mentionnées dans ce manuel sont brevetées par Borland Software Corporation ou en attente de
brevet. Reportez-vous au CD ou à la boîte de dialogue A propos. Ce document ne donne aucun droit sur ces
brevets.
COPYRIGHT © 1997–2002 Borland Software Corporation. Tous droits réservés. Tous les produits Borland sont des
marques commerciales ou des marques déposées de Borland Software Corporation aux Etats-Unis et dans les
autres pays. Toutes les autres marques sont la propriété de leurs fabricants respectifs.
Pour connaître les conditions et limites des fournisseurs tiers, lisez les Remarques version sur votre CD JBuilder.
JBE0080WW21002database 7E10R1002
0203040506-9 8 7654321
PDF

i
Chapitre 1
Introduction 1-1
Résumé des chapitres . . . . . . . . . . . . . . . 1-2
Tutoriels sur les bases de données . . . . . . . . 1-4
Exemples de bases de données . . . . . . . . . . 1-5
Documentation annexe . . . . . . . . . . . . . . 1-6
Conventions de la documentation . . . . . . . . 1-9
Support et ressources destinés
aux développeurs . . . . . . . . . . . . . . . . 1-11
Comment contacter le support technique
de Borland. . . . . . . . . . . . . . . . . . . 1-11
Ressources en ligne. . . . . . . . . . . . . . . 1-11
World Wide Web . . . . . . . . . . . . . . . .1-12
Groupes de discussion Borland. . . . . . . .1-12
Groupes de discussion Usenet . . . . . . . .1-12
Rapports de bogues . . . . . . . . . . . . . .1-13
Chapitre 2
Les applications
de bases de données JBuilder 2-1
Architecture des applications
de bases de données . . . . . . . . . . . . . . . 2-1
Composants DataExpress . . . . . . . . . . . . . 2-2
Principales fonctionnalités et avantages . . . 2-3
Présentation des composants DataExpress . 2-5
Composants DataExpress pour EJB . . . . . . . 2-9
InternetBeans Express . . . . . . . . . . . . . . .2-10
Composants de bases de données XML . . . . .2-10
dbSwing. . . . . . . . . . . . . . . . . . . . . . .2-10
Modules de données et modeleur
de données . . . . . . . . . . . . . . . . . . . .2-12
Pilote de base de données. . . . . . . . . . . . .2-12
Moniteur JDBC. . . . . . . . . . . . . . . . . . .2-12
JDataStore et JBuilder . . . . . . . . . . . . . . .2-13
Utilisation d’un JDataStore
ou d’un pilote JDBC . . . . . . . . . . . . .2-13
Avantages supplémentaires apportés
par JDataStore. . . . . . . . . . . . . . . . .2-14
Utilisation de l’explorateur JDataStore. . . .2-14
Opérations avec l’explorateur
JDataStore . . . . . . . . . . . . . . . . .2-15
InterBase et JBuilder . . . . . . . . . . . . . . . . 2-16
Chapitre 3
Importation et exportation
des données d’un fichier texte 3-1
Ajout de colonnes à un TableDataSet
en utilisant l’éditeur. . . . . . . . . . . . . . . . 3-2
Importation des données formatées
d’un fichier texte . . . . . . . . . . . . . . . . . 3-2
Récupération de données d’une source JDBC . . 3-3
Exportation des données . . . . . . . . . . . . . . 3-3
Exportation des données d’un QueryDataSet
dans un fichier texte. . . . . . . . . . . . . . 3-4
Enregistrement des modifications
d’un TableDataSet dans une table SQL . . . 3-5
Enregistrement dans une source de données
JDBC des modifications chargées
depuis un TextDataFile . . . . . . . . . . . . 3-5
Chapitre 4
Connexion à une base de données 4-1
Connexion aux bases de données . . . . . . . . . 4-2
Ajout d’un composant Database
à votre application. . . . . . . . . . . . . . . 4-3
Définition des propriétés de connexion
du composant Database. . . . . . . . . . . . 4-4
Configuration de JDataStore. . . . . . . . . . . . 4-7
Configuration d’InterBase et InterClient . . . . . 4-7
Utilisation d’InterBase et d’InterClient
avec JBuilder . . . . . . . . . . . . . . . . . . 4-8
Astuces pour l’utilisation des tables
InterBase exemple . . . . . . . . . . . . . . . 4-9
Ajout d’un pilote JDBC à JBuilder . . . . . . . 4-10
Création des fichiers .library et .config . . . 4-10
Ajout du pilote JDBC aux projets . . . . . . 4-11
Connexion à une base de données
en utilisant des pilotes JDBC InterClient . . . 4-13
Utilisation du composant Database
dans votre application . . . . . . . . . . . . . 4-16
Sollicitation d’un nom d’utilisateur
et d’un mot de passe . . . . . . . . . . . . . . 4-16
Mise en pool des connexions JDBC . . . . . . . 4-17
Optimisation des performances
de JConnectionPool . . . . . . . . . . . . . 4-20
Sorties historiques. . . . . . . . . . . . . . . 4-20
Exemple de mise en pool . . . . . . . . . . . 4-20
Table des matières

ii
En cas de problème lors des connexions
de JDataStore et d’InterBase . . . . . . . . . .4-23
Messages d’erreur de connexion courants. .4-23
Chapitre 5
Extraction des données
d’une source de données 5-1
Interrogation d’une base de données . . . . . . 5-2
Définition des propriétés
dans la boîte de dialogue query. . . . . . . 5-4
La page Requête . . . . . . . . . . . . . . 5-5
La page Paramètres. . . . . . . . . . . . . 5-6
Placer le texte SQL
dans l’ensemble de ressources. . . . . . 5-7
Interrogation d’une base de données :
trucs & astuces . . . . . . . . . . . . . . . .5-10
Amélioration des performances
des ensembles de données . . . . . . . .5-10
Persistance des métadonnées
d’une requête . . . . . . . . . . . . . . . 5-11
Ouverture et fermeture
des ensembles de données . . . . . . . .5-12
Comment s’assurer
qu’une requête est modifiable . . . . . .5-12
Utilisation de requêtes paramétrées pour obtenir
des données d’une base de données . . . . . .5-13
Paramétrage d’une requête . . . . . . . . . .5-13
Création de l’application. . . . . . . . . .5-14
Ajout d’un composant ParameterRow . .5-15
Ajout d’un QueryDataSet . . . . . . . . .5-15
Ajout des composants
d’interface utilisateur . . . . . . . . . . .5-16
Requêtes paramétrées trucs & astuces . . . .5-19
Utilisation de paramètres . . . . . . . . .5-19
Ré-exécution d’une requête a
vec des paramètres modifiés. . . . . . .5-22
Requêtes paramétrées dans les relations
maître-détail . . . . . . . . . . . . . . . .5-22
Chapitre 6
Utilisation
des procédures stockées 6-1
Procédures stockées : trucs & astuces . . . . . . 6-3
Séquences d’échappement,
instructions SQL et appels de procédure
spécifiques au serveur . . . . . . . . . . . . 6-3
Création manuelle des tables et procédures
de ce tutoriel . . . . . . . . . . . . . . . . . 6-4
Utilisation des procédures stockées
spécifiques à un fournisseur . . . . . . . . . . 6-6
Utilisation avec JDataStore de procédures
stockées et de fonctions définies
par l’utilisateur. . . . . . . . . . . . . . . . . 6-7
Utilisation de procédures stockées
InterBase . . . . . . . . . . . . . . . . . . . . 6-7
Utilisation de paramètres avec des procédures
stockées Oracle PL/SQL . . . . . . . . . . . 6-7
Utilisation des procédures stockées Sybase . 6-9
Exemple d’application avec des procédures
stockées spécifiques au serveur
de la base de données . . . . . . . . . . . . . 6-9
Ecriture d’un fournisseur
de données personnalisé . . . . . . . . . . . . . 6-9
Obtention des métadonnées . . . . . . . . . 6-10
Appel de initData . . . . . . . . . . . . . 6-11
Obtention des données réelles . . . . . . . . 6-12
Conseils pour la conception d’un fournisseur
de données personnalisé . . . . . . . . 6-12
Explication de la méthode provideData()
dans des ensembles de données
maître-détail . . . . . . . . . . . . . . . 6-12
Chapitre 7
Manipulation des colonnes 7-1
Présentation des propriétés et métadonnées
de colonne . . . . . . . . . . . . . . . . . . . . . 7-1
Propriétés d’une colonne
qui ne sont pas des métadonnées . . . . . . 7-2
Visualisation des informations de colonnes
dans le concepteur de colonne . . . . . . . . 7-2
Bouton Créer une classe RowIterator . . . . . 7-3
Utilisation du concepteur de colonne
pour rendre persistantes des métadonnées . 7-4
Utilisation du concepteur de colonne pour
rendre dynamiques des métadonnées. . . . 7-5
Visualisation des informations des colonnes
dans le pilote de base de données . . . . . . 7-5
Optimisation d’une requête . . . . . . . . . . . . 7-7
Définition des propriétés d’une colonne . . . 7-7
Définition des propriétés des colonnes
en utilisant les outils de conception
visuelle de JBuilder . . . . . . . . . . . . 7-7
Définition des propriétés dans le code . . 7-7
Colonnes persistantes. . . . . . . . . . . . . . 7-8
Combinaison de métadonnées dynamiques
et de colonnes persistantes . . . . . . . . . . 7-9
Suppression des colonnes persistantes . . . . 7-9
Utilisation de colonnes persistantes
pour ajouter des colonnes vides
à un ensemble de données . . . . . . . 7-10
Contrôle de l’ordre des colonnes
dans un ensemble de données . . . . . . . 7-11

iii
Chapitre 8
Enregistrement des modifications
dans la source de données 8-1
Enregistrement des modifications
d’un QueryDataSet. . . . . . . . . . . . . . . . 8-3
Ajout d’un bouton pour enregistrer des
modifications depuis un QueryDataSet . . 8-4
Enregistrement des modifications dans la source
de données par une procédure stockée . . . . 8-6
Enregistrement des modifications
avec un QueryResolver . . . . . . . . . . . 8-6
Codage de procédures stockées
pour gérer la résolution de données . . . . . . 8-8
Enregistrement des modifications
avec un ProcedureResolver . . . . . . . . . 8-9
Exemple : Utilisation de procédures stockées
InterBase avec paramètres de retour . . . .8-12
Résolution des données de plusieurs tables . . 8-12
Remarques sur les types de liaisons
entre les tables d’une requête . . . . . . . .8-13
Références (alias) de tables et de colonnes
dans une chaîne de requête . . . . . . . . .8-14
Contrôle du paramétrage des propriétés
de colonne . . . . . . . . . . . . . . . . . . .8-14
Que faire si une table
n’est pas modifiable ? . . . . . . . . . . . .8-15
Comment spécifier qu’une table
ne doit pas être actualisée ? . . . . . . . . .8-15
Utilisation des ensembles de données avec RMI
(mise en flux) . . . . . . . . . . . . . . . . . . .8-15
Exemple : Utilisation de flux
d’ensembles de données . . . . . . . . . . .8-16
Utilisation des méthodes de flux
d’ensemble de données . . . . . . . . . . .8-16
Personnalisation de la logique de résolution
par défaut . . . . . . . . . . . . . . . . . . . . . 8-17
Explication de la résolution par défaut . . .8-18
Ajout d’un composant QueryResolver . . 8-19
Interception des événements
de résolution. . . . . . . . . . . . . . . .8-19
Utilisation des événements
de résolution. . . . . . . . . . . . . . . .8-21
Ecriture d’un résolveur de données
personnalisé. . . . . . . . . . . . . . . . . .8-22
Gestion des erreurs de résolution . . . . .8-23
Résolution des relations maître-détail . .8-24
Chapitre 9
Etablissement
d’une relation maître-détail 9-1
Définition d’une relation maître-détail . . . . . . 9-2
Création d’une application
avec une relation maître-détail. . . . . . . . 9-3
Lecture des détails . . . . . . . . . . . . . . . . . 9-7
Lecture de tous les détails en une seule fois . 9-8
Lecture des enregistrements détail
sélectionnés à la demande . . . . . . . . . . 9-8
Modification des données dans les ensembles
de données maître-détail . . . . . . . . . . . . 9-10
Etapes de la création d’une relation
maître-détail . . . . . . . . . . . . . . . . . . . 9-10
Enregistrement des modifications
dans une relation maître-détail . . . . . . . . 9-11
Résolution des ensembles de données
maître-détail avec une source JDBC . . . . 9-13
Chapitre 10
Utilisation des modules de données pour
simplifier l’accès aux données 10-1
Création d’un module de données
en utilisant les outils de conception . . . . . . 10-2
Création du module de données
avec l’expert . . . . . . . . . . . . . . . . . 10-2
Ajout de composants données
à un module de données . . . . . . . . . . 10-3
Ajout de la logique métier
au module de données . . . . . . . . . . . 10-5
Utilisation d’un module de données . . . . 10-5
Ajout d’une bibliothèque nécessaire
à un projet. . . . . . . . . . . . . . . . . 10-6
Référencement d’un module de données
dans votre application. . . . . . . . . . 10-7
La boîte de dialogue Expert utilisation
d’un module de données . . . . . . . . 10-8
Création de modules de données
en utilisant le modeleur de données . . . . . 10-9
Création des requêtes
avec le modeleur de données. . . . . . . 10-10
Ouverture d’une URL . . . . . . . . . . .10-11
Début d’une requête. . . . . . . . . . . .10-11
Ajout d’une clause Group By. . . . . . 10-13
Sélection des lignes ayant
des valeurs de colonnes uniques . . . 10-14
Ajout d’une clause Where. . . . . . . . 10-14
Ajout d’une clause Order By . . . . . . 10-16