Java使用JNDI連接數據庫的實現方法

項目背景

在項目中本身使用的SQL Server 數據庫,某些功能下需要訪問Sybase數據庫(都淘汰的東西 QAQ),考慮到功能較少並且我們的UAT和PROD環境使用的是WebSphere,其本身已經存在JNDI的連接方式,因此我決定使用JNDI設置,那麼就需要解決JNDI在Tomcat下的配置瞭,找瞭很多資料,說到這,不得不吐槽我們國內的博客論壇,大部分都是抄,關鍵是還抄不全,錯漏百出,還不註明原作者。

環境

Eclipse:Luna
Tomcat:apache-tomcat-9.0.8

概念

數據源與連接池

數據源名稱(data source name,DSN)是包含瞭有關某個特定數據庫信息的數據結構,這個信息是開放式數據庫連接驅動能夠連接到數據庫上必需的信息,其實本質上就使程序與數據庫連接的通道。數據源中並無真正的數據,它僅僅記錄的是你連接到哪個數據庫,以及如何連接的,如odbc數據源。也就是說數據源僅僅是數據庫的連接名稱,一個數據庫可以有多個數據源連接。

在Java語言中,DataSource對象就是一個代表數據源實體的對象。一個數據源就是一個用來存儲數據的工具,它可以是復雜的大型企業級數據庫,也可以是簡單得隻有行和列的文件。數據源可以位於在服務器端,也可以位於客服端。

連接池:在Java程序中,當我們需要對數據庫進行操作時,對於數據庫的增刪改查等操作的前提是需要與數據庫建立連接,而對於連接的管理其實就使建立在數據源的基礎上,即連接池。
常用的數據庫連接池:

序號 連接池名稱 依賴的jar包 實現的datasource類 備註
1 JNDI 該數據源是由相應的web服務器(例如:tomcat,weblogic,websphere)負責初始化,創建,管理。程序中不需要引入特別的jar包。 Javax.sql.datasource
2 C3P0 c3p0-0.9.xxx.jar com.mchange.v2.c3p0.ComboPooledDataSource
3 DBCP commons-dbcp.jar
commons-pool.jar
org.apache.commons.dbcp.BasicDataSource
4 BoneCP bonecp-0.6.5.jar
google-collections-1.0.jar
slf4j-api-1.5.11.jar,slf4j-log4j12-1.5.11.jar
log4j-1.2.15.jar
BoneCPDataSource

什麼是JNDI

jndi全稱是java naming and directory interface。簡單點就是你按命名規則給一個東西命名然後你就可以通過該名字在特定環境下直接查找到該東西瞭。
JNDI是用於向Java程序提供目錄和命名功能的API。可以簡單地把JNDI理解為一種將對象和名字綁定的技術,對象工廠負責生產出對象,這些對象都和惟一的名字綁定。外部程序可以通過名字來獲取對某個對象的引用。在一個文件系統中,文件名被綁定給文件。在DNS中,一個IP地址綁定一個URL。在目錄服務中,一個對象名被綁定給一個對象實體。

在Intranets(企業內部網)和Internates(互聯網)中目錄服務(Directory service)都非常重要,它規范瞭命名規則,讓人們容易理解實體及之間的關系。JNDI是Java平臺的一個標準擴展,提供瞭一組接口、類和關於命名空間的概念。JNDI目前所支持的技術包括LDAP、CORBA Common Object Service(COS)名字服務、RMI、NDS、DNS、Windows註冊表等等。

jndi被設計成獨立於特定的目錄服務,所以各種各樣的目錄都可以通過相同的方式進行訪問。這樣使用jndi的java程序員不僅可以獲得統一規整的命名和目錄,而且可以通過多層的命名方案無縫訪問(seamless acess)目錄對象。

在這裡插入圖片描述

JNDI優點

JNDI是由web服務器,實現瞭java.sql.datasource。由web服務器負責初始化數據源,創建connection,分配,管理connection。由於本身是由web服務器實現的功能,因此不需要在項目project中引入特別的jar包,但是需要在服務器的某些配置文件中增加相關的配置。對於我們這種連接多個數據庫有很好的效果。

JDNI在Tomcat中的配置

Jar包

1.數據庫的驅動程序包:
jconn4.jar Sybase驅動程序包
mssql-jdbc-6.1.0.jre7.jar SQL Server 程序驅動包
2.JSP標簽Ja包
.jstl-1.2.jar
standard-1.1.2.jar

測試準備

新建測試Web項目如下:

在這裡插入圖片描述

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/jdbc/Sybase_claims");
                //3、通過DataSource取得一個連接
                connOracle = ds.getConnection();
                out.println("Sybase Connection pool connected !!");
                //4、操作數據庫
            } catch (NamingException e) {
                System.out.println(e.getMessage());
            } catch (SQLException e) {
                e.printStackTrace();
            } finally {
                //5、關閉數據庫,關閉的時候是將連接放回到連接池之中
                connOracle.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/jdbc/sqlserver");
                //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>

Tomcat:

在這裡插入圖片描述

將數據庫驅動Jar包放入Tomcat的lib文件夾下:

在這裡插入圖片描述

JNDI配置

在Tomcat 配置文件server.xml(apache-tomcat-9.0.8\conf)中的GlobalNamingResources標簽內定義

  <!-- 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:數據庫連接的地址
-->
<!--配置Sysbase數據庫的JNDI數據源-->
<Resource 
        name="jdbc/Sybase_claims"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="test" 
        password="test"
        driverClassName="com.sybase.jdbc4.jdbc.SybDriver"
        url="jdbc:sybase:Tds:127.0.0.1:4101?ServiceName=db_claims"/>

<!--配置SQL Server數據庫的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://127.0.0.1:1433;DatabaseName=sonora"/>

全局引用

在Tomcat 的context.xml(apache-tomcat-9.0.8\conf)中引用,針對於本Tomcat服務器下所有項目使用。

<Context>
    <!-- Default set of monitored resources. If one of these changes, the    -->
    <!-- web application will be reloaded.                                   -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <WatchedResource>WEB-INF/tomcat-web.xml</WatchedResource>
    <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->
	<ResourceLink name="jdbc/Sybase_claims" global="jdbc/Sybase_claims" type="javax.sql.DataSource"/>
	<ResourceLink name="jdbc/Sybase_iws_ref" global="jdbc/Sybase_iws_ref" type="javax.sql.DataSource"/>
</Context>

當然,我們也可以不引用局部配置的,在Context標簽中直接寫數據源:

<Context>
    <!-- Default set of monitored resources. If one of these changes, the    -->
    <!-- web application will be reloaded.                                   -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>
    <WatchedResource>WEB-INF/tomcat-web.xml</WatchedResource>
    <WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->
	<!--配置Sysbase數據庫的JNDI數據源-->
<Resource 
        name="jdbc/Sybase_claims"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="test" 
        password="test"
        driverClassName="com.sybase.jdbc4.jdbc.SybDriver"
        url="jdbc:sybase:Tds:127.0.0.1:4101?ServiceName=db_claims"/>

	<!--配置SQL Server數據庫的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://127.0.0.1:1433;DatabaseName=sonora"/>
</Context>

局部引用

局部引用:即是配置的數據源,隻針對於指定項目使用。
方式一:在server.xml中的host標簽內配置

  <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

        <!-- SingleSignOn valve, share authentication between web applications
             Documentation at: /docs/config/valve.html -->
        <!--
        <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
        -->

        <!-- Access log processes all example.
             Documentation at: /docs/config/valve.html
             Note: The pattern used is equivalent to using pattern="common" -->
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
		<Context docBase="jndi_demo" path="/jndi_demo" reloadable="false">
			<ResourceLink name="jdbc/Sybase_claims" global="jdbc/Sybase_claims" type="javax.sql.DataSource"/>
			<ResourceLink name="jdbc/sqlserver" global="jdbc/sqlserver" type="javax.sql.DataSource"/>
		</Context>		
      </Host>

當然也也可以直接在Context標簽下直接定義

<Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

        <!-- SingleSignOn valve, share authentication between web applications
             Documentation at: /docs/config/valve.html -->
        <!--
        <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
        -->

        <!-- Access log processes all example.
             Documentation at: /docs/config/valve.html
             Note: The pattern used is equivalent to using pattern="common" -->
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
		<Context docBase="jndi_demo" path="/jndi_demo" reloadable="false">
			<Resource 
        name="jdbc/Sybase_claims"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="test" 
        password="test"
        driverClassName="com.sybase.jdbc4.jdbc.SybDriver"
        url="jdbc:sybase:Tds:127.0.0.1:4101?ServiceName=db_claims"/>

	<!--配置SQL Server數據庫的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://127.0.0.1:1433;DatabaseName=sonora"/>
		</Context>		
      </Host>

方式二:在Tomcat安裝目錄下apache-tomcat-9.0.8\conf\Catalina\localhost下新建xml文件,文件名與項目名稱相同。

<!--映射JNDITest項目的虛擬目錄-->
<Context docBase="D:/soft-install/apache-tomcat-9.0.8/webapps/jndi_demo/WebContent" debug="0" reloadable="false">
     <!--引用Sybase數據庫的JNDI數據源-->
    <ResourceLink name="jdbc/Sybase_claims" global="jdbc/Sybase_claims" type="javax.sql.DataSource"/>
    <!--引用sqlserver數據庫的JNDI數據源-->
    <ResourceLink name="jdbc/sqlserver" global="jdbc/sqlserver" type="javax.sql.DataSource"/>
</Context>

方式三:
在Tomcat下項目目錄的META-INF中新建Context.xml 配置JNDI引用,例如:、apache-tomcat-9.0.8\webapps\jndi_demo\META-INF、。

<Context reloadable="false">
			<ResourceLink name="jdbc/Sybase_claims" global="jdbc/Sybase_claims" type="javax.sql.DataSource"/>
			<ResourceLink name="jdbc/sqlserver" global="jdbc/Sybase_iws_ref" type="javax.sql.DataSource"/>
</Context>

<?xml version="1.0" encoding="UTF-8"?>
<Context   path="" reloadable="false">
			<Resource 
        name="jdbc/Sybase_claims"
        auth="Container" 
        type="javax.sql.DataSource"
        maxActive="100" 
        maxIdle="30" 
        maxWait="10000"
        username="test" 
        password="test"
        driverClassName="com.sybase.jdbc4.jdbc.SybDriver"
        url="jdbc:sybase:Tds:127.0.0.1:4101?ServiceName=db_claims"/>

	<!--配置SQL Server數據庫的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://127.0.0.1:1433;DatabaseName=sonora"/>
</Context>		

這樣做的好處就是可以脫離Tomcat配置的更改。

註意

1.看瞭很多文章,有些是在項目web.xml中配置如下內容,經過的驗證Tomcat中是可有可無的,不過有些文章說最好加上,以便於項目移植,因為有些服務器是需要的。

<?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:容器授權管理
   -->
   <!--Sybase數據庫JNDI數據源引用 -->
  <resource-ref>
      <description>Sybase DB Connection</description>
      <res-ref-name>jdbc/Sybase_claims</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>jdbc/sqlserver</res-ref-name>
      <res-type>javax.sql.DataSource</res-type>
      <res-auth>Container</res-auth>
  </resource-ref>
  
</web-app>

JNDI配置我們可以發現,第三種方式完全脫離Tomcat的配置,對於server的影響較小。不過我比較推薦全局配置,各處引用,方便切換。

Tomcat的配置修改後,最好重啟Tomcat以便生效,對於server.xml修改必須重啟生效,而context.xml配置保存後tomcat會自動加載無需重啟

JNDI數據源獲取寫法有一下兩種,前者是針對於Tomcat中的,而後者是針對於IBM WebSphere。

A: java:comp/env/jdbc/Sybase_claims
B: jdbc/Sybase_claims

針對於A:
java:comp/env 是環境命名上下文(environment naming context(ENC)),是在EJB規范1.1以後引入的,引入這個是為瞭解決原來JNDI查找所引起的沖突問題,也是為瞭提高EJB或者J2EE應用的移植性。
在J2EE中的引用常用的有:
JDBC 數據源引用在java:comp/env/jdbc 子上下文中聲明
JMS 連接工廠在java:comp/env/jms 子上下文中聲明
JavaMail 連接工廠在java:comp/env/mail 子上下文中聲明
URL 連接工廠在 java:comp/env/url子上下文中聲明

參考資料

https://www.cnblogs.com/wuyanshun/p/6763162.html
http://tomcat.apache.org/tomcat-9.0-doc/jndi-resources-howto.html

到此這篇關於Java使用JNDI連接數據庫的實現方法的文章就介紹到這瞭,更多相關Java JNDI連接數據庫內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: