Jndi使用好處,與簡單例項【Tomcat】

weixin_34126215發表於2016-08-09

JNDI學習總結(一)——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資料來源配置,配置如下:

<!-- Global JNDI resources
       Documentation at /docs/jndi-resources-howto.html
  -->
  <GlobalNamingResources>
    <!-- Editable user database that can also be used by
         UserDatabaseRealm to authenticate users
    -->
    <Resource name="UserDatabase" auth="Container"
              type="org.apache.catalina.UserDatabase"
              description="User database that can be updated and saved"
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
              pathname="conf/tomcat-users.xml" />
<!--
  |- name:表示以後要查詢的名稱。通過此名稱可以找到DataSource,此名稱任意更換,但是程式中最終要查詢的就是此名稱,
           為了不與其他的名稱混淆,所以使用jdbc/oracle,現在配置的是一個jdbc的關於oracle的命名服務。
  |- auth:由容器進行授權及管理,指的使用者名稱和密碼是否可以在容器上生效
  |- type:此名稱所代表的型別,現在為javax.sql.DataSource
  |- maxActive:表示一個資料庫在此伺服器上所能開啟的最大連線數
  |- maxIdle:表示一個資料庫在此伺服器上維持的最小連線數
  |- maxWait:最大等待時間。10000毫秒
  |- username:資料庫連線的使用者名稱
  |- password:資料庫連線的密碼
  |- driverClassName:資料庫連線的驅動程式
  |- url:資料庫連線的地址
-->
<!--配置Oracle資料庫的JNDI資料來源-->
<Resource 
        name="jdbc/oracle"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="lead_oams" 
        password="p"
        driverClassName="oracle.jdbc.driver.OracleDriver"
        url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>

<!--配置MySQL資料庫的JNDI資料來源-->
<Resource 
        name="jdbc/mysql"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="root" 
        password="root"
        driverClassName="com.mysql.jdbc.Driver"
        url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&amp;characterEncoding=utf-8"/>

<!--配置SQLServer資料庫的JNDI資料來源-->
<Resource 
        name="jdbc/sqlserver"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="sa" 
        password="p@ssw0rd"
        driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
        url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/>

  </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"?>
<web-app version="2.5" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  
  <!-- 
  JNDI配置的資源引用:
  • res-ref-name:表示引用資源的名稱
  • res-type:此資源對應的型別為javax.sql.DataSource
  • res-auth:容器授權管理
   -->
   <!--Oracle資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>Oracle DB Connection</description>
      <res-ref-name>oracleDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
 </resource-ref>
  
  <!--MySQL資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>MySQL DB Connection</description>
      <res-ref-name>mysqlDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
  </resource-ref>
  
  <!--SQLServer資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>SQLServer DB Connection</description>
      <res-ref-name>sqlserverDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
  </resource-ref>
  
</web-app>

2、對映JNDITest專案的虛擬目錄

  在tomcat的\conf\Catalina\localhost下(沒有目錄就新建)建立一個xml檔案,檔名必須和專案名相同,測試JNDI資料來源的web專案的專案名稱是:JNDITest,所以xml檔案的命名就叫JNDITest.xml,如下圖所示:

  

  編輯JNDITest.xml,配置如下:

<?xml version="1.0" encoding="UTF-8"?>
<!--
    jndi配置方法(tomcat):
    將此檔案放置在tomcat\conf\Catalina\localhost下(沒有目錄就新建)
 -->
<!--對映JNDITest專案的虛擬目錄-->
<Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
    <!--引用Oracle資料庫的JNDI資料來源-->
    <ResourceLink name="oracleDataSource" global="jdbc/oracle" type="javax.sql.DataSource"/>
    <!--引用mysql資料庫的JNDI資料來源-->
    <ResourceLink name="mysqlDataSource" global="jdbc/mysql" type="javax.sql.DataSource"/>
    <!--引用sqlserver資料庫的JNDI資料來源-->
    <ResourceLink name="sqlserverDataSource" global="jdbc/sqlserver" type="javax.sql.DataSource"/>
</Context>

 3、測試從JNDI資料來源獲取資料庫連線

  配置完資料來源連線池之後,就可以按照以下的步驟進行訪問:

    • 初始化名稱查詢上下文
    • 通過JNDI名稱找到DataSource
    • 通過DataSource取得一個連線
    • 運算元據庫
    • 關閉資料庫,關閉的時候是將連線放回到連線池之中

  jsp測試頁面程式碼如下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*,javax.sql.*,javax.naming.*" %>

<!DOCTYPE HTML>
<html>
  <head>
    <title>JNDI資料來源測試</title>
  </head>
  
  <body>
        <%
            Connection connOracle = null;
            try {
                //1、初始化名稱查詢上下文
                Context ctx = new InitialContext();
                //InitialContext ctx = new InitialContext();亦可 
                //2、通過JNDI名稱找到DataSource,對名稱進行定位java:comp/env是必須加的,後面跟的是DataSource名
                /*
                DataSource名在web.xml檔案中的<res-ref-name>oracleDataSource</res-ref-name>進行了配置
                 <!--Oracle資料庫JNDI資料來源引用 -->
                 <resource-ref>
                      <description>Oracle DB Connection</description>
                      <res-ref-name>oracleDataSource</res-ref-name>
                      <res-type>javax.sql.DataSource</res-type>
                      <res-auth>Container</res-auth>
                 </resource-ref>
                */
                DataSource ds = (DataSource)ctx.lookup("java:comp/env/oracleDataSource");
                //3、通過DataSource取得一個連線
                connOracle = ds.getConnection();
                out.println("Oracle Connection pool connected !!");
                //4、運算元據庫
            } catch (NamingException e) {
                System.out.println(e.getMessage());
            } catch (SQLException e) {
                e.printStackTrace();
            } finally {
                //5、關閉資料庫,關閉的時候是將連線放回到連線池之中
                connOracle.close();
            }
        %>
        <hr/>
        <%
            Connection connMySQL = null;
            try {
                //1、初始化名稱查詢上下文
                Context ctx = new InitialContext();
                //InitialContext ctx = new InitialContext();亦可 
                //2、通過JNDI名稱找到DataSource,對名稱進行定位java:comp/env是必須加的,後面跟的是DataSource名
                /*
                DataSource名在web.xml檔案中的<res-ref-name>mysqlDataSource</res-ref-name>進行了配置
                  <!--MySQL資料庫JNDI資料來源引用 -->
                  <resource-ref>
                      <description>MySQL DB Connection</description>
                      <res-ref-name>mysqlDataSource</res-ref-name>
                      <res-type>javax.sql.DataSource</res-type>
                      <res-auth>Container</res-auth>
                  </resource-ref>
                */
                DataSource ds = (DataSource)ctx.lookup("java:comp/env/mysqlDataSource");
                //3、通過DataSource取得一個連線
                connMySQL = ds.getConnection();
                out.println("MySQL Connection pool connected !!");
                //4、運算元據庫
            } catch (NamingException e) {
                System.out.println(e.getMessage());
            } catch (SQLException e) {
                e.printStackTrace();
            } finally {
                //5、關閉資料庫,關閉的時候是將連線放回到連線池之中
                connMySQL.close();
            }
        %>
        <hr/>
        <%
            Connection connSQLServer = null;
            try {
                //1、初始化名稱查詢上下文
                Context ctx = new InitialContext();
                //InitialContext ctx = new InitialContext();亦可 
                //2、通過JNDI名稱找到DataSource,對名稱進行定位java:comp/env是必須加的,後面的是DataSource名
                /*
                DataSource名在web.xml檔案中的<res-ref-name>sqlserverDataSource</res-ref-name>進行了配置
                <!--SQLServer資料庫JNDI資料來源引用 -->
                  <resource-ref>
                      <description>SQLServer DB Connection</description>
                      <res-ref-name>sqlserverDataSource</res-ref-name>
                      <res-type>javax.sql.DataSource</res-type>
                      <res-auth>Container</res-auth>
                  </resource-ref>
                */
                DataSource ds = (DataSource)ctx.lookup("java:comp/env/sqlserverDataSource");
                //3、通過DataSource取得一個連線
                connSQLServer = ds.getConnection();
                out.println("SQLServer Connection pool connected !!");
                //4、運算元據庫
            } catch (NamingException e) {
                System.out.println(e.getMessage());
            } catch (SQLException e) {
                e.printStackTrace();
            } finally {
                //5、關閉資料庫,關閉的時候是將連線放回到連線池之中
                connSQLServer.close();
            }
        %>
    </body>
</html>

 執行結果如下:

  

  除了可以在Jsp頁面中編寫java程式碼測試JNDI資料來源連線之外,還有一種比較簡單的方式就是使用JSTL標籤庫提供的sql標籤進行測試,測試程式碼如下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%--引入JSTL標籤庫 --%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%>
<!DOCTYPE HTML>
<html>
  <head>
    <title>JNDI資料來源連線測試</title>
  </head>
  
  <body>
          <h3>Oracle JNDI資料來源測試</h3>
          <%--使用sql:query標籤傳送SQL語句去資料庫查詢資料,查詢的結果集儲存到rs變數當中,dataSource屬性指明使用的資料來源--%>
        <sql:query var="rs" dataSource="oracleDataSource">
            <%--Oracle JNDI資料來源測試 SQL--%>
            SELECT * FROM LEAD_OAMS_DBSOURCES
        </sql:query>
        <%--使用c:forEach標籤遍歷查詢結果集rs中的每一行--%>
        <c:forEach var="row" items="${rs.rows}">
            <%--${row.欄位名}獲取欄位的值--%>
            ${row.RESOURCEID}---${row.DBSOURCE_NAME}---${row.DBSOURCE_TYPE}<br/>
        </c:forEach>
        <hr/>
        <h3>MySQL JNDI資料來源測試</h3>
        <%--使用sql:query標籤傳送SQL語句去資料庫查詢資料,查詢的結果集儲存到rs變數當中,dataSource屬性指明使用的資料來源--%>
        <sql:query var="rs" dataSource="mysqlDataSource">
            <%--MySQL JNDI資料來源測試 SQL--%>
             select * from ld_user
        </sql:query>
        <%--使用c:forEach標籤遍歷查詢結果集rs中的每一行--%>
        <c:forEach var="row" items="${rs.rows}">
            <%--${row.欄位名}獲取欄位的值--%>
            ${row.id}---${row.username}---${row.password}<br/>
        </c:forEach>
        <hr/>
        <h3>SQLServer JNDI資料來源測試</h3>
        <%--使用sql:query標籤傳送SQL語句去資料庫查詢資料,查詢的結果集儲存到rs變數當中,dataSource屬性指明使用的資料來源--%>
        <sql:query var="rs" dataSource="sqlserverDataSource">
            <%--SQLServer JNDI資料來源測試 SQL--%>
            select * from t_demo
        </sql:query>
        <%--使用c:forEach標籤遍歷查詢結果集rs中的每一行--%>
        <c:forEach var="row" items="${rs.rows}">
            <%--${row.欄位名}獲取欄位的值--%>
            ${row.id}---${row.time}<br/>
        </c:forEach>
  </body>
</html>

 執行結果如下:

  

2.3、非全域性jndi配置

  非全域性JNDI資料來源是針對某一個Web專案配置的資料來源,具體的配置步驟如下:

   1、在tomcat伺服器的lib目錄下加入資料庫連線的驅動jar包

   2、針對具體的web專案對映虛擬目錄,然後在虛擬目錄對映的配置檔案中配置JNDI資料來源

  還是以上面的JNDITest專案為例子進行說明

  在tomcat目錄下的\conf\Catalina\localhost目錄下建立一個JNDITest.xml檔案,如下圖所示:

  

  編輯JNDITest.xml檔案,新增對JNDITest專案的虛擬目錄的對映和JNDI資料來源的配置

<?xml version="1.0" encoding="UTF-8"?>
<!--
    jndi配置方法(tomcat):
    將此檔案放置在tomcat\conf\Catalina\localhost下(沒有目錄就新建)
 -->

<Context docBase="D:/MyEclipse8.5/workspace/JNDITest/WebRoot" debug="0" reloadable="false">
<!--
  |- name:表示以後要查詢的名稱。通過此名稱可以找到DataSource,此名稱任意更換,但是程式中最終要查詢的就是此名稱,
           為了不與其他的名稱混淆,所以使用jdbc/oracle,現在配置的是一個jdbc的關於oracle的命名服務。
  |- auth:由容器進行授權及管理,指的使用者名稱和密碼是否可以在容器上生效
  |- type:此名稱所代表的型別,現在為javax.sql.DataSource
  |- maxActive:表示一個資料庫在此伺服器上所能開啟的最大連線數
  |- maxIdle:表示一個資料庫在此伺服器上維持的最小連線數
  |- maxWait:最大等待時間。10000毫秒
  |- username:資料庫連線的使用者名稱
  |- password:資料庫連線的密碼
  |- driverClassName:資料庫連線的驅動程式
  |- url:資料庫連線的地址
-->
<!--配置Oracle資料庫的JNDI資料來源-->
<Resource 
        name="oracleDataSource"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="lead_oams" 
        password="p"
        driverClassName="oracle.jdbc.driver.OracleDriver"
        url="jdbc:oracle:thin:@192.168.1.229:1521:lead"/>

<!--配置MySQL資料庫的JNDI資料來源-->
<Resource 
        name="mysqlDataSource"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="root" 
        password="root"
        driverClassName="com.mysql.jdbc.Driver"
        url="jdbc:mysql://192.168.1.144:3306/leadtest?useUnicode=true&amp;characterEncoding=utf-8"/>

<!--配置SQLServer資料庫的JNDI資料來源-->
<Resource 
        name="sqlserverDataSource"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="sa" 
        password="p@ssw0rd"
        driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
        url="jdbc:sqlserver://192.168.1.51:1433;DatabaseName=demo"/>
</Context>

3、在web專案的web.xml檔案中引用配置好的JNDI資料來源

<!-- 
  JNDI配置的資源引用:
  • res-ref-name:表示引用資源的名稱
  • res-type:此資源對應的型別為javax.sql.DataSource
  • res-auth:容器授權管理
   -->
   <!--Oracle資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>Oracle DB Connection</description>
      <res-ref-name>oracleDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
 </resource-ref>
  
  <!--MySQL資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>MySQL DB Connection</description>
      <res-ref-name>mysqlDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
  </resource-ref>
  
  <!--SQLServer資料庫JNDI資料來源引用 -->
  <resource-ref>
      <description>SQLServer DB Connection</description>
      <res-ref-name>sqlserverDataSource</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
  </resource-ref>

經過以上3個步驟,針對具體web專案配置的JNDI資料來源就算是配置好了。具體的測試和上述測試全域性JNDI資料來源的方式是一樣的!

相關文章