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

IConnection

Connection 物件代表一條應用程式至分配管理系統的作用中連線。

繼承階層:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IConnection

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

.NET 內容

.NET 內容摘要:
.NET 內容 說明
ClientID 取得和設定連線的用戶端 ID。
ExceptionListener 取得已向連線登錄的異常狀況接聽器, 並向連線登錄一個異常狀況接聽器。
MetaData 取得連線的 meta 資料。

ClientID – 取得和設定用戶端 ID

介面:
String ClientID
      {
        get;
        set;
      }

取得和設定連線的用戶端 ID。

用戶端 ID 可由管理者預先配置在 ConnectionFactory 中,或者藉由設定 ClientID 來指派。

用戶端 ID 只用來在發佈/訂閱網域中支援延續訂閱, 若在點對點網域中則會被忽略。

如果應用程式要設定連線的用戶端 ID,則 應用程式會在建立連線後旋即執行此作業,然後再對連線執行其他任何作業。如果應用程式在過了該時間點後才試著設定用戶端 ID, 則呼叫會擲出 IllegalStateException 異常狀況。

此內容不適用於和分配管理系統間的即時連線。

異常狀況:
  • XMSException
  • IllegalStateException
  • InvalidClientIDException

ExceptionListener – 取得和設定異常狀況接聽器

介面:
	ExceptionListener ExceptionListener
        {
          get;
          set;
        }

取得已向連線登錄的異常狀況接聽器, 並向連線登錄一個異常狀況接聽器。

如果沒有任何異常狀況接聽器向連線登錄, 則方法會傳回空值。若有異常狀況接聽器已向連線登錄, 您可以改為指定一個空值(而不指定異常狀況接聽器),以取消登錄。

如需使用異常狀況接聽器的相關資訊, 請參閱在 .NET 中使用訊息和異常狀況接聽器

異常狀況:
  • XMSException

MetaData – 取得 meta 資料

介面:
IConnectionMetaData MetaData
    {
      get;
    }

取得連線的 meta 資料。

異常狀況:
  • XMSException

方法

方法摘要:
方法 說明
Close 關閉連線。
CreateSession 建立階段作業。
Start 針對連線啟動或重新啟動送入訊息的遞送。
Stop 針對連線停止送入訊息的遞送。

Close – 關閉連線

介面:
void  Close();

關閉連線。

如果應用程式試著關閉已關閉的連線, 則會忽略該呼叫。

參數:
傳回:
Void
異常狀況:
  • XMSException

CreateSession – 建立階段作業

介面:
	ISession CreateSession(Boolean transacted, 
                         AcknowledgeMode acknowledgeMode);

建立階段作業。

參數:
transacted(輸入)
True 表示階段作業為交易式。值 False 表示階段作業不是交易式。

若為和分配管理系統間的即時連線, 此值必須是 False

acknowledgeMode(輸入)
指出如何確認應用程式所接收的訊息。此值必須是下列 AcknowledgeMode 列舉元之一:
  • AcknowledgeMode.AutoAcknowledge
  • AcknowledgeMode.ClientAcknowledge
  • AcknowledgeMode.DupsOkAcknowledge
若為和分配管理系統間的即時連線,此值必須是 AcknowledgeMode.AutoAcknowledgeAcknowledgeMode.DupsOkAcknowledge

如果階段作業為交易式, 則會忽略這個參數。如需確認模式的相關資訊,請參閱在階段作業中確認收到訊息

傳回:
Session 物件。
異常狀況:
  • XMSException

Start – 啟動連線

介面:
void  Start();

針對連線啟動或重新啟動送入訊息的遞送。如果連線已啟動,則會忽略呼叫。

參數:
傳回:
Void
異常狀況:
  • XMSException

Stop – 停止連線

介面:
void  Stop();

針對連線停止送入訊息的遞送。如果連線已停止,則會忽略呼叫。

參數:
傳回:
Void
異常狀況:
  • XMSException

繼承的內容和方法


Reference topic

使用條款 | 評比此網頁

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