jndi配置属性的含义

来源:百度文库 编辑:神马文学网 时间:2024/07/03 15:19:04

有关tomcat配置jndi的一些简单介绍:

先说流程:(根据tomcat有关jndi的文档,这个文档应该是针对单个项目配置,下面有比较好的可以配置全局使用的例子)

1.先安装jdbc驱动,这一步很简单,只需将对应数据库驱动放到tomcat对应common/lib目录下就行了;

2.修改对应项目的WEB-INF/web.xml文件,用来声明你的jndi名字以供你的项目使用:

在你的web.xml文件中加入如下代码:

Resource reference to a factory for java.sql.Connectioninstances that may be used for talking to a particulardatabase that is configured in the server.xml file.jdbc/EmployeeDBjavax.sql.DataSourceContainer

3.对应java代码中获得连接方法:(代码摘要)

Context initCtx = new InitialContext();Context envCtx = (Context) initCtx.lookup("java:comp/env");DataSource ds = (DataSource)envCtx.lookup("jdbc/EmployeeDB");Connection conn = ds.getConnection();... use this connection to access the database ...conn.close();

4.配置你的tomcat资源工厂:

在WEB-INF目录下新建文件context.xml,内容如下:

......
这里使用HypersonicSQL database JDBC driver作为例子,不同数据库大家可以找对应的字段改一下就行,关于具体字段含义
后面有说明。
大概步骤已经完了,后面大家应该明白怎么做了,关于建立通用的连接池的方法这里不写了,我在后面贴出来英文的,大家慢慢看
以下摘自tomcat关于jndi的官方文档:
所有安装tomcat的可以在tomcat目录下找到对应文章,路径如下:
D:/apache-tomcat-5.5.25/webapps/tomcat-docs/jndi-resources-howto.html
红字标出的是tomcat解压目录,大家改成自己对应目录就可以了
关于context.xml中对应字段解释地址如下:
http://commons.apache.org/dbcp/configuration.html
或者大家看后面我引用别人的例子也行,里面有详细的中文介绍
------------------------------------------------------------------------------------------------

以下是网上找的一篇文章,感觉写的也很好,抄过来供大家看看:

数据源:

JDBC2.0提供了javax.sql.DataSource的接口,负责与数据库建立连接,实际应用时不需要编写连接数据库代码,直接从数据源获得数据库的连接。Dataource中事先建立了多个数据库连接,这些数据库连接保持在数据库连接池中,当程序访问数据库时,只需要从连接池从取出空闲的连接,访问数据库结束,在将这些连接归还给连接池。DataSource对象由容器(Tomcat)提供,不能使用创建实例的方法来生成 DataSource对象,要采用JAVA的JNDI(Java Nameing and Directory Interface,java命名和目录接口)来获得DataSource对象的引用。(另有一种说法:“其实从技术上来说,数据源连接方式是不需要目录服务的,我们同样可以通过序列化数据源对象直接访问文件系统。这点是需要明确的。”感兴趣的朋友可以试试。)JNDI是一种将对象和名字绑定的技术,对象工厂负责生产出对象,这些对象都和唯一的名字相绑定。程序中可以通过这个名字来获得对象的引用。Tomcat把DataSource作为一种可配置的 JNDI资源来处理,生成DataSource对象的工厂为 org.apache.comm.ons.dbcp.BasicDataSourceFactory。

 

配置数据源:

配置数据源其实相当简单:

首先在server.xml中加入元素,打开server.xml,在中加入以下代码(以oracle为例):

 

 







factory
 
org.apache.commons.dbcp.BasicDataSourceFactory





maxActive

100




 
maxIdle
 
30





maxWait
 
10000




 
username

用户名





password

密码





driverClassName

oracle.jdbc.driver.OracleDriver





url
 
jdbc:oracle:thin:@ip:端口:sid



元素的属性如下:

 

属性 描述 name 指定Resource的JNDI的名字 auth 指定管理Resource的Manager,由两个可选值:Container和Application。Container表示由容器来创建和管理 Resource,Application表示由WEB应用来创建和管理Resource。如果在web application deployment descriptor中使用,这个属性是必需的,如果使用,这个属性是可选的。 type 指定Resource所属的java类名

元素的属性如下:

 

 

属性 描述 name 指定ResourceParams的JNDI的名字,必须和Resource的name保持一致 factory 指定生成DataSource对象的factory的类名 maxActive 指定数据库连接池中处于活动状态的数据库连接最大数目,0表示不受限制 maxIdle 指定数据库连接池中处于空闲状态的数据库连接的最大数目,0表示不受限制 maxWait 指定数据库连接池中的数据库连接处于空闲状态的最长时间(单位为毫秒),超过这一事件,将会抛出异常。-1表示可以无限期等待。 username 指定连接数据库的用户名 password 指定连接数据库的密码 driverClassName 指定连接数据库的JDBC驱动程序 url 指定连接数据库的URL

其他文章说以上配置就OK了,对于web.xml的配置可有可无,其实不是这样子的。如果在web应用中访问了由Servlet容器管理的某个 JNDI Resource,则必须在web.xml中声明对这个JNDI Resource的引用。表示资源引用的元素为,该元素加在中。

 

 



DB Connection

jdbc/JNDI名字

javax.sql.DataSource

Container

元素的属性如下:

 

 

属性 描述 description 对所引用的资源的说明 res-ref-name 指定所引用资源的JNDI名字,与元素中的name属性保持一致 res-type 指定所引用资源的类名字,与元素中的type属性保持一致 res-auth 指定所引用资源的Manager,与元素中的auth属性保持一致

到这里,数据源就已经配置成功了。但是我在测试的时候除了一点小麻烦,主要原因是对DataSource的概念没搞清楚。我是这么测试的,写一个测试类,然后在eclipse中进行junit测试,捕获的异常为:

javax.naming.NoInitialContextException: Need to specify class name in environment or system property, or as an applet parameter, or in an application resource file: java.naming.factory.initial。

同样的代码在JSP文件中正常运行,后来翻了一些资料,终于找到了问题的所在了。原来DataSource是由容器(TOMCAT)提供的,所以我的测试会抛出异常。为了再次验证想法是否正确,在jsp文件中import刚才抛出异常的类,在进行连接数据库,结果一切正常。

下面的例子是实际应用中使用DataSource,在jsp文件中连接oracle。

 

 

另:tomcat5.5的配制方法为:

               maxActive="100" maxIdle="30" maxWait="10000"
               username="用户名" password="密码" driverClassName="oracle.jdbc.driver.OracleDriver"
               url="jdbc:oracle:thin:@ip:端口:sid"/>