在建立 CARMA 階層的根節點期間,會建立 CARMA 連線。
關於這項作業
CARMA 階層的根節點是
CARMA 物件,在建立期間,必須對該物件進行配置才能使用
CARMA 傳輸。若要為 CARMA 階層建立根節點並配置其 CARMA 傳輸,請遵循下列步驟:
程序
- 使用 Factory 類別 com.ibm.carma.CARMASystemFactory 建立具有 getInstance 方法的
CARMA 物件,如下列程式碼範例所示:
String identifier = "ConnectionIdentifier";
Map connectionProperties = new TreeMap();
// insert your code to configure the connection properties here
CARMA carma = CARMASystemFactory.getInstance().getCARMAInstance(identifier, connectionProperties);
ID 字串對於 CARMA 階層必須是唯一的。目前,唯一有效的傳輸是
RSE 傳輸服務,依預設,會使用該傳輸服務(如果要使用需要指定後端系統 ID 的替代方法呼叫,則可以透過傳遞後端系統 ID 值
"com.ibm.carma.client.rse.datastore",選取 RSE 傳輸服務)。
連線內容對映儲存傳輸配置選項的鍵值組。如果未在對映中指定要使用的傳輸的必要參數,getCARMAInstance
方法將會擲出 CARMAException。RSE 傳輸服務需要您在連線內容對映中指定鍵 "aliasName" 的值。對於鍵
"aliasName" 的值,請提供與 CARMA 主機通訊時要使用的 RSE 連線的名稱。
- 儲存對 CARMA 階層的參照,以便日後在 CARMA 登錄中擷取:
CarmaRegistry.getRegistry().addCarma(carma);
CARMABrowser 物件使用單態
CarmaRegistry
物件來維護已知 CARMA 連線清單。當將物件新增至 CARMA 階層,或者從
CARMA 階層移除物件時,會將事件傳送至已登錄的接聽器。可以從 CARMA 登錄擷取
CARMA 階層,方法是將其 ID 傳遞到 CARMA 登錄的 getCARMA 方法中。
下一步
現在,可以使用
connect 方法連接
CARMA 物件的 CARMA 主機。