.NET 介面

本節說明 .NET 類別介面及其內容和方法。

下表彙總定義在 IBM.XMS 名稱空間內的介面。

表 1. .NET 類別介面的摘要
介面 說明
IBytesMessage 位元組訊息是其內文包含位元組串流的訊息。
IConnection Connection 物件代表應用程式與傳訊伺服器的作用中連線。
IConnectionFactory 應用程式使用 Connection Factory 來建立連線。
IConnectionMeta資料 ConnectionMeta資料物件提供連線的相關資訊。
IDestination 目的地是應用程式傳送訊息的地方,及(或)應用程式從中接收訊息的來源。
ExceptionListener 應用程式使用異常狀況接聽器,以非同步方式收到連線問題的通知。
IllegalState異常狀況 如果應用程式在不正確或不適當的時間呼叫方法,或 XMS 不是處於所要求作業的適當狀態,則 XMS 會擲出此異常狀況。
InitialContext 應用程式使用 InitialContext 物件,從從受管理物件儲存庫擷取的物件定義建立物件。
InvalidClientIDException 如果應用程式嘗試設定連線的用戶端 ID ,但用戶端 ID 無效或已在使用中,則 XMS 會擲出此異常狀況。
InvalidDestination異常狀況 如果應用程式指定無效的目的地,則 XMS 會擲出此異常狀況。
InvalidSelector異常狀況 如果應用程式提供語法無效的訊息選取器表示式,則 XMS 會擲出此異常狀況。
IMapMessage 對映訊息是其內文包含一組名稱/值配對的訊息,其中每一個值都具有相關聯的資料類型。
iMessage 訊息物件代表應用程式傳送或接收的訊息。 IMessage 是訊息類別的超類別,例如 IMapMessage。
IMessageConsumer 應用程式使用訊息消費者接收已傳送至目的地的訊息。
MessageEOFException 當應用程式讀取位元組訊息的內文時,如果 XMS 發現位元組訊息串流結尾,則 XMS 會擲出此異常狀況。
MessageFormat異常狀況 如果 XMS 發現格式無效的訊息,則 XMS 會擲出此異常狀況。
IMessageListener (委派) 應用程式使用訊息接聽器來非同步接收訊息。
MessageNotReadableException 如果應用程式嘗試讀取只寫入的訊息內文,則 XMS 會擲出此異常狀況。
MessageNotWritableException 如果應用程式嘗試寫入唯讀訊息的內文,則 XMS 會擲出此異常狀況。
IMessageProducer 應用程式使用訊息產生者將訊息傳送至目的地。
IObjectMessage 物件訊息是其內文包含已序列化 Java.NET 物件的訊息。
IPropertyContext IPropertyContext 是抽象超類別,包含取得和設定內容的方法。 這些方法由其他類別繼承。
IQueueBrowser 應用程式使用佇列瀏覽器來瀏覽佇列上的訊息,而不移除它們。
要求者 應用程式使用要求者來傳送要求訊息,然後等待並接收回覆。
ResourceAllocation異常狀況 如果 XMS 無法配置方法所需的資源,則 XMS 會擲出此異常狀況。
SecurityException 如果提供用來鑑別應用程式的使用者 ID 和密碼遭到拒絕, XMS 會擲出此異常狀況。 XMS 也會在權限檢查失敗並阻止方法完成時擲出此異常狀況。
ISession 階段作業是用於傳送及接收訊息的單一執行緒環境定義。
IStreamMessage 串流訊息是其內文包含值串流的訊息,其中每一個值都具有相關聯的資料類型。
ITextMessage 文字訊息是其內文包含字串的訊息。
TransactionInProgressException 如果應用程式因為交易進行中而要求無效的作業,則 XMS 會擲出此異常狀況。
TransactionRolledBackException 如果應用程式呼叫 Session.commit() 來確定現行交易,但隨後又回復該交易,則 XMS 會擲出此異常狀況。
XMSC 對於 .NETXMS 內容名稱及值在此類別中定義為公用常數。 如需進一步詳細資料,請參閱 XMS 物件的內容
XMSException 如果 XMS 在處理 .NET 方法的呼叫時偵測到錯誤, XMS 會擲出異常狀況。 異常狀況是封裝錯誤相關資訊的物件。

有不同類型的 XMS 異常狀況,而 XMSException 物件只是一種異常狀況類型。 不過, XMSException 類別是其他 XMS 異常狀況類別的超類別。 XMS 在任何其他類型的異常狀況都不適當的情況下,會擲出 XMSException 物件。

XMSFactoryFactory 如果應用程式未使用受管理物件,請使用此類別來建立 Connection Factory、佇列及主題。

每一個方法的定義都會列出 XMS 在處理方法呼叫時偵測到錯誤時可能傳回的異常狀況碼。 每一個異常狀況碼都由其具名常數代表,其具有對應的異常狀況。