5.2. Configuration des connexions
Pour le moment, JGenea n'offre que la possibilité de se
connecter à des bases relationnelles ( supportant le language SQL ).
Dans le futur, JGenea offrira la possibilité de se connecter à des
Services Web pour accéder à des bases généalogiques JGenea distantes.
Un élément de configuration d'une connexion est de la forme
suivante:
<!-- Liste des connexions -->
<connexions>
<connexion id="perso" defaut="oui" type="db">
<param nom="base">Hypersonic</param>
<param nom="descriptif">Base perso embarquée</param>
<param nom="driver">org.hsqldb.jdbcDriver</param>
<param nom="url">jdbc:hsqldb:../db.new/jgenea</param>
<param nom="login">sa</param>
<param nom="password"/>
<param nom="factory-dao">org.jgenea.isolation.defaut.FactoryDAOImpl</param>
<param nom="factory-connexion-dao">org.jgenea.isolation.defaut.Connexion
FactoryUniqueDAOImpl</param>
<param nom="factory-images-dao">org.jgenea.images.registres.FactoryImages
DAOImpl</param>
</connexion>
...
</connexions> |
La connexion est déterminée par un identifiant qui doit être
unique et le type doit obligatoirement est "db" pour désigner
un accès direct à une base de données relationnelle.
Les paramètres de la connexion doivent être les suivants:
Le nom de la base ( par exemple Hypersonic ou Postgresql ).
Le descriptif de la base qui apparaîtra dans les listes des
bases lors des sélections.
La classe du driver pour accéder à la base
Attention
Les classes du driver doivent obligatoirement se trouver
dans le classpath de la commande de lancement de
l'application sous peine d'avoir une erreur et de ne pas
pouvoir se connecter à la base.
L'url JDBC pour accéder à la base. Ces urls sont
spécifiques à chaque base de données.
Pour Hypersonic, elle peut être soit de la forme
"jdbc:hsqldb:../db.new/jgenea" pour le chargement de
la base dans le processus, soit de la forme
"jdbc:hsqldb:hsql://localhost:66" pour la connexion à
un serveur.
Pour Postgresql, elle doit être de la forme
"jdbc:postgresql://localhost:5432/jgenea-perso".
L'identifiant de connexion à la base.
Le mot de passe de connexion à la base.
La classe spécifique au type de base. Il s'agit
d'une implémentation de la couche d'accès aux données de
JGenea pour une base spécifique.
La classe spécifique de récupérer des connexions ( simple,
par un pool de connexion... ).
La classe spécifique pour calculer les images.
Il est possible de configurer autant de connexions que l'on
désire.