Voir également :

• Personnalisation de la connexion à la base de données

See also: Customizing the database connection

The database connection is handled by Hibernate. The properties below (set in La connexion à la base de données est faite par Hibernate. Les propriétés ci-dessous sont définies dans le fichier /properties/config.properties et utilisées pour renseigner les fichiers ) are used by the Hibernate configuration files /properties/dao/hibernate/hibernate-jdbc.cfg.xml et and /properties/dao/hibernate/hibernate-jndi.cfg.xml, ainsi que le fichier as well as the Tomcat configuration file conf/server.xml de Tomcat pour les déploiements for quick-start deployments.

Propriétés propres au SGBD

Pilote

default-table-type=innodb

Database manager properties

Driver

The driver of the database manager (by default Le pilote de la base de données (par défaut MySql JDBC):

#hibernate.connection.driver_class=com.mysql.jdbc.Driver

Pour PostgreSQL For Postgres use:

hibernate.connection.driver_class=org.postgresql.Driver

...

Hibernate dialect

Le dialecte The Hibernate dialect, par défaut InnoDB pour MySql by default MySql InnoDB:

#hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

Pour PostgreSQL For Postgres use:

hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

...

JDBC

...

properties

esup-helpdesk always uses JDBC to access the database from ant tasks (asynchronous commandsL'application utilise toujours JDBC pour l'accès à la base de données en ligne de commande (tâche asynchrones).

URL (

...

required)

L'URL de la base de données, par défaut helpdesk sur The JDBC URL of the database, by default helpdesk on localhost:

#hibernate.connection.jdbc.url=jdbc:mysql://localhost/helpdesk

Pour PostgreSQL For Postgres use:

hibernate.connection.jdbc.url=jdbc:postgresql://localhost:5432/helpdesk

...

Authentication (

...

required)

The credentials used to connect to the databaseL'authentification à la base de données :

#hibernate.connection.jdbc.username=admin
#hibernate.connection.jdbc.password=secret

...

JNDI

...

properties

esup-helpdesk can use JNDI to access the database from web requests. Using JNDI is recommended in production for performance reasons, it allows deployers to monitor the database load thanks to tools such as LambdaProbe (see L'application peut, pour les requêtes web, utiliser JNDI pour l'accès à la base de données. Cela est conseillé en production pour des raisons de performances, et cela pemet également de surveiller la charge de la base de données grâce à des outils comme LambdaProbe (voir 25 Surveillance des applications).Si l'on préfère utiliser JDBC

pour accéder à la base même depuis les requêtes web, il suffit de positionner To use JDBC to access the database even from web requests, set this property:

hibernate.useJndi=false

Pour utiliser un pool de connection défini dans Tomcat par exemple de cette manière dans le contexte de l'application :To use a connection pool set like this on Tomcat in the application context,

<Resource
    name="jdbc/esup-helpdesk"
    auth="Container"
    type="javax.sql.DataSource"
    username="admin"
    password="secret"
    driverClassName="com.mysql.jdbc.Driver"
    url="jdbc:mysql://localhost/rennes1-20080905?autoReconnect=true"
    maxActive="100" maxIdle="10" maxWait="10000"
    poolPreparedStatements="true" validationQuery="SELECT 1"
    removeAbandoned="true" removeAbandonedTimeout="60"
    logAbandoned="true" />

On indiquera simplement le nom de la source de données à l'application Tell the application the name of the pool:

hibernate.useJndi=true
hibernate.connection.jndi.datasource=jdbc/esup-helpdesk

L'application détectera automatiquement dans quelle The application automatically detects its running mode (web ou ligne de commande) elle se trouve, et utilise alors l'accès JNDI ou JDBC.

Connecteur JDBC

batch or web) to use JDBC (batch) or JNDI (web).

JDBC connector

esup-helpdesk is configured by default to use MySql, it embeds the MySql connector for esup-helpdesk est configuré par défaut pour utiliser MySql, embarquant notamment le connecteur MySql pour Java (mysql-connector-java.jar). Pour se connecter à un autre type de base de données que MySql, il faut :To connect to another database manager:

• use the JDBC driver and the Hibernate dialect that corresponds to your database manager,
• add the corresponding connector to the
• utiliser le pilote et le dialecte Hibernate correspondant à la nouvelle base de données
• ajouter le connecteur pour Java correspondant dans le répertoire /webapps/WEB-INF/lib
• permettre la récupération du connecteur lors de la prochaine mise à jour (cf Conservation des personnalisations lors des mises à jour).

Voir : La documentation Hibernate

MySql

Le connecteur MySql est inclus par défaut dans la distribution.

PostgreSQL

• folder*,*
• allow the automatic recovering of this file when upgrading (see Recovering previous configuration and customizations when upgrading).

See: The Hibernate documentation

MySql

The MySql connector is embedded by default in the distribution.

Postgres

• Version

...

• 7.4:  pg74.1jdbc3.jar

...

• Version 8.2: postgresql-8.2-506.jdbc3.jar

Les drivers pour les différentes versions de Postgresql sont téléchargeables à l'adresse : Connectors for Postgres can be downloaded from http://jdbc.postgresql.org/download.html .

Oracle