How to setup JNDI Database Connection pool in Tomcat - Spring Tutorial Example

Setting the JNDI Database Connection pool in Spring and Tomcat is pretty easy. Tomcat server documentation gives enough information on how to setup connection pool in Tomcat 5, 6 or 7. Here we will use Tomcat 7 along with spring framework for creating a connection pool in Tomcat server and accessing them in Spring using JNDI code. In our last article, we have seen how to setup database connection pool in Spring for core Java application which doesn't run on a web server or application server and doesn't have managed J2EE container. but if you are developing a web application than its better to use server managed connection pool and access them using JNDI. Spring configuration will be generic and just based on JNDI name of Datasource so it will work on any J2EE Server e.g. Glassfish, WebLogic, JBoss or WebSphere until JNDI name is same.

Btw, Tomcat is my favorite web server and I use it a lot on development as it comes integrated with IDE like Eclipse and Netbeans. I am using it for all test and development purpose, and many companies even run Tomcat in Production for hosting Java web application.

It's simple, fast and very robust, though beware with java.lang.OutOfMemoryError: PermGen space in tomcat, which can cause a memory leak in Java application. It usually happens due to ThreadLocal variables and JDBC drivers but you can surely avoid that by knowing more

How to use JNDI database connection pool in Tomcat and Spring

There three steps to configure and run JNDI Datasource Connection pool for any  Java Web application:

1) Configure data source in Server and create JNDI name.

2) Configure web.xml

3) Configure Spring bean with JNDI Datasource

4) Include JDBC driver library on Server lib e.g. tomcat/lib

In order to create JNDI DataSource on J2EE web server you need to follow server documentation. On Tomcat 6 you can simply put following piece of XML in context.xml to create Tomcat managed database connection pool:

<?xml version="1.0" encoding="UTF-8"?>

<Context antiJARLocking="true" path="/springDataSourceDemo">

<Resource name="jdbc/springeDataSource"














Tomcat internally use DBCP and Commons pool library for managing database connection pool. You can check tomcat/lib directory for jar file tomcat-dbcp.jar which is responsible for creating database connection pool inside tomcat server.

1. web.xml configuration to access JNDI Database connection pool

In order to access any server resource from your web application, you need to specify the JNDI resources in web.xml.

You can use the following XML to declare JNDI Datasource in web.xml:


<description>Oracle Spring JNDI Datasource</description>





Now your web application will see JNDI Datasource created in tomcat with name jdbc/springDataSource.

Btw, if you are not familiar with JNDI and other Java EE concepts then I first suggest you go throughJava Web Fundamentals course by Kevin Jones on Pluarlsight. It's not free, as you need a Plurlasight membership but you can access it free by opting for Pluralsight's 10-day free trial.

Spring JDBC Connection Pool Example

2. Spring configuration for accessing JNDI Datasource :

This spring configuration is generic enough which can be used to access any JNDI data source deployed on any J2EE or Java EE Server. It’s not tied up with Tomcat.  The org.springframework.jndi.JndiObjectFactoryBean is used to lookup JNDI Datasource and bind with javax.sql.DataSource.

<bean id="springDataSource" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName" value="java:comp/env/jdbc/springDataSource"/>

<property name="lookupOnStartup" value="true"/>

<property name="proxyInterface" value="javax.sql.DataSource"/>


I have used XML way to declare a spring bean here, but, If you are using Spring 3.0 or higher than you can also use Java Configuration and @Bean annotation to declare data source in a Spring application. If you are not familiar with Java configuration then please check Spring Master Class - Beginner to Expert to learn more about it.

Spring JNDI Database Connection pool in Tomcat Example

3. JDBC Driver File in Tomcat Lib

Now the final step is to make sure tomcat lib has JDBC driver jar file. I usually put JAR file inside lib directory of tomcat but you can put it anywhere it makes sense and modifies tomcat classpath to include driver JAR into classpath.

Now the rest of code which uses this data source should remain the same. You can get Spring DAO source from the previous article How to setup Database Connection pool in Spring framework.

JNDI Database connection pool in Tomcat and access Spring

Other Spring Framework Tutorials and Resources for further learning

Spring Framework 5: Beginner to Guru

Spring and Hibernate Guide for Beginners

How to use Data Access Object or DAO design pattern in Java

How to measure execution time using Spring’s Stopwatch utility

How to do LDAP authentication in Java web application using Spring Security

How to control concurrent user session in Java web application – Spring Security Tutorial

A quick guide to bean scopes in Spring Framework

Spring in Action 4th edition by Craig Walls

Thanks for reading this article so far. If you like this article then please share with your friends and colleagues. If you have any questions or feedback then please drop a note.

P.S. - If you want to learn how to develop RESTful Web Service using Spring MVC in depth, I suggest you join the REST with Spring certification class by Eugen Paraschiv. One of the best course to learn REST with Spring MVC.

No comments for "How to setup JNDI Database Connection pool in Tomcat - Spring Tutorial Example"