JNDI学习总结（2）——JNDI数据源的配置

- 日理万妓 2022-01-13 04:09 251阅读 0赞

[2019独角兽企业重金招聘Python工程师标准>>> ][2019_Python_] ![hot3.png][]

## 一、数据源的由来 ##

在Java开发中，使用JDBC操作数据库的四个步骤如下：

①加载数据库驱动程序(Class.forName("数据库驱动类");)  
　　　　②连接数据库(Connection con = DriverManager.getConnection();)  
　　　　③操作数据库(PreparedStatement stat = con.prepareStatement(sql);stat.executeQuery();)  
　　　　④关闭数据库，释放连接(con.close();)  
　　也就是说，所有的用户都需要经过此四步进行操作，但是这四步之中有三步(①加载数据库驱动程序、②连接数据库、④关闭数据库，释放连接)对所有人都是一样的，而所有人只有在操作数据库上是不一样，那么这就造成了性能的损耗。  
　　那么最好的做法是，准备出一个空间，此空间里专门保存着全部的数据库连接，以后用户用数据库操作的时候不用再重新加载驱动、连接数据库之类的，而直接从此空间中取走连接，关闭的时候直接把连接放回到此空间之中。  
　　那么此空间就可以称为连接池（保存所有的数据库连接），但是如果要想实现此空间的话，则必须有一个问题要考虑？  
　　 　　1、 如果没有任何一个用户使用连接，那么那么应该维持一定数量的连接，等待用户使用。  
　　　　2、 如果连接已经满了，则必须打开新的连接，供更多用户使用。  
　　　　3、 如果一个服务器就只能有100个连接，那么如果有第101个人过来呢？应该等待其他用户释放连接  
　　　　4、 如果一个用户等待时间太长了，则应该告诉用户，操作是失败的。  
　　如果直接用程序实现以上功能，则会比较麻烦，所以在Tomcat 4.1.27之后，在服务器上就直接增加了数据源的配置选项，直接在服务器上配置好数据源连接池即可。在J2EE服务器上保存着一个数据库的多个连接。每一个连接通过DataSource可以找到。DataSource被绑定在了JNDI树上（为每一个DataSource提供一个名字）客户端通过名称找到在JNDI树上绑定的DataSource，再由DataSource找到一个连接。如下图所示：

![08131742_AK03.gif][]

那么在以后的操作中，除了数据库的连接方式不一样之外，其他的所有操作都一样，只是关闭的时候不是彻底地关闭数据库，而是把数据库的连接放回到连接池中去。

如果要想使用数据源的配置，则必须配置虚拟目录，因为此配置是在虚拟目录之上起作用的。需要注意的是，如果要想完成以上的功能，在Tomcat服务器上一定要有各个数据库的驱动程序。

## 二、JNDI+Tomcat配置数据源的两种方式 ##

### 2.1、**全局jndi配置** ###

此种配置需要在server.xml中配置数据源，具体的配置步骤如下：

1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包

2、修改tomcat服务器的conf目录下server.xml配置文件

打开server.xml配置文件，可以看到里面自带的一个全局JNDI配置，如下图所示：

编辑server.xml文件，添加全局JNDI数据源配置，配置如下：

![复制代码][08131742_s8xU.gif]

1 
     4   <GlobalNamingResources>
     5     
     8     <Resource name="UserDatabase" auth="Container"
     9               type="org.apache.catalina.UserDatabase"
    10               description="User database that can be updated and saved"
    11               factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
    12               pathname="conf/tomcat-users.xml" />
    13 
    26 
    27 <Resource 
    28         name="jdbc/oracle"
    29         auth="Container" 
    30         type="javax.sql.DataSource"
    31         maxActive="100" 
    32         maxIdle="30" 
    33         maxWait="10000"
    34         username="lead_oams" 
    35         password="p"
    36         driverClassName="oracle.jdbc.driver.OracleDriver"
    37         url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>
    38 
    39 
    40 <Resource 
    41         name="jdbc/mysql"
    42         auth="Container" 
    43         type="javax.sql.DataSource"
    44         maxActive="100" 
    45         maxIdle="30" 
    46         maxWait="10000"
    47         username="root" 
    48         password="root"
    49         driverClassName="com.mysql.jdbc.Driver"
    50         url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/>
    51 
    52 
    53 <Resource 
    54         name="jdbc/sqlserver"
    55         auth="Container" 
    56         type="javax.sql.DataSource"
    57         maxActive="100" 
    58         maxIdle="30" 
    59         maxWait="10000"
    60         username="sa" 
    61         password="p@ssw0rd"
    62         driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    63         url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/>
    64 
    65   </GlobalNamingResources>

![复制代码][08131742_s8xU.gif]

经过以上的两个步骤，全局JNDI数据源就配置好了，在上述的server.xml文件中，分别配置了Oracle、MySQL、SQLServer这三种数据库的全局JNDI数据源。

### 2.2、**全局jndi数据源测试** ###

1、创建一个JNDI测试项目JNDITest，在web.xml中添加JNDI配置的资源引用

web.xml的配置如下：

![复制代码][08131742_s8xU.gif]

1 <?xml version="1.0" encoding="UTF-8"?>
     2 <web-app version="2.5" 
     3     xmlns="http://java.sun.com/xml/ns/javaee" 
     4     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
     5     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
     6     http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
     7   <welcome-file-list>
     8     <welcome-file>index.jsp</welcome-file>
     9   </welcome-file-list>
    10   
    11   
    17    
    18   <resource-ref>
    19       <description>Oracle DB Connection</description>
    20       <res-ref-name>oracleDataSource</res-ref-name>
    21       <res-type>javax.sql.DataSource</res-type>
    22       <res-auth>Container</res-auth>
    23  </resource-ref>
    24   
    25   
    26   <resource-ref>
    27       <description>MySQL DB Connection</description>
    28       <res-ref-name>mysqlDataSource</res-ref-name>
    29       <res-type>javax.sql.DataSource</res-type>
    30       <res-auth>Container</res-auth>
    31   </resource-ref>
    32   
    33   
    34   <resource-ref>
    35       <description>SQLServer DB Connection</description>
    36       <res-ref-name>sqlserverDataSource</res-ref-name>
    37       <res-type>javax.sql.DataSource</res-type>
    38       <res-auth>Container</res-auth>
    39   </resource-ref>
    40   
    41 </web-app>

![复制代码][08131742_s8xU.gif]

2、映射JNDITest项目的虚拟目录

在tomcat的\\conf\\Catalina\\localhost下（没有目录就新建）创建一个xml文件，文件名必须和项目名相同，测试JNDI数据源的web项目的项目名称是：JNDITest，所以xml文件的命名就叫JNDITest.xml，如下图所示：

编辑JNDITest.xml，配置如下：

![复制代码][08131742_s8xU.gif]

1 <?xml version="1.0" encoding="UTF-8"?>
     2 
     6 
     7 <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
     8     
     9     <ResourceLink name="oracleDataSource" global="jdbc/oracle" type="javax.sql.DataSource"/>
    10     
    11     <ResourceLink name="mysqlDataSource" global="jdbc/mysql" type="javax.sql.DataSource"/>
    12     
    13     <ResourceLink name="sqlserverDataSource" global="jdbc/sqlserver" type="javax.sql.DataSource"/>
    14 </Context>

![复制代码][08131742_s8xU.gif]

3、测试从JNDI数据源获取数据库连接

配置完数据源连接池之后，就可以按照以下的步骤进行访问：

• 初始化名称查找上下文  
　　• 通过JNDI名称找到DataSource  
　　• 通过DataSource取得一个连接  
　　 • 操作数据库  
　　• 关闭数据库，关闭的时候是将连接放回到连接池之中

jsp测试页面代码如下：

![复制代码][08131742_s8xU.gif]

1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
      2 <%@ page import="java.sql.*,javax.sql.*,javax.naming.*" %>
      3 
      4 <!DOCTYPE HTML>
      5 <html>
      6   <head>
      7     <title>JNDI数据源测试</title>
      8   </head>
      9   
     10   <body>
     11         <%
     12             Connection connOracle = null;
     13             try {
     14                 //1、初始化名称查找上下文
     15                 Context ctx = new InitialContext();
     16                 //InitialContext ctx = new InitialContext();亦可 
     17                 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名
     18                 /*
     19                 DataSource名在web.xml文件中的<res-ref-name>oracleDataSource</res-ref-name>进行了配置
     20                  
     21                  <resource-ref>
     22                       <description>Oracle DB Connection</description>
     23                       <res-ref-name>oracleDataSource</res-ref-name>
     24                       <res-type>javax.sql.DataSource</res-type>
     25                       <res-auth>Container</res-auth>
     26                  </resource-ref>
     27                 */
     28                 DataSource ds = (DataSource)ctx.lookup("java:comp/env/oracleDataSource");
     29                 //3、通过DataSource取得一个连接
     30                 connOracle = ds.getConnection();
     31                 out.println("Oracle Connection pool connected !!");
     32                 //4、操作数据库
     33             } catch (NamingException e) {
     34                 System.out.println(e.getMessage());
     35             } catch (SQLException e) {
     36                 e.printStackTrace();
     37             } finally {
     38                 //5、关闭数据库，关闭的时候是将连接放回到连接池之中
     39                 connOracle.close();
     40             }
     41         %>
     42         <hr/>
     43         <%
     44             Connection connMySQL = null;
     45             try {
     46                 //1、初始化名称查找上下文
     47                 Context ctx = new InitialContext();
     48                 //InitialContext ctx = new InitialContext();亦可 
     49                 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面跟的是DataSource名
     50                 /*
     51                 DataSource名在web.xml文件中的<res-ref-name>mysqlDataSource</res-ref-name>进行了配置
     52                   
     53                   <resource-ref>
     54                       <description>MySQL DB Connection</description>
     55                       <res-ref-name>mysqlDataSource</res-ref-name>
     56                       <res-type>javax.sql.DataSource</res-type>
     57                       <res-auth>Container</res-auth>
     58                   </resource-ref>
     59                 */
     60                 DataSource ds = (DataSource)ctx.lookup("java:comp/env/mysqlDataSource");
     61                 //3、通过DataSource取得一个连接
     62                 connMySQL = ds.getConnection();
     63                 out.println("MySQL Connection pool connected !!");
     64                 //4、操作数据库
     65             } catch (NamingException e) {
     66                 System.out.println(e.getMessage());
     67             } catch (SQLException e) {
     68                 e.printStackTrace();
     69             } finally {
     70                 //5、关闭数据库，关闭的时候是将连接放回到连接池之中
     71                 connMySQL.close();
     72             }
     73         %>
     74         <hr/>
     75         <%
     76             Connection connSQLServer = null;
     77             try {
     78                 //1、初始化名称查找上下文
     79                 Context ctx = new InitialContext();
     80                 //InitialContext ctx = new InitialContext();亦可 
     81                 //2、通过JNDI名称找到DataSource,对名称进行定位java:comp/env是必须加的,后面的是DataSource名
     82                 /*
     83                 DataSource名在web.xml文件中的<res-ref-name>sqlserverDataSource</res-ref-name>进行了配置
     84                 
     85                   <resource-ref>
     86                       <description>SQLServer DB Connection</description>
     87                       <res-ref-name>sqlserverDataSource</res-ref-name>
     88                       <res-type>javax.sql.DataSource</res-type>
     89                       <res-auth>Container</res-auth>
     90                   </resource-ref>
     91                 */
     92                 DataSource ds = (DataSource)ctx.lookup("java:comp/env/sqlserverDataSource");
     93                 //3、通过DataSource取得一个连接
     94                 connSQLServer = ds.getConnection();
     95                 out.println("SQLServer Connection pool connected !!");
     96                 //4、操作数据库
     97             } catch (NamingException e) {
     98                 System.out.println(e.getMessage());
     99             } catch (SQLException e) {
    100                 e.printStackTrace();
    101             } finally {
    102                 //5、关闭数据库，关闭的时候是将连接放回到连接池之中
    103                 connSQLServer.close();
    104             }
    105         %>
    106     </body>
    107 </html>

![复制代码][08131742_s8xU.gif]

运行结果如下：

除了可以在Jsp页面中编写java代码测试JNDI数据源连接之外，还有一种比较简单的方式就是使用JSTL标签库提供的sql标签进行测试，测试代码如下：

![复制代码][08131742_s8xU.gif]

1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
     2 <%--引入JSTL标签库 --%>
     3 <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
     4 <%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%>
     5 <!DOCTYPE HTML>
     6 <html>
     7   <head>
     8     <title>JNDI数据源连接测试</title>
     9   </head>
    10   
    11   <body>
    12           <h3>Oracle JNDI数据源测试</h3>
    13           <%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource属性指明使用的数据源--%>
    14         <sql:query var="rs" dataSource="oracleDataSource">
    15             <%--Oracle JNDI数据源测试 SQL--%>
    16             SELECT * FROM LEAD_OAMS_DBSOURCES
    17         </sql:query>
    18         <%--使用c:forEach标签遍历查询结果集rs中的每一行--%>
    19         <c:forEach var="row" items="${rs.rows}">
    20             <%--${row.字段名}获取字段的值--%>
    21             ${row.RESOURCEID}---${row.DBSOURCE_NAME}---${row.DBSOURCE_TYPE}<br/>
    22         </c:forEach>
    23         <hr/>
    24         <h3>MySQL JNDI数据源测试</h3>
    25         <%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource属性指明使用的数据源--%>
    26         <sql:query var="rs" dataSource="mysqlDataSource">
    27             <%--MySQL JNDI数据源测试 SQL--%>
    28              select * from ld_user
    29         </sql:query>
    30         <%--使用c:forEach标签遍历查询结果集rs中的每一行--%>
    31         <c:forEach var="row" items="${rs.rows}">
    32             <%--${row.字段名}获取字段的值--%>
    33             ${row.id}---${row.username}---${row.password}<br/>
    34         </c:forEach>
    35         <hr/>
    36         <h3>SQLServer JNDI数据源测试</h3>
    37         <%--使用sql:query标签发送SQL语句去数据库查询数据，查询的结果集保存到rs变量当中，dataSource属性指明使用的数据源--%>
    38         <sql:query var="rs" dataSource="sqlserverDataSource">
    39             <%--SQLServer JNDI数据源测试 SQL--%>
    40             select * from t_demo
    41         </sql:query>
    42         <%--使用c:forEach标签遍历查询结果集rs中的每一行--%>
    43         <c:forEach var="row" items="${rs.rows}">
    44             <%--${row.字段名}获取字段的值--%>
    45             ${row.id}---${row.time}<br/>
    46         </c:forEach>
    47   </body>
    48 </html>

![复制代码][08131742_s8xU.gif]

运行结果如下：

### 2.3、**非全局jndi配置** ###

**　　**非全局JNDI数据源是针对某一个Web项目配置的数据源，具体的配置步骤如下：

1、在tomcat服务器的lib目录下加入数据库连接的驱动jar包

2、针对具体的web项目映射虚拟目录，然后在虚拟目录映射的配置文件中配置JNDI数据源

还是以上面的JNDITest项目为例子进行说明

在tomcat目录下的\\conf\\Catalina\\localhost目录下创建一个JNDITest.xml文件，如下图所示：

编辑JNDITest.xml文件，添加对JNDITest项目的虚拟目录的映射和JNDI数据源的配置

![复制代码][08131742_s8xU.gif]

1 <?xml version="1.0" encoding="UTF-8"?>
     2 
     6 
     7 <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
     8 
    21 
    22 <Resource 
    23         name="oracleDataSource"
    24         auth="Container" 
    25         type="javax.sql.DataSource"
    26         maxActive="100" 
    27         maxIdle="30" 
    28         maxWait="10000"
    29         username="lead_oams" 
    30         password="p"
    31         driverClassName="oracle.jdbc.driver.OracleDriver"
    32         url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>
    33 
    34 
    35 <Resource 
    36         name="mysqlDataSource"
    37         auth="Container" 
    38         type="javax.sql.DataSource"
    39         maxActive="100" 
    40         maxIdle="30" 
    41         maxWait="10000"
    42         username="root" 
    43         password="root"
    44         driverClassName="com.mysql.jdbc.Driver"
    45         url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&characterEncoding=utf-8"/>
    46 
    47 
    48 <Resource 
    49         name="sqlserverDataSource"
    50         auth="Container" 
    51         type="javax.sql.DataSource"
    52         maxActive="100" 
    53         maxIdle="30" 
    54         maxWait="10000"
    55         username="sa" 
    56         password="p@ssw0rd"
    57         driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    58         url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/>
    59 </Context>

![复制代码][08131742_s8xU.gif]

3、在web项目的web.xml文件中引用配置好的JNDI数据源

![复制代码][08131742_s8xU.gif]

1  
     7    
     8   <resource-ref>
     9       <description>Oracle DB Connection</description>
    10       <res-ref-name>oracleDataSource</res-ref-name>
    11       <res-type>javax.sql.DataSource</res-type>
    12       <res-auth>Container</res-auth>
    13  </resource-ref>
    14   
    15   
    16   <resource-ref>
    17       <description>MySQL DB Connection</description>
    18       <res-ref-name>mysqlDataSource</res-ref-name>
    19       <res-type>javax.sql.DataSource</res-type>
    20       <res-auth>Container</res-auth>
    21   </resource-ref>
    22   
    23   
    24   <resource-ref>
    25       <description>SQLServer DB Connection</description>
    26       <res-ref-name>sqlserverDataSource</res-ref-name>
    27       <res-type>javax.sql.DataSource</res-type>
    28       <res-auth>Container</res-auth>
    29   </resource-ref>

![复制代码][08131742_s8xU.gif]

经过以上3个步骤，针对具体web项目配置的JNDI数据源就算是配置好了。具体的测试和上述测试全局JNDI数据源的方式是一样的！

转载于:https://my.oschina.net/zhanghaiyang/blog/599403

[2019_Python_]: https://my.oschina.net/u/2663968/blog/3061697
[hot3.png]: /images/20220113/8544b810a5c24547a3033869bb17b28d.png
[08131742_AK03.gif]: /images/20220113/7d6266de8a3e4fcbb8db18124f75f548.png
[08131742_s8xU.gif]: /images/20220113/a63ada8c88294038a09125190f5d0545.png