Tomcat配置JNDI资源(数据源，JMSFactory)

Tomcat配置JNDI资源(数据源，JMSFactory)

一、数据源简介：

在Java语言中，DataSource对象就是一个代表数据源实体的对象。一个数据源就是一个用来存储数据的工具，它可以是复杂的大型企业级数据库，也可以是简单得只有行和列的文件。数据源可以位于在服务器端，也可以位于客服端。

应用程序通过一个连接来访问数据源，那么一个DataSource对象就是用于提供连接数据源的工具。DataSource接口提供了两个方法用于建立和数据源的连接
使用DataSource对象建立和数据库的连接比起使用DriverManager接口更加高效，虽然两者的使用范围都很相似，并且都提供了方法用于建立和数据库的连接，设置连接的最大超时时间，获取流、登录。

但两者之间的区别更加明显。和DriverManager不同，一个DataSource对象能够识别和描述它所代表的数据源的属性，而且DataSource对象的工作和JNDI(Javatm Naming and Directory Interfaceti)具有密切的关系，DataSource的建立、发布、独立于应用程序的管理都依靠JNDI技术。

其实简单说来，直观上的理解就是有tomcat在启动时的某个时刻，利用我们配置到tomcat resource中的参数，替我们连接数据源（数据库，文本数据，或者内存数据，或者ejb服务），包括测试数据源的可用性，并最终利用JNDI发布出来，共部署在该tomcat下的所有应用使用的一个容器及管理的数据源而已。。

好处：解耦了程序和数据源的硬绑定，采用的是JNDI的逻辑名。

在JDBC2.0或JDBC3.0中，所有的数据库驱动程序提供商必须提供一个实现了DataSource接口的类，要使用数据源必须首先在JNDI中注册该数据源对象。

如果在JNDI中注册了数据源对象，将会比起使用DriverManager来具有两个方面的优势：
首先程序不需要像使用DriverManager一样对加载的数据库驱动程序信息进行硬编码，程序员可以选择先在JNDI中注册这个数据源对象，然后在程序中使用一个逻辑名称来引用它，JNDI会自动根据你给出的名称找到与这个名称绑定的DataSource对象。然后就可以使用这个DataSource对象来建立和具体数据库的连接了。

其次，使用实现了DataSource接口的类所具有的第二个优势体现在连接池和分布式事务上。连接池通过对连接的复用而不是新建一个物理连接来显著地提高程序的效率。从而适用于任务繁忙、负担繁重的企业级分布式事务。


二、JNDI简介：

JNDI是用于向Java程序提供目录和命名功能的API。它被设计成独立于特定的目录服务，所以各种各样的目录都可以通过相同的方式进行访问。

可以简单地把JNDI理解为一种将对象和名字绑定的技术，对象工厂负责生产出对象，这些对象都和惟一的名字绑定。外部程序可以通过名字来获取对某个对象的引用。

在Intranets(企业内部网)和Internates（互联网）中目录服务(Directory service)扮演了一个非常重要的角色，它能够在众多的用户、机器、网络、服务、应用程序中访问各种各样的信息。目录服务提供了一系列的命名措施，用人类可以理解的命名方式来刻画各种各样的实体之间的关系

一个企业式计算环境(computing environment)通常是由若干代表不同部分的命名复合而成。比如在一个企业级环境中DNS(Domain Name System)通常被当成顶层的命名方案(top-level namein facility)区分不同的部门或组织。而这些部门或组织自己又可以使用诸如LADP或NDS的目录服务

从用户的角度来看，这些都是由不同的命名方案构成的复合名称。URL就是一个很典型的例子，它由多个命名方案构成。使用目录服务的应用程序必须支持这种复合构成方式

使用目录服务JNDIAPI的Java开发人员获得的好处不仅在于API独立于特定的目录或命名服务，而且可以通过多层的命名方案无缝访问(seamless acess)目录对象。实际上，任何的应用程序都可以将自身的对象和特定的命名绑定起来，这种功能可以使到任何的Java程序查找和获取任何类型的对象

终端用户可以方便地使用逻辑名称从而轻易地在网络上查找和识别各种不同的对象，目录服务的开发人员可以使用API方便地在不同的客服端之间切换而不需要作任何更改

Tomcat的JNDI是采用两层存放模式的，所以先要找到 

Context envContext  = (Context)initContext.lookup("java:/comp/env");  

然后才是针对具体配置的JNDI进行逻辑名查找。

DataSource ds = (DataSource)envContext.lookup("jdbc/myoracle");  

三、数据源和连接池的关系：

JDBC2.0提供了javax.sql.DataSource接口，它负责建立与数据库的连接，在应用程序访问数据库时不需要编写连接数据库的代码，可以直接从数据源获得数据库连接。
　
在DataSource中事先建立了多个数据库连接，这些数据库连接保存在连接池(Connect Pool)中。Java程序访问数据库时，只需要从连接池中取出空闲状态的数据库连接；当程序访问数据库结束，再将数据库连接放回连接池。


四、数据源和JNDI的关系：

DataSource对象是由Tomcat提供的，因此不能在程序中采用创建一个实例的方式来生产DataSource对象，而需要采用Java的另一个技术JNDI，来获得DataSource对象的引用。

Tomcat把DataSource作为一种可以配置的JNDI资源来处理。生成DataSource对象的工厂为org.apache.commons.dbcp.BasicDataSourceFactory。

在javax.naming包中提供了Context接口，该接口提供了将对象和名字绑定，以及通过名字检索对象的方法。Context中的主要方法有：
bind(String name,Object object)：将对象与一个名字绑定
lookup(String name)：返回与指定的名字绑定的对象

数据连接池的配置 Database Connection Pool(DBCP) Configurations

DBCP提供了对JDBC2.0的支持,如果你使用的1.4版本JVM,DBCP将支持JDBC3.0..
2.1 安装 Installation
DBCP使用Jakarta-Commons Database Connection Pool,它依赖以下三个包:
Jakarta-Commons DBCP
Jakarta-Commons Collections
Jakarta-Commons Pool
在Tomcat的安装目录提供了一个集成的jar包 $CATALINA_HOME/lib/tomcat-dbcp.jar..

不同的Tomcat版本，配置略有不同。。

五、Tomcat中数据源的配置：

数据源的配置涉及修改server.xml或context.xml和web.xml，在server.xml中加入定义数据源的元素<Resource>，在web.xml加入<resource-ref>元素，声明该Web应用所引用的数据

A．在server.xml或context.xml中加入<Resource>元素：<Resource>元素用来定义JNDI Resource。
　　
属性 描述
name 指定Resource的JNDI名字
auth 指定管理Resource的Manager，它有两个可选值：Container、Application
type 指定Resource所属的Java类名

<Resource name = "jdbc/BookDb"　//JNDI 逻辑名
auth = "Container"　
　　　type = "javax.sql.DataSource" />

B．在<Resource>元素中加入<ResourceParams>元素：<ResourceParams>元素用来指定各种参数值
　　
属性 描述
factory 指定生成的DataResource的factory类名
maxActive 指定数据库连接池中处于活动状态的最大连接数目，0表示不受限制
maxIdle 指定数据库连接池中处于空闲状态的最大连接数目，0表示不受限制
maxWait 指定连接池中连接处于空闲状态的最长时间,超过会抛出异常，-1表示无限
username 指定连接数据库的用户名
password 指定连接数据库的口令
driverClassName 指定连接数据库的JDBC驱动程序
url 指定连接数据库的URL

<ResourceParams name = "jdbc/BookDb">

<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>

<parameter>
<name>maxActive</name>
<value>100</value>
</parameter>

<parameter>
<name>maxIdle</name>
<value>30</value>
</parameter>

<parameter>
<name>maxWait</name>
<value>10000</value>
</parameter>

<parameter>
<name>username</name>
<value>user</value>
</parameter>

<parameter>
<name>password</name>
<value>1234</value>
</parameter> 

<parameter>
<name>driverClassName</name>
<value>com.mysql.jdbc.Driver</value>
</parameter>

<parameter>
<name>url</name>
<value>jdbc:mysql//localhost:3306/BookDb?autoReconnect=true</value>
</parameter> 

</ResourceParams>

C．在web.xml中加入<resource-ref>元素：<resource-ref>元素表示在Web应用中引用JNDI资源
　　
属性 描述
description 对所引用的资源的说明
res-ref-name 指定所引用资源的JNDI名字，与<Resource>元素中的name属性对应
res-type 指定所引用资源的类名字，与<Resource>元素中的type属性对应
res-auth 指定所引用资源的Manager，与<Resource>元素中的auth属性对应

1. <resource-ref>  
2.  <description>Oracle Datasource example</description>  
3.  <res-ref-name>jdbc/myoracle</res-ref-name>  
4.  <res-type>javax.sql.DataSource</res-type>  
5.  <res-auth>Containerres-auth>  
6. </resource-ref>  

六、在Web应用中使用数据源：
***********************************************************************************
javax.naming.Context提供了查找JNDI Resource的接口，可以通过三个步骤来使用数据源对象：

A．获得对数据源的引用：
　　　　Context ctx = new InitalContext();
DataSource ds = (DataSource)ctx.lookup("java:comp/env/jdbc/BookDb");

Tomcat的JNDI实现是两层散列结构的，java:comp/env/作为开头，之后才是要查找的逻辑名。。深切领会目录命名服务。。注意查找的格式。。--->java:comp/env/jdbc/BookDb

B．获得数据库连接对象：
Connection con = ds.getConnection();
　　
C．返回数据库连接到连接池：
con.close();

在连接池中使用close()方法和在非连接池中使用close()方法的区别是：前者仅仅是把数据库连接对象返回到数据库连接池中，是连接对象又恢复到空闲状态，而非关闭数据库连接，而后者将直接关闭和数据库的连接
***********************************************************************************

七、发布使用数据源的Web应用：
***********************************************************************************
　　如果直接同JDBC访问数据库，可以把JDBC驱动程序拷贝到Web应用的WEB-INF/lib目录或者Tomcat安装目录下的common/lib目录下。推荐放置在common/lib目录下，这样才能有效的保障数据源的建立和使用，并且对于tomcat来说，common/lib目录下的所有jar文件是全局可以使用的。。。
　　
　　如果通过数据源访问数据库，由于数据源由Servlet容器创建并维护，所以必须把JDBC驱动程序拷贝到Tomcat安装目录下的common/lib目录下，确保Servlet容器能够访问驱动程序。

ActiveMQ在Tomcat下面配置JNDI的例子,不同版本的Tomcat具体的配置不同，需要查阅相关的官方文档才可以。。

<?xml version="1.0" encoding="UTF-8"?>

<!-- The contents of this file will be loaded for each web application -->
<Context>


<Resource
    name="jms/FailoverConnectionFactory"
    auth="Container"
    type="org.apache.activemq.ActiveMQConnectionFactory"
    description="JMS Connection Factory"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    brokerURL="failover:(tcp://0.0.0.0:61616)?initialReconnectDelay=100&amp;maxReconnectAttempts=5"
   brokerName="localhost"
    useEmbeddedBroker="false"/>
<Resource
    name="jms/NormalConnectionFactory"
    auth="Container"
    type="org.apache.activemq.ActiveMQConnectionFactory"
    description="JMS Connection Factory"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    brokerURL="tcp://0.0.0.0:61616"
   brokerName="localhost"
    useEmbeddedBroker="false"/>
 
<Resource name="jms/topic/MyTopic"
    auth="Container"
    type="org.apache.activemq.command.ActiveMQTopic"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    physicalName="MY.TEST.FOO.TOPIC"/>
    
<Resource name="jms/queue/MyQueue"
    auth="Container"
    type="org.apache.activemq.command.ActiveMQQueue"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
physicalName="MY.TEST.FOO.QUEUE"/>


    <!-- Default set of monitored resources -->
    <WatchedResource>WEB-INF/web.xml</WatchedResource>

    <!-- Uncomment this to disable session persistence across Tomcat restarts -->
    <!--
    <Manager pathname="" />
    -->
</Context>