开源数据库连接池之Tomcat内置连接池

感谢原文作者: fjdingsd
原文链接:https://www.cnblogs.com/fjdingsd/p/5273187.html

前言

本篇介绍几种开源数据库连接池,同时重点讲述如何使用Tomcat服务器内置的数据库连接池。
之前的博客已经重点讲述了使用数据库连接池的好处,即是将多次创建连接转变为一次创建而使用长连接模式。这样能减少数据库创建连接的消耗。正是由于数据库连接池的思想非常重要,所以市面上也有很多开源的数据库连接池供我们使用。主要有以下三个:

  • DRUID数据库连接池
  • C3P0 数据库连接池
  • Tomcat内置的数据库连接池(DBCP)

本篇主要讲述DBCP数据库连接池的使用,关于另外两个数据库连接池的用法请看《开源数据库连接池之DRUID》 、《开源数据库连接池之C3P0》 。如果我们使用这些开源的数据库连接池,我们就可以省略像前一篇博客中自己创建数据库连接池的步骤,这样会省略我们很多事。
  
  Tomcat服务器也内置了一个数据库连接池,当然这个数据库连接池其实也是一个DBCP数据库连接池。为什么?因为Tomcat和DBCP都是Apache公司的产品。

正文

JNDI技术简单介绍

在学习Tomcat内置的连接池之前,我们先来认识下JNDI技术。

JNDI(Java Naming and Directory Interface),Java命名和目录接口,其对应于J2SE中的javax.naming包。

这个JNDI的作用在于,可以将一个Java对象放在容器(JNDI容器)中,并为存储的这个对象取一个名称,如果某个程序的方法要想获得这个对象,则使用JNDI并通过存储的名称检索即可获得。例如这个JNDI接口定义了Context接口,这是命名服务执行查询的入口,其lookup方法则为检索JNDI容器中的对象。对于Context来说,又代表了一个web应用,后面我们就会知道这两者的羁绊了。

Tomcat内置的数据库连接池

使用Tomcat服务器内置的数据库连接池的局限在于一是这个工程必须是web工程,而不能是一般的Java工程;二是我们必须在服务器启用之前就要将数据库连接池配置好,这就要看情况了,如果我们在启用Tomcat之前没配置数据库连接池的话,那么后面的web应用一般也就不会使用内置的数据库连接池了,毕竟一般服务器不会随便停用。其实要想使用Tomcat内置的数据库连接池,也很简单,就将数据库的驱动jar包(例如mysql-connector-java-5.1.37.jar)放置在Tomcat的【lib】目录下

有了数据库驱动后,接下来就是如何配置连接池的参数了,因为是要使用Tomcat服务器,因此这个配置也会和服务器相关。我们先来看看一段简单地配置参数代码:
  在这里插入图片描述

方式一:在Tomcat中配置

在Tomcat Server.xml文件中

上面这一段相当于是设置Tomcat内置连接池的配置文件内容(当然作为示例参数没有设置太多),其中开头以标签以及name和docBase属性是否十分熟悉?是的,我们在《Tomcat详细用法学习(二)》《Tomcat详细用法学习(四)》 中都已经介绍过了,这个<context>标签在<Host>标签下,<Host>标签代表在服务器中设置的哪个虚拟主机,而<context>标签代表在某个虚拟主机下的某个具体的web应用,name属性指定这个web应用的名称,docBase属性指定该web应用的所在具体路径。也就是说如果我们要配置Tomcat连接池可以在server.xml文件中配置相应的连接池参数

Tomcat目录中自建Contexct.xml

当然我们们在《Tomcat详细用法学习(二)》说过,尽量不要在Tomcat的【conf】目录中的server.xml文件中配置上面的<context>标签,因为每次配置都要重启服务器当然也可以在Tomcat目录下【conf】–>【Catalina】–>【localhost】目录中,自建一个xml文件,再在里面写<context>标签内容,将上面图中的内容写进去,这也是《Tomcat详细用法学习(二)》提到过的。但这里我们任然不用这种要去服务器目录下设置的方法,我们最好的选择是在web应用中就能配置好自己的连接池参数,如方式二。

方式二:在WEB应用中配置(推荐):

那么最终我们使用在MyEclipse中创建web工程中的WebRoot下的META-INF目录里创建各自web的Tomcat内置连接池配置文件,并且这个文件必须命名为“context.xml

其实在Tomcat服务器的文档中就介绍了对于context的几种配置方式,这点在《Tomcat详细用法学习(二)》中介绍了,对于这次我们采用的方式Tomcat文档是这么介绍的:
  在这里插入图片描述
  也就是说我们在自己的web工程下的META-INF目录中创建一个“context.xml”文件,当web工程部署到Tomcat服务器时,服务器就会自动将这个“context.xml”配置文件复制到Tomcat目录下【conf】–>【Catalina】–>【localhost】目录下,同时将该文件重命名为以web工程名.xml的方式,就跟我们上面说的方式一的第二种配置方式一样。但这次我们无需再到Tomcat服务器下去创建xml文件,而是通过在自己应用下创建服务器会自动将我们的xml文件复制过去。
  
  好了,我们已经说完了使用Tomcat内置连接池应该如何创建配置文件,配置文件的内容和配置文件应该放置的位置,现在就是如何使用的问题,我们之前说过JNDI定义了Context接口,是命名服务执行查询的入口,而这个接口的名字正好不就是我们要配置连接池参数的<context>元素吗,所以这里就说明了Tomcat内置连接池是要通过JNDI容器来检索的,而通过<Resource>元素的“name”属性作为在JNDI容器里检索的关键字。
  
 Tomcat文档中也详细说明了如何使用内置的连接池:
 在这里插入图片描述
 注意是点击User Guide的第8点“JNDI Resources”而不是第9点。在“JNDI Resources”中详细介绍了JDBC Data sources:
 在这里插入图片描述
 例:根据上面的知识来简单地创建和使用Tomcat内置数据库连接池

首先在Tomcat目录中的【lib】目录下放入我们的数据库驱动jar包,这里我们使用的是MySQL数据库:
  在这里插入图片描述
  如果没有这一步最后程序将会抛出未找到com.mysql.jdbc.Driver的异常

接着创建一个WEB工程,这里我们命名为“JdbcTomcatPool”,我们使用MySQL数据库中自定义的一个库,这个库我们命名为“jdbcdemo”。创建完web工程,那么在该工程的META-INF目录下创建一个“context.xml”文件:
  在这里插入图片描述
  配置文件中的内容如下:

<Context>
  <Resource name="tomcatpool"
            auth="Container"
            type="javax.sql.DataSource"
            username="root"
            password="root"
            driverClassName="com.mysql.jdbc.Driver"
            url="jdbc:mysql://localhost:3306/jdbcdemo"
            initialSize="10" 
            maxActive="20"
            maxIdle="4"/>
</Context>

这里<Resource>元素的name属性即为我们使用JNDI去检索的关键字,在本例中为“tomcatpool”。其他的参数都是配置连接池的设置,我们可以查看DBCP的参数(之前说过DBCP和Tomcat都是Apache的),也可以在Tomcat的文档查看JNDI Resources这个点里的JDBC Data sources这个文档都有详细的说明。

接下来我们跟以前的工程一样,创建一个数据库工具类JdbcUtils来简化对数据库的操作,注意,这里我们使用到了处理JNDI检索的对象:

public class JdbcUtils {

    private static DataSource ds = null;

    static{
        try{

            Context initCtx = new InitialContext();
            Context envCtx = (Context)initCtx.lookup("java:comp/env");
            ds = (DataSource) envCtx.lookup("tomcatpool");
//根据<Resource>元素的name属性值到JNDI容器中检索连接池对象
        }catch (Exception e) {
            throw new ExceptionInInitializerError(e);
        }
    }

    public static Connection getConnection() throws SQLException {
        return ds.getConnection();  //利用数据源获取连接
    }

    public static void release(Connection conn,Statement st,ResultSet rs) {
        if(rs!=null) {
            try{
                rs.close();
            }catch (Exception e) {
                e.printStackTrace();
            }
        }
        if(st!=null) {
            try{
                st.close();
            }catch (Exception e) {
                e.printStackTrace();
            }
        }
        if(conn!=null) {
            try{
                conn.close();
            }catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

这个工具类和之前的开源连接池差不多一样,在获取连接池和连接都是通过不同开源连接池的对象获取,而释放资源的代码一点都没有变,因此可以知道Tomcat内置的连接池依然也是对数据库直接提供的Connection对象做了close方法的覆写(并没有真的关闭,只是放入连接池),那么我们使用一个Servlet来看看Tomcat给我们提供的连接池是什么样子的:

public class TestServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        Connection conn = null;
        Statement st = null;
        ResultSet rs = null;
        try{
            conn = JdbcUtils.getConnection();
            response.getWriter().write(conn.toString());
            response.getWriter().write("<br>");
            response.getWriter().write(conn.getClass().getName());
        }catch (Exception e) {
            throw new RuntimeException(e);
        }
        finally{
            JdbcUtils.release(conn, st, rs);
        }
}
}

在浏览器中查看:
在这里插入图片描述 从Tomcat内置的连接池返回给我们的Connection对象来看,确实证实了Tomcat内置的连接池就是DBCP连接池。因此我们是一个WEB工程同时不想用其他的开源连接池的话就可以使用Tomcat的内置数据库连接池了。

方式二 总结

  1. 在Tomcat的lib目录中放入数据库驱动Jar包。
  2. META-INF中新建context.xml连接池配置文件(无需配置web.xml)。
  3. JNDI检索调用。

我的实际项目使用

仓库地址:https://github.com/b84955189/VoteSystem

原文地址:https://www.cnblogs.com/tfxz/p/13251763.html