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

ConnectionFactory

應用程式會使用 Connection Factory 來建立連線。

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

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

相關概念
Connection Factory 和連線
連接 WebSphere 服務整合匯流排
相關工作
建立受管理物件

建構子

建構子摘要:
建構子 說明
ConnectionFactory 使用預設內容來建立 Connection Factory。

ConnectionFactory – 建立 Connection Factory

介面:
ConnectionFactory();

使用預設內容來建立 Connection Factory。

參數:
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

方法

方法摘要:
方法 說明
~ConnectionFactory 刪除 Connection Factory。
createConnection 使用預設使用者身分來建立 Connection Factory。
createConnection 使用指定的使用者身分來建立連線。
getHandle 取得 C 應用程式在存取 Connection Factory 時所要使用的控點。
isNull 判斷 ConnectionFactory 物件是否為一個空值物件。

~ConnectionFactory – 刪除 Connection Factory

介面:
virtual ~ConnectionFactory();

刪除 Connection Factory。

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

參數:
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

createConnection – 建立連線(使用預設使用者身分)

介面:
Connection createConnection();

使用預設使用者身分來建立 Connection Factory。

若有設定 Connection Factory 的 XMSC_USERID 和 XMSC_PASSWORD 內容,則會用來鑑別應用程式。如果沒有設定這些內容, 只要傳訊伺服器容許在不鑑別下進行連線, 則會建立連線而不鑑別應用程式。如果應用程式是在連結模式下連接 WebSphere MQ 佇列管理程式, 則會忽略這些內容。

連線是在停止模式下建立的。在應用程式呼叫 Connection.start() 之前都不會遞送訊息。

參數:
傳回:
Connection 物件。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

createConnection – 建立連線(使用指定的使用者身分)

介面:
Connection createConnection(const String & userID,
                            const String & password);

使用指定的使用者身分來建立連線。

指定的使用者 ID 和密碼會用來鑑別應用程式。若有設定 Connection Factory 的 XMSC_USERID 和 XMSC_PASSWORD 內容,則會被忽略。如果應用程式是在連結模式下連接 WebSphere MQ 佇列管理程式, 則會忽略使用者 ID 和密碼。

連線是在停止模式下建立的。在應用程式呼叫 Connection.start() 之前都不會遞送訊息。

參數:
userID(輸入)
此 String 物件封裝了用來鑑別應用程式的使用者 ID。如果您指定空值的 String 物件, 則會改用 Connection Factory 的 XMSC_USERID 內容。
password(輸入)
此 String 物件封裝了用來鑑別應用程式的密碼。如果您指定空值的 String 物件, 則會改用 Connection Factory 的 XMSC_PASSWORD 內容。
傳回:
Connection 物件。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_SECURITY_EXCEPTION

getHandle – 取得控點

介面:
xmsHConnFact getHandle() const;

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

參數:
傳回:
Connection Factory 的控點。
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

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

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

繼承的方法


Reference topic

使用條款 | 評比此網頁

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