Hibernate 3.1＋Tomcat 5.5.X(配置JNDI篇)

一、引言

在Tomcat从其5.0版本升级到5.5.x版本之后，它的配置发生了很多变化。这些改变明显地影响到Tomcat JNDI的建立，这反过来又影响到Hibernate―假定你想在自己的Hibernate安装中利用Tomcat JNDI所提供的方便的DataSource配置的话。

另外，在Hibernate从其3.0版本升级到3.1版本的过程中，在有关获取线程安全的Hibernate会话方面也进行了极大的简化。

从Hibernate的角度来观察，Tomcat是一种混合的环境。Tomcat提供一个JNDI和DataSource―它们都不是一个独立的应 用程序。这个DataSource工具为实现应用程序服务器的可移植性提供了方便。但是，就象一个独立的环境一样，Tomcat并没有提供事务管理器；因 此，你的代码中必须使用Hibernate事务管理器。

到目前为止，我们很难找到有关这两个新版本框架联用的完整的描述―在因特网，甚至在Hibernate.org站点( [url]http://www.hibernate.org[/url]) 上都未曾发现。而在其它一些地方找到的相关信息都已过时。原先的Hibernate 3.0参考文档中提供了有关Hibernate/Tomcat集成(基于Tomcat 4.1)的很有用的一章，但在当前Hibernate 3.1的参考文档中已经删除了原有的这一章。因此，我们十分希望，本系列文章（三篇）会对你的工程开发中在新版本的Hibernate和Tomcat联用 方面助一臂之力。

二、Context.xml文件

在Tomcat的早期版本中，你必须经由服务器范围的配置文件―server.xml来配置Tomcat JNDI。为此，你需要在这个文件内包括多个 元素，相应于每一个DataSource建立一个 元 素。在Tomcat 5.5中，你不再需要使用这个服务器范围的文件来配置JNDI。而是，你只需要把一个应用程序范围的Context.xml放到你的META-INF目录 ―例如“C:\Tomcat 5.5\webapps\BasicWeb\META-INF\Context.xml”下。(注意：你可能会在网上看到许多参考资料，其中说，这个文件 应该根据你的应用程序命名―例如YourApp.xml。其实，这是错误的―你应该使用固定的文件名Context.xml。)

下面图1中的屏幕快照展示了在你的Tomcat目录层次下的Context.xml文件的位置：

 

在你的应用程序的Context.xml文件中，相应于每一个DataSource你都应该包括一个 元素。这个 元素提供了一组定义DataSource的属性，但是没有子元素。下面是一个应用程序完整的Context.xml文件内容。注意，在此仅要求使用一个DataSource：

docBase="C:\Tomcat 5.5\webapps\BasicWeb" workDir="C:\Tomcat 5.5\webapps\BasicWeb">     type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="sam" password="sam123" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/sampdb?autoReconnect=true"/>

上面的 元素具有创建一个Tomcat JNDI DataSource入口的作用。当Tomcat服务器初始启动时，这个JNDI及这个相应的JNDI入口即被创建。站在从JNDI中检索信息的角度来 看，这个JNDI DataSource入口与一个应用程序服务器中的这样的一个入口没有什么不同。(然而，在Tomcat启动周期完成之后，这个Tomcat JNDI是只读的。在Tomcat操作过程中，你的定制应用程序和Hibernate都不能够添加或修改这个JNDI中的入口)

顺便说一下，本系列的几篇中都可能会使用MySQL作为数据存储方式，这正如你在上面的 元素中所见的。

不仅Hibernate能够使用Tomcat JNDI，你的原始JDBC也能够存取JNDI，其方式与你从一个应用程序服务器的一个JNDI中存取一个DataSource的方式完全一致。下面代码片断来自于一个servlet中，它从上面的JNDI 元素中获得一个JNDI连接，并且使用原始JDBC(不是Hibernate)来执行数据库查询。

InitialContext initCtx = new InitialContext(); DataSource ds = (DataSource)initCtx.lookup("java:comp/env/jdbc/Sampdb"); Connection conn = ds.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("select * from car");

在本篇中，我们提供了一个完整的servlet源码实现。我们的目的是为了展示Hibernate 3.1和Tomcat 5.5函数是如何协作的（后面两篇中的示例也是这一目的）。而且，这些代码是很容易理解的―不同于你将正式发布的具有商业质量的代码―它们会包括完整的异 常处理以及其它实践（例如使用MVC模式，这与本文中我们的目的毫无关系）。(你当然会使用一个JSP而不是一个servlet作为你的视图组件。但是， 即使添加少部分的MVC模式内容也会干扰我们所讨论的主要内容―Hibernate和Tomcat的联合问题。)

在此，我们列出本文第一个完整的servlet示例源码：

package TomcatJNDI; import java.io.IOException; import java.io.PrintWriter; import java.sql.*; import javax.sql.*; import javax.naming.*; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class Retrieval extends HttpServlet { /** *对象的构造函数 */ public Retrieval() { super(); } public void doGet(HttpServletRequest request， HttpServletResponse response) throws ServletException， IOException { response.setContentType("text/html"); PrintWriter out = response.getWriter(); out .println(""); out.println(""); out.println("  "); out.println("  "); try  { InitialContext initCtx = new InitialContext(); DataSource ds = (DataSource)initCtx.lookup("java:comp/env/jdbc/Sampdb"); Connection conn = ds.getConnection(); out.println(" "); out.println("Connection from DataSource successfully opened! "); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("select * from car"); while (rs.next() )  { String onerow = "Car manufacturer: " + rs.getString("manufacturer") + ，"  model: "  + rs.getString("model") + ，"  year: "  + rs.getString("year") + " "; out.println(onerow); } rs.close(); stmt.close(); conn.close(); initCtx.close(); out.println(" "); out.println("Connection from DataSource successfully closed! "); } catch(Exception e)  { out.println(" "); out.println("Connection from DataSource NOT successfully opened! "); out.println(e.getMessage() + " "); } out.println("  "); out.println(""); out.flush(); out.close(); } public void init() throws ServletException { //在此加入你的代码 } } //类Retrieval结束

注意，就象任何一个正常应用程序服务器一样，Tomcat实际上也自动提供了数据库连接池支持。在Tomcat情况下，连接池支持是由DBCP组件提供的。在前面展示的 xml元素中，maxActive="100"属性意味着连接池最大应该支持具有100个的活动连接。

三、小结

在本篇中，我们集中讨论了Tomcat 5.5.x JNDI的配置问题。上面展示的Context.xml文件，不需作任何修改即可支持Hibernate。事实上，为了从Hibernate中使用Tomcat JNDI，这样的一个文件也是必需的。

本文出自 “青峰” 博客，转载请与作者联系！