bboss persistent事务管理介绍 （七）

 

l        配置步骤

从上述的语法当中可以看出，要声明一个业务组件的事务方法的步骤为：

第一步 准备好业务组件，参考下面的模型

第二步 在配置文件中配置一个管理服务，也就是添加一个manager元素(指定管理服务的惟一标识id属性，是否单实例singlable属性)，

第三步 在manager中配置一个或者多个provider（管理服务提供者，每个管理服务提供者需要指定自己的type属性，以及具体的实现类class）

第四步 在transactions元素中使用method元素、rollbackexcepiton元素、exception元素、param元素声明所有需要进行事务控制的方法以及控制事务的规则。

l        配置示例

<manager-config>

    <manager id="tx.a" singlable="false" >

       <!--

           属性描述：

           type：代表数据存储的类型,例如DB，LDAP,ACTIVEDIRECTORY等等

           default:缺省实现，不管used是否指定都会在同步方法中调用

           class：实现类代码

           used：标识是否使用，默认为false

       -->

       <provider type="DB" default="true"

           class="com.chinacreator.spi.transaction.A1" />

   

       <!-- 

           在下面的节点对provider的业务方法事务进行定义

           只要将需要进行事务控制的方法配置在transactions中即可

          

       -->

       <transactions>

           <!--

              定义需要进行事务控制的方法

              属性说明：

              name-方法名称，可以是一个正则表达式，正则表达式的语法请参考jakarta-oro的相关文档，如果使用

              正则表达式的情况时，则方法中声明的方法参数将被忽略，但是回滚异常有效。

              pattern-方法名称的正则表达式匹配模式，通常匹配

              txtype-需要控制的事务类型，取值范围：

              NEW_TRANSACTION，

              REQUIRED_TRANSACTION，

              MAYBE_TRANSACTION，

              NO_TRANSACTION

           -->

           <!--

           模式匹配，模式匹配的顺序受配置位置的影响，如果配置在后面或者中间，那么会先执行之前的方法匹配，如果匹配上了就不会

           对该模式方法进行匹配了，否则执行匹配操作。

      

           如果匹配上特定的方法名称，那么这个方法就是需要进行同步的方法

           模式testInt.*匹配接口中以testInt开头的任何方法

            -->

           <method name="testTXInvoke" txtype="NEW_TRANSACTION">

              <param type="java.lang.String"/>

           </method>        

          

           <method name="testTXInvoke" txtype="REQUIRED_TRANSACTION"/>

          

           <method name="testTXInvokeWithReturn" txtype="REQUIRED_TRANSACTION"/>

          

           <method name="testTXInvokeWithException" txtype="MAYBE_TRANSACTION"/>    

          

           <method name="testSameName" txtype="NO_TRANSACTION"/>

          

           <method name="testSameName1">

              <param type="java.lang.String"/>

           </method>

           <!--              

                  定义使事务回滚的异常,如果没有明确声明需要回滚事务的异常，那么当有异常发生时，事务管理框架将自动回滚当前事务

                  class-异常的完整类路径

                  type-是否检测类型异常的子类控制标识，

                  IMPLEMENTS只检测异常类本身，忽略异常类的子类；

                  INSTANCEOF检查异常类本省及其所有子类

                 

              -->