ofbiz+tomcat修改数据源信息遇到

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

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

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

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

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

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

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


三、数据源和连接池的关系：
*************************************************************************************
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)：返回与指定的名字绑定的对象
*************************************************************************************


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


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

<Resource name = "jdbc/BookDb"　
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属性对应

*************************************************************************************


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

A．获得对数据源的引用：
　　　　Context ctx = new InitalContext();
DataSource ds = (DataSource)ctx.lookup("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目录下。
　　
　　如果通过数据源访问数据库，由于数据源由Servlet容器创建并维护，所以必须把JDBC驱动程序拷贝到Tomcat安装目录下的common/lib目录下，确保Servlet容器能够访问驱动程序。
************************************************