JNDI數據源的配置

時間 2019-11-06

標籤 jndi 數據配置简体版

原文原文鏈接

1、數據源的由來

　　在Java開發中，使用JDBC操做數據庫的四個步驟以下：html

　　　　①加載數據庫驅動程序(Class.forName("數據庫驅動類");)
  　　　　②鏈接數據庫(Connection con = DriverManager.getConnection();)
  　　　　③操做數據庫(PreparedStatement stat = con.prepareStatement(sql);stat.executeQuery();)
  　　　　④關閉數據庫，釋放鏈接(con.close();)
　　也就是說，全部的用戶都須要通過此四步進行操做，可是這四步之中有三步(①加載數據庫驅動程序、②鏈接數據庫、④關閉數據庫，釋放鏈接)對全部人都是同樣的，而全部人只有在操做數據庫上是不同，那麼這就形成了性能的損耗。
　　那麼最好的作法是，準備出一個空間，此空間裏專門保存着所有的數據庫鏈接，之後用戶用數據庫操做的時候不用再從新加載驅動、鏈接數據庫之類的，而直接今後空間中取走鏈接，關閉的時候直接把鏈接放回到此空間之中。
　　那麼此空間就能夠稱爲鏈接池（保存全部的數據庫鏈接），可是若是要想實現此空間的話，則必須有一個問題要考慮？
　　　　一、若是沒有任何一個用戶使用鏈接，那麼那麼應該維持必定數量的鏈接，等待用戶使用。
  　　　　二、若是鏈接已經滿了，則必須打開新的鏈接，供更多用戶使用。
  　　　　三、若是一個服務器就只能有100個鏈接，那麼若是有第101我的過來呢？應該等待其餘用戶釋放鏈接
  　　　　四、若是一個用戶等待時間太長了，則應該告訴用戶，操做是失敗的。
　　若是直接用程序實現以上功能，則會比較麻煩，因此在Tomcat 4.1.27以後，在服務器上就直接增長了數據源的配置選項，直接在服務器上配置好數據源鏈接池便可。在J2EE服務器上保存着一個數據庫的多個鏈接。每個鏈接經過DataSource能夠找到。DataSource被綁定在了JNDI樹上（爲每個DataSource提供一個名字）客戶端經過名稱找到在JNDI樹上綁定的DataSource，再由DataSource找到一個鏈接。以下圖所示：

那麼在之後的操做中，除了數據庫的鏈接方式不同以外，其餘的全部操做都同樣，只是關閉的時候不是完全地關閉數據庫，而是把數據庫的鏈接放回到鏈接池中去。

　　若是要想使用數據源的配置，則必須配置虛擬目錄，由於此配置是在虛擬目錄之上起做用的。須要注意的是，若是要想完成以上的功能，在Tomcat服務器上必定要有各個數據庫的驅動程序。

2、JNDI+Tomcat配置數據源的兩種方式

2.一、全局jndi配置

　　此種配置須要在server.xml中配置數據源，具體的配置步驟以下：java

　　一、在tomcat服務器的lib目錄下加入數據庫鏈接的驅動jar包mysql

　　二、修改tomcat服務器的conf目錄下server.xml配置文件web

　　打開server.xml配置文件，能夠看到裏面自帶的一個全局JNDI配置，以下圖所示：sql

　　編輯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數據源。apache

2.二、全局jndi數據源測試

　　一、建立一個JNDI測試項目JNDITest，在web.xml中添加JNDI配置的資源引用tomcat

　　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>

二、映射JNDITest項目的虛擬目錄oracle

　　在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>

三、測試從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                 //一、初始化名稱查找上下文
 15                 Context ctx = new InitialContext();
 16                 //InitialContext ctx = new InitialContext();亦可 
 17                 //二、經過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                 //三、經過DataSource取得一個鏈接
 30                 connOracle = ds.getConnection();
 31                 out.println("Oracle Connection pool connected !!");
 32                 //四、操做數據庫
 33             } catch (NamingException e) {
 34                 System.out.println(e.getMessage());
 35             } catch (SQLException e) {
 36                 e.printStackTrace();
 37             } finally {
 38                 //五、關閉數據庫，關閉的時候是將鏈接放回到鏈接池之中
 39                 connOracle.close();
 40             }
 41         %>
 42         <hr/>
 43         <%
 44             Connection connMySQL = null;
 45             try {
 46                 //一、初始化名稱查找上下文
 47                 Context ctx = new InitialContext();
 48                 //InitialContext ctx = new InitialContext();亦可 
 49                 //二、經過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                 //三、經過DataSource取得一個鏈接
 62                 connMySQL = ds.getConnection();
 63                 out.println("MySQL Connection pool connected !!");
 64                 //四、操做數據庫
 65             } catch (NamingException e) {
 66                 System.out.println(e.getMessage());
 67             } catch (SQLException e) {
 68                 e.printStackTrace();
 69             } finally {
 70                 //五、關閉數據庫，關閉的時候是將鏈接放回到鏈接池之中
 71                 connMySQL.close();
 72             }
 73         %>
 74         <hr/>
 75         <%
 76             Connection connSQLServer = null;
 77             try {
 78                 //一、初始化名稱查找上下文
 79                 Context ctx = new InitialContext();
 80                 //InitialContext ctx = new InitialContext();亦可 
 81                 //二、經過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                 //三、經過DataSource取得一個鏈接
 94                 connSQLServer = ds.getConnection();
 95                 out.println("SQLServer Connection pool connected !!");
 96                 //四、操做數據庫
 97             } catch (NamingException e) {
 98                 System.out.println(e.getMessage());
 99             } catch (SQLException e) {
100                 e.printStackTrace();
101             } finally {
102                 //五、關閉數據庫，關閉的時候是將鏈接放回到鏈接池之中
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.三、非全局jndi配置

　　非全局JNDI數據源是針對某一個Web項目配置的數據源，具體的配置步驟以下：

　　一、在tomcat服務器的lib目錄下加入數據庫鏈接的驅動jar包

　　二、針對具體的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>

三、在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>