JNDI學習總結(一)——JNDI資料來源的配置
阿新 • • 發佈：2020-07-19
一、資料來源的由來
在Java開發中，使用JDBC操作資料庫的四個步驟如下：
①載入資料庫驅動程式(Class.forName("資料庫驅動類");)②連線資料庫(Connection con = DriverManager.getConnection();)
③操作資料庫(PreparedStatement stat = con.prepareStatement(sql);stat.executeQuery();)
④關閉資料庫，釋放連線(con.close();)
也就是說，所有的使用者都需要經過此四步進行操作，但是這四步之中有三步(①載入資料庫驅動程式、②連線資料庫、④關閉資料庫，釋放連線)對所有人都是一樣的，而所有人只有在操作資料庫上是不一樣，那麼這就造成了效能的損耗。
那麼此空間就可以稱為連線池（儲存所有的資料庫連線），但是如果要想實現此空間的話，則必須有一個問題要考慮？
1、如果沒有任何一個使用者使用連線，那麼那麼應該維持一定數量的連線，等待使用者使用。
2、如果連線已經滿了，則必須開啟新的連線，供更多使用者使用。
3、如果一個伺服器就只能有100個連線，那麼如果有第101個人過來呢？應該等待其他使用者釋放連線
4、如果一個使用者等待時間太長了，則應該告訴使用者，操作是失敗的。
二、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&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的配置如下：
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 <!-- 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&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資料來源的方式是一樣的！