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

佇列瀏覽器

應用程式會使用佇列瀏覽器來瀏覽佇列上的訊息,而不移除它們。

若要建立佇列瀏覽器,應用程式可呼叫 Session 物件的「建立佇列瀏覽器」方法, 並以參數方式指定一個 Destination 物件以識別所要瀏覽的佇列。應用程式可建立一個使用或不使用訊息選取器的佇列瀏覽器。

在建立佇列瀏覽器後,應用程式可呼叫 QueueBrowser 物件的「取得訊息」方法, 來取得佇列上的訊息清單。訊息清單會以一個疊代子方式傳回, 其中封裝了一份 Message 物件清單。清單中的 Message 物件次序和從佇列擷取訊息的次序相同。如此一來, 應用程式可使用疊代子依序瀏覽每一則訊息。

只要訊息被放到佇列上以及從佇列中移除時, 即會動態更新疊代子。每當應用程式使用疊代子來瀏覽佇列中的下一則訊息時, 所傳回的訊息會反映佇列的現行內容。只要疊代子指出佇列中已無訊息, 疊代子即停止傳回該點以後的訊息,即使佇列中有進一步的訊息送達。不過,藉由呼叫 Iterator 物件的「重設疊代子」方法, 應用程式可繼續使用相同的疊代子,從佇列開頭開始瀏覽訊息。

應用程式可針對給定的佇列瀏覽器,呼叫「取得訊息」方法多次。每次呼叫都會傳回新的疊代子。如此一來,應用程式可使用一個以上的疊代子來瀏覽佇列上的訊息, 並維護佇列中的多個位置。

應用程式可使用佇列瀏覽器來搜尋適合從佇列中移除的訊息, 然後透過一個採用訊息選取器的訊息使用端來移除該訊息。訊息選取器可根據 JMSMessageID 標頭欄位的值來選取訊息。相關資訊和其他 JMS 訊息標頭欄位的說明, 請參閱XMS 訊息中的標頭欄位


Concept topic

使用條款 | 評比此網頁

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