在Tomcat中通过JOTM支持JTA

1 概述

    因为需要将项目从IBM WebSphere Application Server移植到Tomcat 上开发，以提高开发效率，所以研究了一下在Tomcat中通过JNDI查找和使用JDBC及JTA的方法。

    Tomcat 是Servlet容器，但它也提供了一个JNDI InitialContext实现，因此用户可以像在J2EE应用程序服务器中一样在Tomcat中使用JNDI查找JDBC数据源。不过在事务处理方面，Tomcat本身并不支持JTA(Java Transaction API)，所以需要借助其他的方案。

     JOTM(Java Open Transaction Manager)是ObjectWeb的一个开源JTA实现，它本身也是开源应用程序服务器JOnAS(Java Open Application Server)的一部分，为其提供JTA支持和分布式事务管理。JOTM同样可以为Tomcat提供JTA支持，以下将对相关的配置进行简单说明，使用的相应版本为：

Jdk1.4.2

Tomcat 4.1.36

JOTM 2.0.x

Oracle 10G

2 How to use

1) 配置Tomcat环境

在$TOMCAT_HOME/conf/ server.xml文件中对应应用的<Context>节点下面配置连接池，添加以下内容：

<Resource name="jdbc/myds" auth="Container"

    type="javax.sql.DataSource"/>

  <ResourceParams name="jdbc/myds">

    <parameter>

      <name>factory</name>

      <value>org.objectweb.jndi.DataSourceFactory</value>

    </parameter>

    <!-- configured by default for PostgreSQL, just change the values

         to set it for your database

    -->

    <parameter><name>username</name><value>wangwang</value></parameter>

    <parameter><name>password</name><value>1235</value></parameter>

       <!-- minimum number of connections in the pool -->

    <parameter><name>min</name><value>10</value></parameter>

       <!-- maximumnumber of connections in the pool -->

       <parameter><name>max</name><value>20</value></parameter>   

    <parameter>

      <name>driverClassName</name>

      <value>oracle.jdbc.driver.OracleDriver</value>

    </parameter>

    <parameter>

      <name>url</name>

      <value>jdbc:oracle:thin:@127.0.0.1:1521:orcl</value>

    </parameter>

    <!--

    <parameter>

      <name>driverClassName</name>

      <value>org.gjt.mm.mysql.Driver</value>

    </parameter>

    <parameter>

      <name>url</name>

      <value>jdbc:mysql://localhost/javatest</value>

    </parameter>

    -->

  </ResourceParams>

  <!-- Resource configuration for UserTransaction

       use JOTM

  -->

  <Resource name="UserTransaction" auth="Container"

    type="javax.transaction.UserTransaction"/>

  <ResourceParams name="UserTransaction">

    <parameter>

      <name>factory</name>

      <value>org.objectweb.jotm.UserTransactionFactory</value>

    </parameter>

    <parameter>

      <name>jotm.timeout</name>

      <value>60</value>

    </parameter>

  </ResourceParams>

2. 添加所需的JAR文件

下载JOTM，将以下文件添加到$TOMCAT_HOME/common/lib/：

jotm.jar

jotm_jrmp_stubs.jar

jotm_iiop_stubs.jar

ow_carol.jar

jta-spec1_0_1.jar

jts1_0.jar

objectweb-datasource.jar

xapool.jar

howl.jar

connector-1_5.jar

同时，还需要添加相应数据库的JDBC包，例如Oracle的classes12.jar

3. 配置JOTM

新建一个carol.properties文件，置于$TOMCAT_HOME/common/classes/，文件内容如下：

# JNDI (Protocol Invocation)

carol.protocols=jrmp

# Local RMI Invocation

carol.jvm.rmi.local.call=true

# do not use CAROL JNDI wrapper

carol.start.jndi=false

# do not start a name server

carol.start.ns=false

# Naming Factory

carol.jndi.java.naming.factory.url.pkgs=org.apache.naming

这样JOTM将不会使用CAROL JNDI wrapper，从而可以避免类装载错误的发生

4. 说明

4.1 JOTM目前的版本在JDK1.5或以上可能无法正常运行，解决的方法有两个：使用JDK1.5重新编译carol库，或者将Tomcat运行在JDK1.4中

4.2 <Transaction>是Tomcat 5中的新标记，对于不支持此标记的老版本，需要使用以下语句代替事务资源的声明：

<!-- Resource configuration for UserTransaction

use JOTM

-->

<Resource name="UserTransaction" auth="Container"

type="javax.transaction.UserTransaction"

factory = "org.objectweb.jotm.UserTransactionFactory"

jotm.timeout = "60"/>

4.3 需要注意的是，使用<Resource>节点声明的资源默认上下文前缀是"java:comp/env"，而使用< Transaction>节点时则是"java:comp"。因此，当使用4.2的方式声明用户事务时，相应的JNDI查找代码也应该改为 UserTransaction ut = (UserTransaction)initCtx.lookup("java:comp/env/UserTransaction");

5. 测试

假设数据库中已经做了相应配置，可以使用如下jsp页面进行测试：

<!--test.jsp-->

<%@page contentType="text/html;charset=GB2312"%>

<%@page import="java.sql.*"%>

<%@page import="javax.sql.*"%>

<%@page import="javax.naming.*"%>

<%@page import="javax.transaction.UserTransaction"%>

<%

ResultSet rs = null;

Statement stmt = null;

UserTransaction ut = null;

Connection conn = null;

try {

Context initCtx = new InitialContext();

Context envCtx = (Context) initCtx.lookup("java:comp/env");

DataSource ds = (DataSource) envCtx.lookup("jdbc/myds");

ut = (UserTransaction)initCtx.lookup("java:comp/UserTransaction");

conn = ds.getConnection();

ut.begin();

System.out.println("<<< beginning the transaction >>>");

stmt = conn.createStatement(

// ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE

);

rs = stmt.executeQuery("SELECT sysdate FROM dual");

rs.next();

} catch(Exception e) {e.printStackTrace();}

%>

<html>

<body>

Original price:

<%=rs.getString(1)%>

<%conn.close();%>

</body>

</html>