Procédure de connexion d'une BD sous NetBeans

Remarque : cette procédure fonctionne sous NetBeans 5.0, mais elle a l'air d'être la même que sous NetBeans 4.1.

Démarrage du serveur d'applications et des bases de données

1. Dans le répertoire "D:\Sun\AppServer\lib", ouvrir "asadmin-pause.bat", pour positionner les variables d'environnement, avant de lancer la console d'administration du serveur.
2. Dans cette console, taper :
1. "start-database"
2. "start-domain domain1"

Création d'une BD et connexion à cette base

Méthode générale (indépendante du driver)

Sélection d'un driver JDBC

1. Onglet Runtime, section Databases : clic droit sur Drivers -> Add Driver ...
2. Clic sur Add -> dans la boîte de sélection de fichiers, aller dans le répertoire comtenant le jar du driver JDBC (ici, le répertoire d'install du serveur, puis derby, puis lib), et sélectioner ce jar (ici, "derbyclient.jar").
3. Normalement, NetBeans trouve tout seul le driver correspondant (ici, "org.apache.derby.jdbc.ClientDriver" Apache Derby (Net)), ou vous propose une liste s'il y a plusieurs possibilités.

Remarques :

• Si au lieu d'utiliser ce driver, vous utilisez celui de "derby.jar", vous devez avoir accès au connecteur "embedded", utilisable seulement par le serveur lui-même, et non par les clients distants.
• Vous pouvez aussi utiliser un autre driver (par exemple celui d'Oracle).

Connexion à la base

1. Clic droit sur le connecteur "Apache Derby (Net)" -> "Connect using ..."
2. Dans la boîte de dialogue, saisir les champs suivants :
• Database URL: "jdbc:derby://localhost:1527/sun-appserv-samples"
• User Name: "admin"
• Password: "etudiant"
3. Cocher la case "Remember password during this session" (vous devrez quand-même le ré-indiquer à la première connexion des sessions ultérieures).
4. Onglet "Advanced" : "Select schema" : sélectionner "APP".
5. Valider.

Autre possibilité (BD fournie avec NetBeans) :

1. Menu Tools -> Derby Database -> Create Derby Database. Spécifiez un nom, et gardez les mêmes login et mot de passe.
2. Dans la fenêtre "Runtime", il se peut que vous ayiez à cliquer sur le connecteur correspondant (clic droit puis "Connect") pour initialiser la connexion.

Utilisation de la base par l'EJB entité

Dans la fenêtre de droite, ouvrir la classe d'implémentation du bean -> clic droit, menus "Enterprise resources", puis "Use Database".

Installation du connecteur dans le serveur d'applications

La création de la base crée un "connection pool" dans le serveur d'application (pool de connexions à la BD), que vous devez voir dans la console d'administration du serveur. Il faut ensuite créer un une"jdbc resource" qui va permettre d'accéder à ce pool. Pour cela, toujours dans la console d'administration :

1. Aller dans le menu "Resources" -> "JDBC" -> "JDBC Resources".
2. Cliquer sur "New" dans le cadre de droite , puis sélectionnez votre pool dans la liste déroulante "Pool Name".
3. Donnez-lui le même nom JNDI, mais avec "jdbc/" au début
4. Vérifier que la ressources est "enabled".
5. Valider.

1. Dans l'EDI, et dans la fenêtre "Project", déployer le menu "Configuration Files" de votre projet contenant l'EJB entité.
2. Double-cliquez sur le fichier "sun-ejb-jar.xml" pour le faire apparaître dans la fenêtre de droite.

Attention : ne modifiez que la partie "Sun Configuration". Effectuez les modifications suivantes :

3. Donnez un nom au projet (facultatif) ;
4. Dans la partie Cmp Resource :
5. Remplacez le "Jndi Name" actuel par celui de la ressource que vous venez de créer ;
6. Remettez les login et mot de passe dns les deux champs suivants ;
7. Sélectionnez "true" dans les deux champs "Create Tabe At Deploy" et "Drop Table At Undeploy".
8. Compilez, et déployez votre projet, cela doit marcher.