Utilisation du contexte JNDI de Tomcat via Spring

Présentation

Si votre application web a besoin de manipuler des données provenant d’une base de données, et que vous devez vous y connecter depuis le contexte JNDI de votre serveur d’applications, il existe plusieurs chemins qui permettent d’y arriver, je vais vous en présenter deux dans cet article.

Environnement technique

1. Spring framework est utilisé pour la définition de vos services métiers et de vos beans d’accès aux données (v2.08)
2. Vous utilisez Apache Tomcat comme serveur d’applications opensource (v6.0.14)
3. Votre environnement de travail est Eclipse (v3.4.0)

Problème à résoudre

1. Fichier de configuration Spring pour l’utilisation d’une variable JNDI lié à Tomcat (jdbc/dbUser)

<!DOCTYPE beans SYSTEM "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
	<!-- ###### SERVICES ###### -->
	<bean id="userService" class="fr.geeks.business.UserServiceImpl" init-method="init">
		<property name="userDao" ref="userDao" />
	</bean>
	<!-- ###### JNDI Lookup ###### -->
	<bean id="dbUser" class="org.springframework.jndi.JndiObjectFactoryBean" lazy-init="true">
		<property name="jndiName" value="java:comp/env/jdbc/dbUser" />
	</bean>
	<!-- ###### DAOs ###### -->
	<bean id="userDao" class="fr.geeks.domain.UserDaoImpl">
		<property name="dataSource" ref="dbUser" />
	</bean>
</beans>

2. Erreur à résoudre au démarrage de votre application

Caused by: javax.naming.NameNotFoundException: Le Nom jdbc n'est pas lié à ce Contexte
	at org.apache.naming.NamingContext.lookup(NamingContext.java:770)

Solution 1

Cette solution est largement utilisée : il faut déclarer votre source de données au niveau de Tomcat (conf/server.xml) et de lier cette ressource au contexte de votre application web, tout ce paramétrage se fait au niveau de votre serveur d’applications :

<GlobalNamingResources>
   <Resource name="jdbc/dbUser" auth="Container" type="javax.sql.DataSource" username="xxx" password="yyy" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/des_geeks?autoReconnect=true"/>
</GlobalNamingResources>

<Context docBase="TomcatDatasourceJndi" path="/TomcatDatasourceJndi" reloadable="true" source="org.eclipse.jst.jee.server:TomcatDatasourceJndi">
      	<ResourceLink global="jdbc/dbUser" name="jdbc/dbUser" type="javax.sql.DataSource"/>
      </Context>

Solution 2

Cette solution est encore plus rapide et permet de ne rien toucher à votre serveur, tout se fait du côté de votre application web : déposer un fichier META-INF/context.xml contenant le paramétrage de la source de données à utiliser et son nom JNDI par lequel elle est appelée :

<?xml version="1.0" encoding="UTF-8"?>
<Context>
	<!-- Specify a JDBC datasource -->
	<Resource name="jdbc/dbUser" auth="Container" type="javax.sql.DataSource"
		username="xxx" password="yyy" driverClassName="com.mysql.jdbc.Driver"
		url="jdbc:mysql://localhost:3306/des_geeks?autoReconnect=true"
		validationQuery="select 1" maxActive="10" maxIdle="4" />
</Context>

Conclusion

Je suis personnellement convaincu par le seconde solution qui me semble plus simple à mettre en place et permet d’avoir une configuration propre par application. Cependant la première fonctionne mais il faut prendre un peu plus de précaution car mettre les mains dans la configuration de votre Tomcat peut s’avérer fatal

sources disponibles ici

Cet article a été écrit par :

Mimie – qui a déjà rédigé 123 posts sur Des Geeks et des lettres.

Passionné d'informatique et développeur JavaEE de métier, je me consacre principalement à écrire des billets sur les sujets du Web et de la programmation Web. Ce blog est un espace qui me permet de partager mes découvertes avec vous et me sert accessoirement de pense bête !

Contacter l'auteur

Jetez aussi un oeil sur :

• JUnit : Test unitaire hors conteneur J2EE avec Spring et JNDI
• EhCache + Spring : Mise en place d’un cache applicatif
• Spring + Hibernate : Mise en place d’un DAO générique
• MySQL : Récupérer l’auto-increment lors d’une insertion avec Spring DAO
• Struts : intégration dans un contexte Spring