SBB Local Interface 详解

SBB Local Interface 详解

SBB Local Interface 的基本原理

SBB(Service Building Block)实体可以通过目标SBB的本地接口(SBB Local Interface)以同步的方式调用其他SBB实体。这种调用仅限于同一个JVM(Java虚拟机)内部的SBB对象之间,因为它们必须在同一个JVM内驻留。因此,称之为“SBB本地接口”。为了能够被同步调用,一个SBB需要声明SBB本地接口,该接口声明可以同步调用的方法。SBB本地对象(SBB Local Object)是SLEE实现的类的实例,这些类实现了SBB本地接口。

如何获取 SBB Local Object

SBB可以通过以下几种机制获取代表SBB实体的SBB本地对象:

  1. 通过ChildRelation对象的create方法: 当SBB通过create方法创建子SBB实体时,返回的对象是实现了子SBB实体的SBB本地接口的对象。
  2. 通过SbbContext的getSbbLocalObject方法: 通过SbbContext对象调用getSbbLocalObject方法获取。
  3. 方法调用的返回值: 当一个SBB本地对象的方法调用时,SBB实体可以通过方法的返回值或者参数获得其他SBB本地对象。
  4. 从CMP字段中获取: 可以从CMP(容器管理持久化)字段中检索到SBB本地对象。
  5. 通过实现java.util.Collection接口的ChildRelation对象: ChildRelation对象及其迭代器可以访问SBB本地对象。
SBB Local Object 的功能

持有SBB本地对象的SBB对象可以执行以下操作:

  1. 测试是否为相同的SBB实体: 通过SBB Local Object判断两个SBB Local Object是否代表相同的SBB实体。
  2. 删除SBB实体: 删除SBB Local Object代表的SBB实体及其子实体。
  3. 设置和获取事件的传递优先级: 可以设置和获取SBB实体的事件传递优先级。
  4. 调用自定义方法: 可以调用SBB开发者定义的SBB本地对象的方法。
  5. 在方法调用中传递SBB本地对象: SBB本地对象可以作为方法参数或返回值。
  6. 存储在CMP字段中: SBB本地对象可以存储在CMP字段中以便持久化使用。
使用场景

典型场景:

  1. 父SBB实体通过ChildRelation对象创建一个子SBB实体,create方法返回代表子SBB实体的SBB本地对象。
  2. 父SBB或其他SBB可以通过SBB Local Object同步调用子SBB实体的自定义方法,SLEE系统会管理SBB实体的状态及其对象池。
  3. 如果目标SBB实体已经删除,调用SBB本地对象的方法会抛出TransactionRolledbackLocalException异常。

Pass-by-reference 语义:
SBB本地接口的方法参数是以引用传递的,这意味着调用方和被调用方可能会引用相同的Java对象。因此,开发者需要注意同一对象的共享和修改。调用方如果不希望被调用方修改数据,应该在传递之前复制数据。

SbbLocalObject 接口详解

SbbLocalObject接口是所有SBB本地接口的基接口,SLEE提供其实现,具体方法包括:

  1. isIdentical 方法: 判断两个SBB本地对象是否代表同一个SBB实体。必须在事务上下文中调用。
  2. setSbbPrioritygetSbbPriority 方法: 设置或获取SBB实体的事件传递优先级,优先级范围为-128到127。
  3. remove 方法: 删除SBB实体及其子树,进行级联删除。
使用SBB Local Interface的场景示例
代码示例
  1. 获取SBB本地对象:
public class ParentSbb implements Sbb {
    // 获取子SBB本地对象
    public ChildSbbLocalObject createChildSbb() throws Exception {
        ChildRelation childRelation = getChildRelation();  // 假设已有ChildRelation对象
        ChildSbbLocalObject child = (ChildSbbLocalObject) childRelation.create();
        return child;
    }
}
  1. 调用SBB本地对象方法:
public class ParentSbb implements Sbb {
    public void invokeChildMethod() throws Exception {
        ChildSbbLocalObject child = createChildSbb();
        child.customMethod();  // 调用子SBB的自定义方法
    }
}
  1. 设置SBB优先级:
public void setPriority(ChildSbbLocalObject child) {
    child.setSbbPriority((byte) 10);  // 设置优先级
}
配置示例
  1. SBB XML配置:
<sbb>
    <sbb-name>ParentSbb</sbb-name>
    <sbb-vendor>com.example</sbb-vendor>
    <sbb-version>1.0</sbb-version>
    <sbb-alias>parent</sbb-alias>

    <sbb-classes>
        <sbb-class>com.example.sbb.ParentSbb</sbb-class>
    </sbb-classes>

    <sbb-child-relations>
        <child-relation>
            <name>childRelation</name>
            <sbb-ref>
                <sbb-name>ChildSbb</sbb-name>
                <sbb-vendor>com.example</sbb-vendor>
                <sbb-version>1.0</sbb-version>
            </sbb-ref>
        </child-relation>
    </sbb-child-relations>
</sbb>
小结

SBB Local Interface允许同一JVM中的SBB实体通过同步方式调用其他SBB实体。通过该机制,开发者可以创建更高效的服务块协作模型,同时提供事务处理和异常控制。

上一篇:类与对象 中(剩余部分) 以及 日历-运算符重载


下一篇:57 Python字符串与序列化-序列化与反序列化