xms::PropertyContext | +----xms::MessageProducer
有關 XMS 所定義的 MessageProducer 物件內容清單, 請參閱MessageProducer 內容。
方法 | 說明 |
---|---|
close | 關閉訊息生產者。 |
getDeliveryMode | 取得訊息生產者所送訊息的預設遞送模式。 |
getDestination | 取得訊息生產者的目的地。 |
getDisableMsgID | 取得接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID 的指示。 |
getDisableMsgTS | 取得接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記的指示。 |
getHandle | 取得 C 應用程式在存取訊息生產者時所要使用的控點。 |
getPriority | 取得訊息生產者所送訊息的預設優先順序。 |
getTimeToLive | 取得訊息的預設存在時間長度,一旦超過即算到期。 |
isNull | 判斷 MessageProducer 物件是否為一個空值物件。 |
send | 傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。 |
send | 傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。 |
send | 如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。 |
send | 如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。 |
setDeliveryMode | 設定訊息生產者所送訊息的預設遞送模式。 |
setDisableMsgID | 指出接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID。 |
setDisableMsgTS | 指出接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記。 |
setPriority | 設定訊息生產者所送訊息的預設優先順序。 |
setTimeToLive | 設定訊息的預設存在時間長度,一旦超過即算到期。 |
xmsVOID send(const Message & message, const xmsINT deliveryMode, const xmsINT priority, const xmsLONG timeToLive) const;
傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
xmsVOID send(const Destination & destination, const Message & message) const;
如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。
一般而言, 您會在建立訊息生產者時指定一個目的地, 如果您沒有指定,則每當傳送訊息時您都必須指定一個目的地。
xmsVOID send(const Destination & destination, const Message & message, const xmsINT deliveryMode, const xmsINT priority, const xmsLONG timeToLive) const;
如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。
一般而言, 您會在建立訊息生產者時指定一個目的地, 如果您沒有指定,則每當傳送訊息時您都必須指定一個目的地。
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
xmsVOID setDeliveryMode(const xmsINT deliveryMode);
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
預設值為 XMSC_DELIVERY_PERSISTENT,但如果是和分配管理系統間的即時連線, 則預設值會是 XMSC_DELIVERY_NON_PERSISTENT。
xmsVOID setDisableMsgID(const xmsBOOL msgIDDisabled);
指出接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID。
若為和佇列管理程式間的連線, 或和分配管理系統間的即時連線,則會忽略此旗標。若為和服務整合匯流排間的連線,則會採用此旗標。
xmsVOID setDisableMsgTS(const xmsBOOL timeStampDisabled);
指出接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記。
若為和分配管理系統間的即時連線, 則會忽略此旗標。若為和佇列管理程式間的連線或是和服務整合匯流排間的連線,則會採用此旗標。