在创建 CARMA 层次结构的根节点期间会建立 CARMA
连接。
关于此任务
CARMA
层次结构的根节点为
CARMA
对象,在创建期间必须将它配置为使用 CARMA 传输。要为 CARMA 层次结构创建根节点并配置其 CARMA
传输,请遵循下列步骤:
过程
- 使用工厂类 com.ibm.carma.CARMASystemFactory 来创建 CARMA
对象(通过 getInstance 方法),如以下示例代码中所说明:
String identifier = "ConnectionIdentifier";
Map connectionProperties = new TreeMap();
// insert your code to configure the connection properties here
CARMA carma = CARMASystemFactory.getInstance().getCARMAInstance(identifier, connectionProperties);
标识字符串必须对于 CARMA 层次结构唯一。当前,唯一有效的传输为缺省情况下使用的
RSE 传输服务(如果您正在使用需要指定后端标识的备用方法调用,那么可以通过传递后端标识值“com.ibm.carma.client.rse.datastore”来选择
RSE 传输服务)。
连接属性映射会为传输配置选项存储键/值对。如果该映射中未指定您正在使用的传输的必需参数,那么
getCARMAInstance 方法将抛出 CARMAException。RSE
传输服务要求您为连接属性映射中的键“aliasName”指定值。对于键“aliasName”的值,请对与 CARMA
主机进行通信时要使用的 RSE 连接指定名称。
- 存储对 CARMA 层次结构的引用,以便将来在 CARMA 注册表中进行检索:
CarmaRegistry.getRegistry().addCarma(carma);
单件 CarmaRegistry
对象由 CARMABrowser
对象用来维护已知 CARMA 连接列表。当将对象添加至 CARMA
层次结构或从该层次结构中除去对象时,会将事件发送至已注册侦听器。可以通过将
CARMA 层次结构的标识传递到 CARMA 注册表的 getCARMA
方法中来从 CARMA 注册表中检索该层次结构。
下一步做什么
现在,可以通过使用
connect 方法来连接至
CARMA 对象的 CARMA 主机。