WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

Destination

目的地是應用程式送出訊息所在,或是應用程式從中收到訊息的來源(或兩者)。

繼承階層:
xms::PropertyContext
   |
   +----xms::Destination

有關 XMS 所定義的 Destination 物件內容清單, 請參閱Destination 內容

相關概念
Connection Factory 和連線
連接 WebSphere 服務整合匯流排
目的地
目的地的萬用字元
主題統一資源識別碼 (URI)
佇列統一資源識別碼 (URI)
暫時目的地
相關工作
建立受管理物件

建構子

建構子摘要:
建構子 說明
Destination 使用指定的目的地類型和名稱來建立目的地。
Destination 使用指定的統一資源識別碼 (URI) 來建立目的地。

Destination – 建立目的地(指定類型和名稱)

介面:
Destination(const xmsDESTINATION_TYPE destinationType,
            const String & destinationName);

使用指定的目的地類型和名稱來建立目的地。

如果目的地是一個佇列, 則這個建構子不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個建構子。

參數:
destinationType(輸入)
目的地的類型,其值必須是下列之一:
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
destinationName(輸入)
此 String 物件封裝目的地的名稱,它可以是佇列名稱或主題名稱。
如果目的地為一個 WebSphere MQ 佇列,您可以採用下列方式之一來指定目的地的名稱:
  • QName
  • QMgrName/QName
其中,QNameWebSphere MQ 佇列的名稱, QMgrNameWebSphere MQ 佇列管理程式的名稱。WebSphere MQ 佇列名稱解析程序會使用 QNameQMgrName 的值來判斷實際的目的地佇列。如需佇列名稱解析程序的相關資訊, 請參閱WebSphere MQ 應用程式設計手冊
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Destination – 建立目的地(使用 URI)

介面:
Destination(const String & URI);

使用指定的統一資源識別碼 (URI) 來建立目的地。在 URI 沒有指定的目的地內容方面, 則會採用預設值。

如果目的地是一個佇列, 則這個建構子不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個建構子。

參數:
URI(輸入)
封裝 URI 的 String 物件。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

方法

方法摘要:
方法 說明
~Destination 刪除目的地。
getHandle 取得 C 應用程式在存取目的地時所要使用的控點。
getName 取得目的地的名稱。
getTypeId 取得目的地的類型。
isNull 判斷 Destination 物件是否為一個空值物件。
toString 取得採用統一資源識別碼 (URI) 格式的目的地名稱。

~Destination – 刪除目的地

介面:
virtual ~Destination();

刪除目的地。

如果目的地是一個佇列, 此方法不會刪除傳訊伺服器中的佇列,除非所建立的佇列是作為 XMS 暫時佇列。

如果應用程式試著刪除已刪除的目的地, 則會忽略該呼叫。

參數:
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 取得控點

介面:
xmsHDest getHandle() const;

取得 C 應用程式在存取目的地時所要使用的控點。

參數:
傳回:
目的地的控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getName – 取得目的地名稱

介面:
String getName() const;

取得目的地的名稱。

參數:
傳回:
封裝目的地名稱的 String 物件。此名稱可以是佇列名稱或主題名稱。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getTypeId – 取得目的地類型

介面:
xmsDESTINATION_TYPE getTypeId();

取得目的地的類型。

參數:
傳回:
目的地的類型,其值為下列之一:
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

判斷 Destination 物件是否為一個空值物件。

參數:
傳回:
  • 如果 Destination 物件為空值物件,則為 xmsTRUE
  • 如果 Destination 物件不是空值物件,則為 xmsFALSE
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

toString – 以 URI 形式取得目的地名稱

介面:
String toString() const;

取得採用統一資源識別碼 (URI) 格式的目的地名稱。

參數:
傳回:
封裝 URI 的 String 物件。URI 可以是佇列 URI 或主題 URI。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

繼承的方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)