bboss persistent事务管理介绍 （十）

 

4.9.9.3 BaseSPIManager组件

l        包路径及接口说明

BaseSPIManager的完整包路径如下：

com.chinacreator.spi.BaseSPIManager

BaseSPIManager提供了以下两个静态管理接口：

l         接口1  获取id为managerid的管理服务接口实例

AI a = (AI)BaseSPIManager.getProvider("managerid");

 

l         接口2  获取id为managerid的管理服务接口实例，参数二对应多个provider中相应的provider 类型标识

AI a = (AI)BaseSPIManager.getProvider("managerid","providertype");

方法1和方法2的区别是：方法1的返回值和抛出的异常以默认的provider的相应方法的返回值和异常为准，方法2返回值和抛出的异常以指定类型的provider的相应方法的返回值和异常为准。方法1和方法2的事务管理机制是一致和相同的。

这两个接口返回的对象类型为java.lang.Object,调用程序可以将该对象转型为相应的组件接口类型。

l        使用BaseSPIManager获取组件实例和直接创建组件实例的区别

只有通过BaseSPIManager提供的两个方法获取接口实例，然后在接口实例上调用事务方法，声明的事务管理才会生效，否则无效。举例说明如下：

假如接口AI和接口实现类A，接口中定义了方法handle，并且将该方法声明为事务方法，

在配置文件中做以下的配置：

<manager id="test.A" singlable="true" >

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

           class="test.A" />

<transactions>

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

</transactions>

</manager>

 

声明组件的管理id为test.A,我们通过以下两种方式获取接口实例：

方法1 直接创建对象实例a,在实例a上调用handle方法

AI a = new A();

a.handle();

采用这种方式时，为handle方法声明的事务不会生效。

方法2 通过BaseSPIManager提供的接口获取接口实例

AI a = (AI)BaseSPIManager.getProvider("test.A");

a.handle();

采用这种方式，为handle方法声明的事务才会生效。

业务组件必须由两部分组成：组件接口，组件接口的实现类；这是因为通过BaseSPIManager的两个方法所获取到的对象必需是一个接口对象，这里不能直接将返回值直接转换为具体的实现类型，以下的用法是正确的：

AI a = (AI)BaseSPIManager.getProvider("test.A");

以下的用法是不正确的，但是编译时不会报错，运行时会报类型转换错误，这是因为方法返回的是一个实现接口AI的代理对象，而不是一个A类型的对象了：

A a = (A)BaseSPIManager.getProvider("test.A");