在Tomcat中配置JNDI数据源

jingshen

先了解一些基本概念。


JNDI

JNDI是用于向Java程序提供目录和命名功能的API。

它被设计成独立于特定的目录服务，各种各样的目录都可以通过相同的方式进行访问。可以简单地把JNDI理解为一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和惟一的名字绑定。外部程序可以通过名字来获取对某个对象的引用。

数据源

数据源（DataSource）是一个用来存储数据的工具，它可以是复杂的大型企业级数据库，也可以是简单得只有行和列的文件。它可以位于在服务器端，也可以位于客服端。

一个DataSource对象就是一个用于提供连接数据库的工具，它通常与连接池共同使用。在数据源初始化时，事先建立了多个数据库连接，这些数据库连接保存在连接池(Connect Pool)中。当Java程序访问数据库时，只需要从连接池中取出空闲状态的数据库连接；当程序访问数据库结束，再将数据库连接放回连接池。


在JDBC 2.0或JDBC 3.0中，所有的数据库驱动程序提供商必须提供一个实现了DataSource接口的类，并要求使用数据源必须首先在JNDI中注册该数据源对象。

相比于传统的DriverManager接口，使用DataSource对象建立数据库的连接更加高效，虽然两者的使用范围都很相似，但DataSource比起DriverManager有两个方面的优势：

  

• 灵活：程序不需要像使用DriverManager一样对加载的数据库驱动程序信息进行硬编码，程序员可以选择先在JNDI中注册这个数据源对象，然后在程序中使用一个逻辑名称来引用它，JNDI会自动根据你给出的名称找到与这个名称绑定的DataSource对象。然后就可以使用这个DataSource对象来建立和具体数据库的连接了。  
  
• 效率：使用实现了DataSource接口的类所具有的第二个优势体现在连接池和分布式事务上。连接池通过对连接的复用而不是新建一个物理连接来显著地提高程序的效率。从而适用于任务繁忙、负担繁重的企业级分布式事务。
  

数据源和JNDI的关系
数据源（DataSource）对象是由容器（如，Tomcat）提供的，在程序中不能采用创建一个实例的方式来生产DataSource对象，而必须采用JNDI技术来获得DataSource对象的引用。

例子

下面以Tomcat为例，展示JNDI数据源的使用方法。

根据Apache Tomcat官方文档，可以在两个位置配置JNDI：

  

• $CATALINA_HOME/conf/server.xml，在这个文件里的是全局的，对所有应用可见；  
  
• 对于Tomcat5.5以上版本，可以在web应用的context   XML文件(META-INF/context.xml)中配置私有数据源，只对这个web应用可见。
  

以第二种方法为例，目录结构如下：

  
  
Application --
              --WEB-INF\web.xml
              --META_INF\context.xml
            --index.jsp

context.xml 文件内容：

  
  
<Context debug="0">
    <Resource   name="jdbc/sampleDB" auth="Container"
        type="javax.sql.DataSource"
        driverClassName="oracle.jdbc.driver.OracleDriver"
        url="jdbc:oracle:thin:@localhost:1521/sampleDB"
        username="<username>"
        password="<password>"
        maxActive="20"
        maxIdle="3"
        removeAbandoned="true"
        maxWait="3000" />
</Context>

web.xml部分的代码：

  
  
<!-- Web app resource refs.   -->
<resource-ref>
    <res-ref-name>jdbc/sampleDB</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>   

其中的jdbc/sampleDB为数据源的名称，这可根据自己喜好随意定义，注意，context.xml中定义的要和web.xml的定义一致。

最后是一段示例代码：

  
  
<%@ page   contentType="text/html;   charset=GBK" %>
<%@ page import="java.io.*" %>
<%@ page import="java.util.*" %>
<%@ page import="java.text.*" %>
<%@ page import="java.sql.*" %>
<%@ page import="javax.sql.*" %>
<%@ page import="javax.naming.*" %>

<%
    InitialContext ctx = new   InitialContext();
    DataSource ds = (DataSource)ctx.lookup("java:comp/env/jdbc/sampleDB");
    Connection   conn = null;
    Statement   stmt = null;
    ResultSet   rs = null;

    try   {
        conn =   ds.getConnection();
        stmt   =   conn.createStatement();
        rs   = stmt.executeQuery("SQL语句");
        //其它操作
        rs.close();rs=null;
        stmt.close();stmt   =   null;
        conn.close();conn   = null;
    } finally   {
        if (rs != null)   {
            try   {
                rs.close();
            }   catch (Exception sqlex)   {
            }
            rs   =   null;
        }
        if (stmt != null)   {
            try   {
                stmt.close();
            }   catch (Exception sqlex)   {
            }
            stmt   =   null;
        }
        if (conn != null)   {
            try   {
                conn.close();
            }   catch (Exception sqlex)   {
            }
            conn   =   null;
        }
    }
%>

备注：
Context里URL的属性，如：

  
  
jdbc:oracle:thin:@localhost:1521:sid

@后面的格式为“host:port:sid”。

有时，数据库的SID可能没有（如，仅提供Service Name），这时需要使用下面的URL。

  
  
jdbc:oracle:thin:@(description=(address_list=(address=(protocol=TCP)(port=1521)(host=localhost)))(connect_data=(SERVER =   DEDICATED)(SERVICE_NAME =   serviceName)))

通过 Wiz 发布