JNDI数据源的配置

Posted limeOracle

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了JNDI数据源的配置相关的知识,希望对你有一定的参考价值。

一、数据源的由来

  在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找到一个连接。如下图所示:
那么在以后的操作中,除了数据库的连接方式不一样之外,其他的所有操作都一样,只是关闭的时候不是彻底地关闭数据库,而是把数据库的连接放回到连接池中去。
  如果要想使用数据源的配置,则必须配置虚拟目录,因为此配置是在虚拟目录之上起作用的。需要注意的是,如果要想完成以上的功能,在Tomcat服务器上一定要有各个数据库的驱动程序。

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

2.1、全局jndi配置

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

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

  

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

  

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

  

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

1 <!-- Global JNDI resources
 2        Documentation at /docs/jndi-resources-howto.html
 3   -->
 4   <GlobalNamingResources>
 5     <!-- Editable user database that can also be used by
 6          UserDatabaseRealm to authenticate users
 7     -->
 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 <!--
14   |- name:表示以后要查找的名称。通过此名称可以找到DataSource,此名称任意更换,但是程序中最终要查找的就是此名称,
15            为了不与其他的名称混淆,所以使用jdbc/oracle,现在配置的是一个jdbc的关于oracle的命名服务。
16   |- auth:由容器进行授权及管理,指的用户名和密码是否可以在容器上生效
17   |- type:此名称所代表的类型,现在为javax.sql.DataSource
18   |- maxActive:表示一个数据库在此服务器上所能打开的最大连接数
19   |- maxIdle:表示一个数据库在此服务器上维持的最小连接数
20   |- maxWait:最大等待时间。10000毫秒
21   |- username:数据库连接的用户名
22   |- password:数据库连接的密码
23   |- driverClassName:数据库连接的驱动程序
24   |- url:数据库连接的地址
25 -->
26 <!--配置Oracle数据库的JNDI数据源-->
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 <!--配置mysql数据库的JNDI数据源-->
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&amp;characterEncoding=utf-8"/>
51 
52 <!--配置SQLServer数据库的JNDI数据源-->
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>

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

2.2、全局jndi数据源测试

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

  

  web.xml的配置如下:

<?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   <!-- 
12   JNDI配置的资源引用:
13   • res-ref-name:表示引用资源的名称
14   • res-type:此资源对应的类型为javax.sql.DataSource
15   • res-auth:容器授权管理
16    -->
17    <!--Oracle数据库JNDI数据源引用 -->
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   <!--MySQL数据库JNDI数据源引用 -->
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   <!--SQLServer数据库JNDI数据源引用 -->
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>

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

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

  

  编辑JNDITest.xml,配置如下:

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!--
 3     jndi配置方法(tomcat):
 4     将此文件放置在tomcat\\conf\\Catalina\\localhost下(没有目录就新建)
 5  -->
 6 <!--映射JNDITest项目的虚拟目录-->
 7 <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
 8     <!--引用Oracle数据库的JNDI数据源-->
 9     <ResourceLink name="oracleDataSource" global="jdbc/oracle" type="javax.sql.DataSource"/>
10     <!--引用mysql数据库的JNDI数据源-->
11     <ResourceLink name="mysqlDataSource" global="jdbc/mysql" type="javax.sql.DataSource"/>
12     <!--引用sqlserver数据库的JNDI数据源-->
13     <ResourceLink name="sqlserverDataSource" global="jdbc/sqlserver" type="javax.sql.DataSource"/>
14 </Context>

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

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

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

  jsp测试页面代码如下:

 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                  <!--Oracle数据库JNDI数据源引用 -->
 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                   <!--MySQL数据库JNDI数据源引用 -->
 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                 <!--SQLServer数据库JNDI数据源引用 -->
 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>

运行结果如下:

  

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

 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>

 运行结果如下:

  

2.3、非全局jndi配置

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

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

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

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

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

  

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

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!--
 3     jndi配置方法(tomcat):
 4     将此文件放置在tomcat\\conf\\Catalina\\localhost下(没有目录就新建)
 5  -->
 6 
 7 <Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
 8 <!--
 9   |- name:表示以后要查找的名称。通过此名称可以找到DataSource,此名称任意更换,但是程序中最终要查找的就是此名称,
10            为了不与其他的名称混淆,所以使用jdbc/oracle,现在配置的是一个jdbc的关于oracle的命名服务。
11   |- auth:由容器进行授权及管理,指的用户名和密码是否可以在容器上生效
12   |- type:此名称所代表的类型,现在为javax.sql.DataSource
13   |- maxActive:表示一个数据库在此服务器上所能打开的最大连接数
14   |- maxIdle:表示一个数据库在此服务器上维持的最小连接数
15   |- maxWait:最大等待时间。10000毫秒
16   |- username:数据库连接的用户名
17   |- password:数据库连接的密码
18   |- driverClassName:数据库连接的驱动程序
19   |- url:数据库连接的地址
20 -->
21 <!--配置Oracle数据库的JNDI数据源-->
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 <!--配置MySQL数据库的JNDI数据源-->
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&amp;characterEncoding=utf-8"/>
46 
47 <!--配置SQLServer数据库的JNDI数据源-->
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>

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

1  <!-- 
 2   JNDI配置的资源引用:
 3   • res-ref-name:表示引用资源的名称
 4   • res-type:此资源对应的类型为javax.sql.DataSource
 5   • res-auth:容器授权管理
 6    -->
 7    <!--Oracle数据库JNDI数据源引用 -->
 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   <!--MySQL数据库JNDI数据源引用 -->
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   <!--SQLServer数据库JNDI数据源引用 -->
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>

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

啦啦啦 

啦啦啦

以上是关于JNDI数据源的配置的主要内容,如果未能解决你的问题,请参考以下文章

tomcat服务器连接MySQL数据库的JNDI数据源配置以及获得连接的Java代码

JNDI是什么?

tomcat 配置JNDI数据源

怎样配置tomcat的jndi数据库连接?

Spring Boot - 外部 Tomcat - JNDI 数据源

Tomcat配置JNDI