tomcat jndi + spring配置

一、简介

JNDI : Java Naming and Directory Interface (JNDI)

首先关于jndi的配置网上资料很多，但大多都不是我想要的，原因很简单，改的配置文件太多，耦合度还是太高。

据网上资料所言，需要更改的配置文件有三：tomcat的server.xml，工程下的WEB-INF/web.xml和spring的数据源bean的配置。虽然只有三个，但在我看来还是太多，WEB-INF/web.xml是及其不愿意经常改动的。于是就有了以下的方案，只需改动tomcat配置和spring的配置，步骤有二。

1、更改tomcat的server.xml或context.xml

2、配置spring数据源bean

二、JNDI配置

1、更改tomcat的server.xml或context.xml

在context.xml的根节点Context里加入Resource配置；如果需要配置全局的 Resource，则在server.xml的GlobalNamingResources节点里加入Resource，再在Context节点里加入ResourceLink的配置。全局的resource只是为了重用，方便所有该tomcat下的web工程的数据源管理，但如果你的tomcat不会同时加载多个web工程，也就是说一个tomcat只加载一个web工程时，是没有必要配置全局的resource的。

<Resource  name="jdbc/testDB"  //指定的jndi名称，会用于spring数据源bean的配置和ResourceLink的配置
               type="javax.sql.DataSource"  //数据源床型，使用标准的javax.sql.DataSource
               driverClassName="oracle.jdbc.driver.OracleDriver"   
               url="jdbc:oracle:thin:@localhost:1521:XE"      
               username="system"    
               password="623582fade"  
               maxIdle="40"   
               maxWait="4000" 
               maxActive="250" 
               removeAbandoned="true" 
               removeAbandonedTimeout="180"
               logAbandoned="true" //被丢弃的数据库连接是否做记录，以便跟踪
               factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory" />

这里的factory指的是该Resource 配置使用的是哪个数据源配置类，这里使用的是tomcat自带的标准数据源Resource配置类，这个类也可以自己写，实现javax.naming.spi.ObjectFactory 接口即可。某些地方使用的commons-dbcp.jar中的org.apache.commons.dbcp.BasicDataSourceFactory，如果使用这个就需把commons-dbcp.jar及其依赖的jar包，都放在tomcat的lib下，光放在工程的WEB-INF/lib下是不够的。

ResourceLink 的配置有多种：

a)tomcat安装目录下的conf/context.xml，把全局的resource直接公开给该tomcat下的所有web工程，在Context节点中加入：

<ResourceLink global="jdbc/testDB" name="jdbc/testDB" type="javax.sql.DataSource"/>

b)tomcat安装目录下的conf/server.xml，该方法可以指定把哪些source绑定到哪个web工程下，但貌似tomcat6.0不支持，tomcat5.5倒可以。 测试在tomcat6.0.32不行

<context docBase="springmvc-web" path="/springmvc-web"  debug="5" reloadable="true" crossContext="true"> 
			 <ResourceLink global="jdbc/testDB" name="jdbc/testDB" type="javax.sql.DataSource"/>
		</context>

c)安装目录下的conf/localhost/下建立一个xml文件，文件名是<yourAppName>.xml。比如工程名为springmvc-web.xml，则该xml名为springmvc-web.xml。

<?xml version="1.0" encoding="UTF-8"?>
<Context>   
     <ResourceLink global="jdbc/testDB" name="jdbc/testDB" type="javax.sql.DataSource"/> 
</Context>

d)tomcat安装目录下的\webapps\springmvc-web\META-INF\context.xml的Context节点中增加:

<ResourceLink global="jdbc/testDB" name="jdbc/testDB" type="javax.sql.DataSource"/>

综上所述，a方法还不如直接把resource定义在context.xml中，免去ResourceLink 配置，也就少了犯错的可能；b、c、d就看个人习惯了，个人还是偏向把所有的resource配置在context.xml中，即方便管理又少了配置。

2、配置spring数据源bean，相当的简单。

<!-- 使用JNDI配置数据源 -->
	<bean id="dataSourse" class="org.springframework.jndi.JndiObjectFactoryBean">
		<property name="jndiName" value="java:comp/env/jdbc/testDB"/>  
	</bean>

ok，配置完成了，至于之后该如何取到这个bean，就不是这次讨论的内容了。其中java:comp/env是必须加的

三、常见的报错及解决方案

再看看通常会报的错及解决方案吧。

1、java.lang.ClassNotFoundException: org.apache.commons.dbcp.BasicDataSourceFactory

报错详情：

……
警告: Failed to register in JMX: javax.naming.NamingException: Could not load resource factory class [Root exception is java.lang.ClassNotFoundException: org.apache.commons.dbcp.BasicDataSourceFactory]
2010-1-18 13:22:37 org.apache.catalina.mbeans.GlobalResourcesLifecycleListener createMBeans
严重: Exception processing Global JNDI Resources
javax.naming.NamingException: Could not load resource factory class [Root exception is java.lang.ClassNotFoundException: org.apache.commons.dbcp.BasicDataSourceFactory]
……

问题描述：这是找不到org.apache.commons.dbcp.BasicDataSourceFactory类，这个类在commons-dbcp.jar中，这jar包时放在工程的WEB-INF/lib下的，而不是tomcat的lib下，但tomcat启动时读取它自身的配置(如server.xml)，用的不是工程的lib而是tomcat自带的lib，所以必然报错。就算把这个包拷到tomcat的lib下也不行，因为commons-dbcp.jar与其他jar包还存在一定的依赖关系。
解决方案：把tomcat jndi配置中的factory="org.apache.commons.dbcp.BasicDataSourceFactory"改为tomcat自带的factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory"。

    2、Caused by: javax.naming.NameNotFoundException: Name memberMDB is not bound in this Context
   问题描述：大多数是因为配置了全局的resource，但没有link造成的。全局resource就是配置在server.xml中GlobalNamingResources节点里的Resource，这种Resource还需要再在Context节点中配置一个ResourceLink，把全局的resource绑定到工程的局部配置中。
   解决方案：见上面步骤1中的ResourceLink配置，这里有a\b\c\d四种方法。

   3、Cannot load JDBC driver class 'com.mysql.jdbc.Driver' java.lang.ClassNotFoundException: com.mysql.jdbc.Driver
   问题描述：因为jndi的配置需要用到mysql的驱动器，所以tomcat的lib下需要加入mysql驱动器的jar包，我用的是mysql-connector-java-5.1.5-bin.jar。
   解决方案：把工程WEB-INF/lib下的mysql-connector-java-5.1.5-bin.jar copy到tomcat的lib下。

over

另附上官方文档：http://tomcat.apache.org/tomcat-6.0-doc/jndi-resources-howto.html

tomcat jndi + spring配置

猜你喜欢