以下说明基于 Tomcat-5.x 的说明,可从 http://tomcat.apache.org/tomcat-5.5-doc/jndi-datasource-examples-howto.html获得 ,该文件在撰写本文时是最新的被写了。
首先,将.jar
Connector/J自带的文件$CATALINA_HOME/common/lib
安装进去,这样容器中安装的所有应用程序都可以使用它。
$CATALINA_HOME/conf/server.xml
接下来,通过在定义 Web 应用程序的上下文中
添加声明资源来配置 JNDI 数据源:
Press CTRL+C to copy<Context ....> ... <Resource name="jdbc/MySQLDB" auth="Container" type="javax.sql.DataSource"/> <ResourceParams name="jdbc/MySQLDB"> <parameter> <name>factory</name> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value> </parameter> <parameter> <name>maxActive</name> <value>10</value> </parameter> <parameter> <name>maxIdle</name> <value>5</value> </parameter> <parameter> <name>validationQuery</name> <value>SELECT 1</value> </parameter> <parameter> <name>testOnBorrow</name> <value>true</value> </parameter> <parameter> <name>testWhileIdle</name> <value>true</value> </parameter> <parameter> <name>timeBetweenEvictionRunsMillis</name> <value>10000</value> </parameter> <parameter> <name>minEvictableIdleTimeMillis</name> <value>60000</value> </parameter> <parameter> <name>username</name> <value>someuser</value> </parameter> <parameter> <name>password</name> <value>somepass</value> </parameter> <parameter> <name>driverClassName</name> <value>com.mysql.cj.jdbc.Driver</value> </parameter> <parameter> <name>url</name> <value>jdbc:mysql://localhost:3306/test</value> </parameter> </ResourceParams> </Context>
Connector/J 引入了一种工具,通过该工具,可以使用
值设置为
,而不是使用
validationQuery
值。这会向服务器发送一个 ping,然后服务器返回一个伪造的结果集。这是一个重量更轻的解决方案。它还有一个优点,如果使用
或
类型连接,ping 将发送到所有活动连接。以下 XML 片段说明了如何选择此选项:
SELECT
1
validationQuery
/*
ping */
ReplicationConnection
LoadBalancedConnection
Press CTRL+C to copy<parameter> <name>validationQuery</name> <value>/* ping */</value> </parameter>
请注意,/* ping */
必须准确指定。
通常,请按照您的 Tomcat 版本附带的安装说明进行操作,因为您在 Tomcat 中配置数据源的方式会不时发生变化,如果您在 XML 文件中使用了错误的语法,您很可能会以异常结束类似于以下内容:
Press CTRL+C to copyError: java.sql.SQLException: Cannot load JDBC driver class 'null ' SQL state: null
请注意,自动加载具有
META-INF/service/java.sql.Driver
JDBC 4.0 及更高版本中的类的驱动程序会导致 Windows 上 Tomcat 中的 Connector/J 驱动程序不正确地取消部署。即,Connector/J jar 保持锁定状态。这是一个与驱动程序无关的初始化问题。可能的解决方法(如果可行)如下:使用“ antiResourceLocking=true
”作为 Tomcat 上下文属性,或删除
META-INF/
目录。