Springmvc +JNDI 在Tomcat下 配置数据源

时间:2023-01-26 19:13:44

 

Springmvc +JNDI 在Tomcat下 配置数据源      

一、简介

jndi(Java Naming and Directory Interface,Java命名和目录接口)是一组在Java应用中访问命名和目录服务的API。命名服务将名称和对象联系起来,使得我们可以用名称访问对象。目录服务是一种命名服务,在这种服务里,对象不但有名称,还有属性。

二、tomcat配置jndi有三种方式。

第一种:单个应用独享数据源

在Tomcat的server.xml找到工程的Context节点,添加一个私有数据源

  1. <Context docBase="Web" path="/Web" reloadable="true" source="org.eclipse.jst.jee.server:WebApp">
  2. <Resource name="jndi/dbtest"   //指定的jndi名称,会用于spring数据源bean的配置和
  3.             auth="Container"   
  4.             type="javax.sql.DataSource"   //数据源床型,使用标准的javax.sql.DataSource
  5.             driverClassName="com.mysql.jdbc.Driver"   //JDBC驱动器
  6.             url="jdbc:mysql://localhost:3306/test"   //数据库URL地址
  7.             username="root"   //数据库用户名
  8.             password="root"   //数据库密码
  9.             maxActive="20"   
  10.             maxIdle="10"   //最大的空闲连接数
  11.           maxWait="10000"//当池的数据库连接已经被占用的时候,最大等待时间
  12.             removeAbandoned="true"
  13.             removeAbandonedTimeout="180"
  14.             logAbandoned="true"//被丢弃的数据库连接是否做记录,以便跟踪
  15.             factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory" 
  16. />  
  17. </Context>

优点:简单

缺点:重用性差

第二种:配置全局JNDI数据源,应用到单个应用

1. 在Tomcat的server.xml中GlobalNamingResources节点,在节点下加一个全局数据源

  1. <Resource name="jndi/dbtest"   //指定的jndi名称,会用于spring数据源bean的配置和
  2.             auth="Container"   
  3.             type="javax.sql.DataSource"   //数据源床型,使用标准的javax.sql.DataSource
  4.             driverClassName="com.mysql.jdbc.Driver"   //JDBC驱动器
  5.             url="jdbc:mysql://localhost:3306/test"   //数据库URL地址
  6.             username="root"   //数据库用户名
  7.             password="root"   //数据库密码
  8.             maxActive="20"   
  9.             maxIdle="10"   //最大的空闲连接数
  10.           maxWait="10000"//当池的数据库连接已经被占用的时候,最大等待时间
  11.             removeAbandoned="true"
  12.             removeAbandonedTimeout="180"
  13.             logAbandoned="true"//被丢弃的数据库连接是否做记录,以便跟踪
  14.             factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory" 
  15. />  

 

2. 在Tomcat的server.xml找到要应用此JNDI数据源的工程Context节点,增加对全局数据源的引用ResourceLink

1.  <Context docBase="Webtest" path="/Webtest" reloadable="true">  

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

3.  </Context> 

优点:重用性,可控性

缺点:配置相对第三种方法要繁琐一点,每个工程都得配

第三种:配置全局JNDI数据源,应用到所有Tomcat下部署的应用

1      配置tomcat单个全局数据源。(已验证)

由于存在同时加载多个web工程,配置之后任何一个web项目都可以使用

1) 在tomcat的 lib 文件夹下添加 JDBC驱动包。

2)在tomcat的conf文件夹下的server.xml配置文件中加入:

        1. <Resource name="jndi/dbtest"   //指定的jndi名称,会用于spring数据源bean的配置和
        2.             auth="Container"   
        3.             type="javax.sql.DataSource"   //数据源床型,使用标准的javax.sql.DataSource
        4.             driverClassName="com.mysql.jdbc.Driver"   //JDBC驱动器
        5.             url="jdbc:mysql://localhost:3306/test"   //数据库URL地址
        6.             username="root"   //数据库用户名
        7.             password="root"   //数据库密码
        8.             maxActive="20"   
        9.             maxIdle="10"   //最大的空闲连接数
        10.           maxWait="10000"//当池的数据库连接已经被占用的时候,最大等待时间
        11.             removeAbandoned="true"
        12.             removeAbandonedTimeout="180"
        13.             logAbandoned="true"//被丢弃的数据库连接是否做记录,以便跟踪
        14.             factory="org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory" 
        15. />  

这里的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下是不够的。

 

3) 在tomcat的conf文件夹下的context.xml配置文件中加入:

<ResourceLinkglobal="jndi/dbtest"name="jndi/dbtest"type="javax.sql.DataSource"/>

把全局的resource直接公开给该tomcat下的所有web工程。

 

4) 在web项目的web.xml中加入资源引用:(可省略)

1.  <resource-ref>  

2.  <description>JNDI DataSource</description>  

3.  <res-ref-name>jndi/testdb</res-ref-name>  

4.  <res-type>javax.sql.DataSource</res-type>  

5.  <res-auth>Container</res-auth>  

6.  </resource-ref>  

启动的时候加载tomcat 配置的JNDI 公开数据源,其中res-ref-name值要和server.xml 、context.xml的name值一致。

 

 5)在web项目中配置spring数据源bean信息:

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

2.       <propertyname="jndiName">

3.           <value>java:comp/env/jndi/testdb</value>

4.       </property>

5.  </bean>

直接替换项目WEB-INF/conf/data-access-config.xml文件中 beanid=”dataSource” 的节点即可使用


2       配置tomcat多个全局数据源(已验证)

注意:配置文件步骤与单个项目相同,仅修改文件内容

1)在tomcat的 lib 文件夹下添加 JDBC驱动包。 

2)server.xml新增数据源即可,格式和单个相同,仅修改name ,参考单个配置2)。 

3) context.xml 新增配置,格式和单个相同,参考单个配置3)。

4)在web项目的web.xml中加入多个资源引用:参考单个配置4) (可省略)

5) dbe2 为数据源一,dbcpccj为数据源二,dataSource中与原框架中区别为下划线部分的内容

1.  <beanid="dbtest1"class="org.springframework.jndi.JndiObjectFactoryBean">

2.     <propertyname="jndiName">

3.        <value>java:comp/env/jndi/dbtest1</value>

4.    </property>

5.    </bean>

6.    <beanid="dbtest2"class="org.springframework.jndi.JndiObjectFactoryBean">

7.     <propertyname="jndiName">

8.        <value>java:comp/env/jndi/dbtest2</value>

9.     </property>

10.    </bean>

11.   <beanid="dataSource"class="com.wishbuild.persistent.source.DynamicDataSource">

12.         <propertyname="targetDataSources">  

13.             <mapkey-type="java.lang.String" value-type="com.wishbuild.persistent.source.DataSourceType">  

14.                 <entryvalue-ref="dbtest1"key="dbtest1"></entry>  

15.                 <entryvalue-ref="dbtest2"key="dbtest2"></entry 

16.             </map>  

17.         </property>  

18.         <propertyname="defaultTargetDataSource"ref="dbtest1"></property>  

19.     </bean>  


优点:重用性,一次性到位

缺点:没有可控性


三、数据源配置在Tomcat/conf/ context.xml文件或者 server.xml 文件 中的区别:

server.xml是不可动态重加载的资源,服务器一旦启动了以后,要修改这个文件,就得重启服务器才能重新加载。而context.xml文件,tomcat服务器会定时去扫描这个文件。一旦发现文件被修改(时间戳改变了),就会自动重新加载这个文件,而不需要重启服务器。

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

a)   java.lang.ClassNotFoundException:org.apache.commons.dbcp.BasicDataSourceFactory

报错详情:

……警告:Failed to register in JMX: javax.naming.NamingException: Could not loadresource factory class [Root exception is java.lang.ClassNotFoundException:org.apache.commons.dbcp.BasicDataSourceFactory]

2010-1-18 13:22:37 org.apache.catalina.mbeans.GlobalResourcesLifecycleListenercreateMBeans

严重: Exception processing Global JNDI Resources

javax.naming.NamingException: Could not load resource factory class [Rootexception 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"。


b)   Caused by:javax.naming.NameNotFoundException: Name memberMDB is not bound in this Context

问题描述:大多数是因为配置了全局的resource,但没有link造成的。全局resource就是配置在server.xml中GlobalNamingResources节点里的Resource,这种Resource还需要再在Context节点中配置一个ResourceLink,把全局的resource绑定到工程的局部配置中。


解决方案:配置全局的 ResourceLink。


c)    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.jarcopy到tomcat的lib下。


d)  Name [jndi/testdb] is not bound in this Context. Unableto find [jdbc].


解决方案:检查配置tomcat (server.xml和context.xml) 和 web项目中web.xml 和data-access-config.xml的配置文件中命名是否相同。