一、简介
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= "com.mysql.jdbc.Driver" //JDBC驱动器
url= "jdbc:mysql://localhost:3306/test" //数据库URL地址
username= "test" //数据库用户名
password= "test" //数据库密码
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/testMDB" name= "jdbc/testMDB" type= "javax.sql.DataSource" />
b)tomcat 安装目录下的conf/server. xml , 该方法可以指定把哪些source绑定到哪个web工程下,但貌似tomcat 6.0不支持,tomcat 5.5倒可以。
<!-- 新增,第一行为加载的工程配置,第二行是该工程需要的ResourceLink配置 -->
< context docBase = "/web/webapps/phoenix" path = "" reloadable = "false" >
< ResourceLink global= "jdbc/testMDB" name= "jdbc/testMDB" type= "javax.sql.DataSource" />
</ context>
c)安装目录下的conf/localhost/下建立一个xml文件 ,文件名是<yourAppName>.xml。比如工程名为test,则该xml名为test.xml。
<? xml version= "1.0" encoding= "UTF-8" ?>
< Context>
< ResourceLink global= "jdbc/testMDB" name= "jdbc/testMDB" type= "javax.sql.DataSource" />
</ context>
d)tomcat 安装目录下的\webapps\test\META-INF\context.xml 的Context节点中增加:
< ResourceLink global= "jdbc/testMDB" name= "jdbc/testMDB" type= "javax.sql.DataSource" />
综上所述,a方法还不如直接把resource定义在context.xml中,免去ResourceLink 配置,也就少了犯错的可能;b、c、d就看个人习惯了,个人还是偏向把所有的resource配置在context.xml中,即方便管理又少了配置。
2、配置spring数据源bean ,相当的简单。
< bean id= "testDataSource" class = "org.springframework.jndi .JndiObjectFactoryBean" >
< property name= "jndiName" >
< value> java: comp/ env/ jdbc/ testDB</ value>
</ property>
</ bean>
ok,配置完成了,至于之后该如何取到这个bean,就不是这次讨论的内容了。
三、常见的报错及解决方案
再看看通常会报的错及解决方案吧。
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