xms::PropertyContext | +----xms::Session
有關 XMS 所定義的 Session 物件內容清單, 請參閱Session 內容。
方法 | 說明 |
---|---|
close | 關閉階段作業。 |
commit | 確定現行交易中所有已處理的訊息。 |
createBrowser | 為指定的佇列建立佇列瀏覽器。 |
createBrowser | 使用訊息選取器為指定的佇列建立佇列瀏覽器。 |
createBytesMessage | 建立位元組訊息。 |
createConsumer | 為指定的目的地建立訊息使用端。 |
createConsumer | 使用訊息選取器為指定的目的地建立訊息使用端。 |
createConsumer | 使用訊息選取器為指定的目的地建立訊息使用端,如果目的地為一個主題, 並指定訊息使用端是否接收其本身連線所發佈的訊息。 |
createDurableSubscriber | 為指定的主題建立延續訂閱者。 |
createDurableSubscriber | 使用訊息選取器為指定的主題建立延續訂閱者, 並指定延續訂閱者是否接收其本身連線所發佈的訊息。 |
createMapMessage | 建立對映訊息。 |
createMessage | 建立一則沒有主體的訊息。 |
createObjectMessage | 建立物件訊息。 |
createProducer | 建立訊息生產者以傳送訊息給指定的目的地。 |
createQueue | 建立一個 Destination 物件,以代表傳訊伺服器中的某個佇列。 |
createStreamMessage | 建立串流訊息。 |
createTemporaryQueue | 建立暫時佇列。 |
createTemporaryTopic | 建立暫時主題。 |
createTextMessage | 建立一則空主體的文字訊息。 |
createTextMessage | 建立文字訊息,且其主體已使用指定文字來起始設定。 |
createTopic | 建立一個 Destination 物件,以代表某主題。 |
getAcknowledgeMode | 取得階段作業的確認模式。 |
getHandle | 取得 C 應用程式在存取階段作業時所要使用的控點。 |
getTransacted | 判斷階段作業是否為交易式。 |
isNull | 判斷 Session 物件是否為一個空值物件。 |
recover | 回復 (recove)階段作業。 |
rollback | 回復 (Rollback)現行交易中所有已處理的訊息。 |
unsubscribe | 刪除延續訂閱。 |
xmsVOID close();
關閉階段作業。如果階段作業為交易式, 則會回復任何進行中的交易。
所有和階段作業相依的物件都會刪除。如需哪些物件會被刪除的相關資訊, 請參閱刪除物件。
如果應用程式試著關閉已關閉的階段作業, 則會忽略該呼叫。
QueueBrowser createBrowser(const Destination & queue const String & messageSelector) const;
空值 String 物件表示佇列瀏覽器沒有訊息選取器。
MessageConsumer createConsumer(const Destination & destination, const String & messageSelector) const;
空值 String 物件表示訊息使用端沒有訊息選取器。
MessageConsumer createConsumer(const Destination & destination, const String & messageSelector, const xmsBOOL noLocal) const;
使用訊息選取器為指定的目的地建立訊息使用端,如果目的地為一個主題, 並指定訊息使用端是否接收其本身連線所發佈的訊息。
空值 String 物件表示訊息使用端沒有訊息選取器。
MessageConsumer createDurableSubscriber(const Destination & topic, const String & subscriptionName) const;
此方法不適用於和分配管理系統間的即時連線。
如需延續訂閱者的相關資訊, 請參閱延續訂閱者。
MessageConsumer createDurableSubscriber(const Destination & topic, const String & subscriptionName; const String & messageSelector, const xmsBOOL noLocal) const;
使用訊息選取器為指定的主題建立延續訂閱者, 並指定延續訂閱者是否接收其本身連線所發佈的訊息。
此方法不適用於和分配管理系統間的即時連線。
如需延續訂閱者的相關資訊, 請參閱延續訂閱者。
空值 String 物件表示延續訂閱者沒有訊息選取器。
MessageProducer createProducer(const Destination & destination) const;
如果您指定空值 Destination 物件,則會建立一個沒有目的地的訊息生產者。在此情況下, 應用程式每當使用訊息生產者來傳送訊息時,即必須指定一個目的地。
Destination createTemporaryQueue() const;
暫時佇列的範圍為連線。只有連線所建立的階段作業才能使用暫時佇列。
除非明確刪除或連線結束(看何者較快發生), 暫時佇列會一直存在。
如需暫時佇列的相關資訊,請參閱暫時目的地。
Destination createTemporaryTopic() const;
暫時主題的範圍為連線。只有連線所建立的階段作業才能使用暫時主題。
除非明確刪除或連線結束(看何者較快發生), 暫時主題會一直存在。
如需暫時主題的相關資訊,請參閱暫時目的地。
xmsINT getAcknowledgeMode() const;
交易式階段作業沒有確認模式。
如需確認模式的相關資訊,請參閱在階段作業中確認收到訊息。
xmsVOID recover() const;
回復 (recove)階段作業。訊息遞送會停止, 然後使用最舊的未確認訊息重新啟動。
階段作業不得為交易式階段作業。
如需回復 (recove)階段作業的相關資訊, 請參閱在階段作業中確認收到訊息。
xmsVOID unsubscribe(const String & subscriptionName) const;
刪除延續訂閱。傳訊伺服器會刪除它所維護的延續訂閱記錄, 且不會傳送任何進一步的訊息給延續訂閱者。
此方法不適用於和分配管理系統間的即時連線。