tomcat的数据库连接池的配置 ZT

白森

　　环境：
1. 数据库：mysql
2. 数据库驱动程序：org.gjt.mm.mysql.Driver
JNDI（Java Naming and Directory Interface）概述：
Tomcat4（5）提供了一个与Java Enterprise Edition应用服务相兼容的JNDI--InitialContext实现实例。它的初始数据设置在$CATALINA_HOME/conf/server.xml文件里，并可能在网页应用环境描述（/WEB-INF/web.xml）里被下列元素引用：
1) --环境入口，设置应用程序如何操作。
2) --资源参数，一般是数据库驱动程序、JavaMail Session、自定义类工厂等。
3) --在Servlet 2.4里用来简化设置不需认证信息的资源资源如环境参数、resource-ref变量。
InitialContext在网页应用程序初始化时被设置，用来支持网页应用程序组件。所有的入口和资源都放在JNDI命名空间里的java:comp/env段里。点击下列网址以获取更多信息：
1) Java命名和目录接口（Java Naming and Directory Interface）
2) J2EE平台说明（J2EE Platform Specification）
设置JNDI资源
设置JNDI资源要在$CATALINA_HOME/conf/server.xml文件里使用下列标志符：
1) --设置域个可变的JNDI InitialContext入口的名字和值（同上面说的等价）。
2) --设置应用程序可用的资源的名字和类型（同上面说的等价）。
3) --设置Java资源类工厂的名称或将用的JavaBean属性。
4) --给全局JNDI环境（JNDI Context）添加一个链接。
上述这些标志符必须放在和之间（针对专门的网页应用程序）或和之间。
此外，设在网页应用环境描述（Web Application Descriptor）（/WEB-INF/web.xml）里的名字和值也在初始环境（Initial Context）里被设置，当被元素值允许时将被重设初始值。
全局变量能在子元素的里设置。
数据库连接池概述：
数据库连接是一种关键的有限的昂贵的资源，这一点在多用户的网页应用程序中体现得尤为突出。对数据库连接的管理能显著影响到整个应用程序的伸缩性和健壮性，影响到程序的性能指标。数据库连接池正是针对这个问题提出来的。
数据库连接池负责分配、管理和释放数据库连接，它允许应用程序重复使用一个现有的数据库连接，而再不是重新建立一个；释放空闲时间超过最大空闲时间的数据库连接来避免因为没有释放数据库连接而引起的数据库连接遗漏。这项技术能明显提高对数据库操作的性能。
数据库连接池在初始化时将创建一定数量的数据库连接放到连接池中，这些数据库连接的数量是由最小数据库连接数来设定的。无论这些数据库连接是否被使用，连接池都将一直保证至少拥有这么多的连接数量。连接池的最大数据库连接数量限定了这个连接池能占有的最大连接数，当应用程序向连接池请求的连接数超过最大连接数量时，这些请求将被加入到等待队列中。数据库连接池的最小连接数和最大连接数的设置要考虑到下列几个因素：
1) 最小连接数是连接池一直保持的数据库连接，所以如果应用程序对数据库连接的使用量不大，将会有大量的数据库连接资源被浪费；
2) 最大连接数是连接池能申请的最大连接数，如果数据库连接请求超过此数，后面的数据库连接请求将被加入到等待队列中，这会影响之后的数据库操作。
3) 如果最小连接数与最大连接数相差太大，那么最先的连接请求将会获利，之后超过最小连接数量的连接请求等价于建立一个新的数据库连接。不过，这些大于最小连接数的数据库连接在使用完不会马上被释放，它将被放到连接池中等待重复使用或是空闲超时后被释放。
配置Tomcat数据库连接池的前提：
1. 必须装有Java运行环境；
2. mysql；
在$CATALINA_HOME/conf/server.xml里设置数据库连接池：
下面是配置的代码，必须放在和之间。  
  maxActive  
  100  
  maxIdle  
  30  
  maxWait  
  10000
    removeAbandoned  
  true  
  removeAbandonedTimeout  
  60
   logAbandoned  
  false  
  factory  
  org.apache.commons.dbcp.BasicDataSourceFactory
   username  
  root
   password
    driverClassName
    org.gjt.mm.mysql.Driver
   url
    jdbc:mysql://localhost/test

　　下面是一些参数的说明：
　　其中：
1) path  指定路径，这里设定的是$CATALINA_HOME/webapps下的test目录；
2) docBase 文件根目录。
3) reloader  当网页被更新时是否重新编译。
4) maxActive 连接池的最大数据库连接数。设为0表示无限制。
5) maxIdle  数据库连接的最大空闲时间。超过此空闲时间，数据库连接将被标记为不可用，然后被释放。设为0表示无限制。
6) maxWait 最大建立连接等待时间。如果超过此时间将接到异常。设为－1表示无限制。
7) removeAbandoned 回收被遗弃的（一般是忘了释放的）数据库连接到连接池中。
8) removeAbandonedTimeout 数据库连接过多长时间不用将被视为被遗弃而收回连接池中。
9) logAbandoned 将被遗弃的数据库连接的回收记入日志。
10) driverClassName JDBC驱动程序。
11) url   数据库连接字符串
在$CATALINA_HOME/webapps/test/WEB-INF/web.xml里设置被引用的资源：
下面是配置代码，必须放在和里。
　　
connectDB test
jdbc/connectDB
javax.sql.DataSource
Container
　　
下面是一下参数的必要说明：
1) description  对被引用的资源的描述。
2) res-ref-name  资源名称。见上面的
3) res-type  资源类型。见上面的
为了方便做解释直接在JSP中使用资源：
这是在$CATALINA_HOME/webapps/test下的某级子目录里的jsp网页文件部分代码：
　　
代码说明：
DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/connectDB");
上面这句应用了刚才设的资源。
资源使用完要释放，尤其是Context资源，见try-catch-finally部分的finally代码段，这是一种好的习惯。资源释放时如果释放了上级资源，下级资源将先被释放。如：释放了ctx，那么资源释放顺序将是rs，stmt，cnn，ctx。换句话说，如果释放了ctx，那么rs，stmt和cnn都将不可用了。
这里的释放资源只是将数据库连接返回连接池中，并不是把资源真正释放掉，见数据库连接池概述。
　　
　　Datasource对象是由Tomcat提供的，因而需要使用JNDI来获得Datasouce
　　在Javax.naming 中提供了Context接口，
　　数据源的配置涉及到Server.xml和web.xml，需要在server.xml中加入如下内容：说明一下：我的数据库是MYsql
　　
                         type="javax.sql.DataSource"/>
          \\数据源的名称
            usernameroot数据库的名称
            passwordpassword数据库密码
            driverClassName
              org.gjt.mm.mysql.Driver\\要加载的驱动
            url
              jdbc:mysql://172.20.0.73/rk?\\要连接的URL
         
         
   
　　具体还有一些详细的选项例如：MaxActive等，参加Server.xml中说明
　　另外在Web.xml中加入如下内容：
test connection\\描述
    jdbc/testDB\\名称与上对应
    javax.sql.DataSource\\与上对应
    Container\\与上一置
   
　　配置以上内容后，只要在你的Jsp或Javabean 中按以下方式创建连接，就可以
　　Context ctx=new InitialContext();
  DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/testDB");
  conn = ds.getConnection();
　　以上代码均测试成功，但是在Server.xml中配置数据库的URL中我不能加入useUnicode=true&characterEncoding=GBK，所以从数据库中取出来的汉字都是？？？？
　　我用如下代码来解决这个问题：
　　public static String toChinese(String strvalue) {
  try{
   if(strvalue==null)
  {
  return null;
  }
  else {
   strvalue = new String(strvalue.getBytes("ISO8859_1"), "GBK");
   return strvalue;
  }
  }catch(Exception e){
   return null;
  }
}
　　Step by Step：
1。将数据库驱动程序拷贝到tomcat\common\lib目录下面。
2。修改server.xml文件，在Context配置节点下面加上资源节点，如下：
                 maxActive="100" maxIdle="30" maxWait="10000"
                 username="root" password="" driverClassName="org.gjt.mm.mysql.Driver"
                 url="jdbc:mysql://127.0.0.1:3306/test?characterEncoding=GBK&useUnicode=TRUE"/>
        注意的是：如果有&字符，需要转移成&（XML文件规范）
3。修改Web应用WEB-INF\web.xml文件，加上Resource-Def，如下：
  
      DB Connection
      jdbc/TestDB
      javax.sql.DataSource
      Container
  
4。重新启动Web应用，在Web应用中可以通过下面的代码来获取数据源和数据库连接：
javax.naming.InitialContext context = new javax.naming.InitialContext();
DataSource ds = (DataSource) cxt.lookup( "java:/comp/env/jdbc/TestDB" );
connection = (Connection)ds.getConnection();
　　Problem And Answer：
1。Question:如果出现下列提示：
      javax.naming.NoInitialContextException: Need to specify class name in environment or system property, or as an applet parameter, or in an application resource file:  java.naming.factory.initial
        at javax.naming.spi.NamingManager.getInitialContext(NamingManager.java:640)，怎么办？
      Answer：检查在Tomcat中conf/server.xml文件，检查是否设置useNaming="false"，如果是，去掉。
2。Question:如果无法找到数据库驱动程序怎么办？
      Answer：检查数据库驱动JDBC程序是否放在了Tomcat\common\lib目录下面