messagingEngine - 傳訊引擎 (messagingEngine)

傳訊引擎是在伺服器內執行,用來管理傳訊資源的元件。當應用程式傳送及接受訊息時,它們會連接到傳訊引擎。

傳訊檔案儲存庫。

NameTypeDefaultDescription
pathstring${server.output.dir}/messaging/messageStore檔案儲存庫的路徑。
logFileSizelong
Min: 10
10日誌檔的大小 (MB)。日誌檔大小不能超過檔案儲存庫大小的一半。如果檔案儲存庫大小設為 400 MB,則日誌檔大小不能超過 200 MB。建議的日誌檔大小上限是檔案儲存庫大小的 25%。如果檔案儲存庫大小設為 400 MB,建議的日誌檔大小上限設定是 100 MB。
fileStoreSizelong
Min: 20
400永久和暫時儲存庫的組合大小 (MB)。永久和暫時儲存庫平均分配檔案儲存庫大小。比方說,如果您指定 400 MB 作為檔案儲存庫大小,永久儲存庫會使用 200 MB,暫時儲存庫也會使用 200 MB。

queue

佇列目的地代表訊息佇列,用於點對點傳訊。

NameTypeDefaultDescription
idstring佇列的名稱。
forceReliability
  • ReliableNonPersistent
  • ReliablePersistent
  • ExpressNonPersistent
  • AssuredPersistent
  • BestEffortNonPersistent
AssuredPersistent當生產者未設定明確的可靠性時,這個目的地中所產生之訊息的指派可靠性。
ReliableNonPersistent
ReliableNonPersistent
ReliablePersistent
ReliablePersistent
ExpressNonPersistent
ExpressNonPersistent
AssuredPersistent
AssuredPersistent
BestEffortNonPersistent
BestEffortNonPersistent
exceptionDestinationstring_SYSTEM.Exception.Destination當訊息無法遞送到目的地時,系統所轉遞的訊息目的地。
failedDeliveryPolicy
  • SEND_TO_EXCEPTION_DESTINATION
  • DISCARD
  • KEEP_TRYING
SEND_TO_EXCEPTION_DESTINATION列出當訊息抵達 maxredeliverycount 時,傳訊引擎必須採取的動作。
SEND_TO_EXCEPTION_DESTINATION
SEND_TO_EXCEPTION_DESTINATION
DISCARD
DISCARD
KEEP_TRYING
KEEP_TRYING
redeliveryIntervallong5000當沒有配置異常狀況目的地時,這個目的地在到達失敗遞送上限之後,在重試之間套用的時間間隔。
maxRedeliveryCountint5嘗試處理訊息的失敗次數上限。超過這個失敗嘗試次數之後,如果配置了異常狀況目的地,就會將訊息從預期的目的地轉遞到它的異常狀況目的地。如果未配置異常狀況目的地,就會套用重試之間的時間間隔。
sendAllowedbooleantrue生產者可以將訊息傳給這個目的地。
receiveAllowedbooleantrue清除這個選項(將它設為 false),消費者便無法接收來自這個目的地的訊息。
maintainStrictOrderbooleanfalse維護生產者將訊息傳送到目的地的順序。
maxMessageDepthlong
Min: 1
50000傳訊引擎可以放在其訊息點上的訊息數目上限。

topicSpace

主題空間目的地代表一組「發佈和訂閱」主題,用來進行發佈/訂閱傳訊。

NameTypeDefaultDescription
idstring主題空間的名稱。
forceReliability
  • ReliableNonPersistent
  • ReliablePersistent
  • ExpressNonPersistent
  • AssuredPersistent
  • BestEffortNonPersistent
AssuredPersistent當生產者未設定明確的可靠性時,這個目的地中所產生之訊息的指派可靠性。
ReliableNonPersistent
ReliableNonPersistent
ReliablePersistent
ReliablePersistent
ExpressNonPersistent
ExpressNonPersistent
AssuredPersistent
AssuredPersistent
BestEffortNonPersistent
BestEffortNonPersistent
exceptionDestinationstring_SYSTEM.Exception.Destination當訊息無法遞送到目的地時,系統所轉遞的訊息目的地。
failedDeliveryPolicy
  • SEND_TO_EXCEPTION_DESTINATION
  • DISCARD
  • KEEP_TRYING
SEND_TO_EXCEPTION_DESTINATION列出當訊息抵達 maxredeliverycount 時,傳訊引擎必須採取的動作。
SEND_TO_EXCEPTION_DESTINATION
SEND_TO_EXCEPTION_DESTINATION
DISCARD
DISCARD
KEEP_TRYING
KEEP_TRYING
redeliveryIntervallong5000當沒有配置異常狀況目的地時,這個目的地在到達失敗遞送上限之後,在重試之間套用的時間間隔。
maxRedeliveryCountint5嘗試處理訊息的失敗次數上限。超過這個失敗嘗試次數之後,如果配置了異常狀況目的地,就會將訊息從預期的目的地轉遞到它的異常狀況目的地。如果未配置異常狀況目的地,就會套用重試之間的時間間隔。
sendAllowedbooleantrue生產者可以將訊息傳給這個目的地。
receiveAllowedbooleantrue清除這個選項(將它設為 false),消費者便無法接收來自這個目的地的訊息。
maintainStrictOrderbooleanfalse維護生產者將訊息傳送到目的地的順序。
maxMessageDepthlong
Min: 1
50000傳訊引擎可以放在其訊息點上的訊息數目上限。

alias

別名目的地會對映匯流排目的地的替代名稱。您可以利用別名目的地來進行點對點傳訊或發佈/訂閱傳訊。

NameTypeDefaultDescription
idstring別名佇列或別名主題空間的名稱。
targetDestinationstringDefault.Queue目標目的地參數識別可能與別名目的地在相同匯流排的目的地。依預設,如果沒有設定內容,會指向 Default.Queue。
forceReliability
  • ReliableNonPersistent
  • ReliablePersistent
  • ExpressNonPersistent
  • AssuredPersistent
  • BestEffortNonPersistent
AssuredPersistent當生產者未設定明確的可靠性時,這個目的地中所產生之訊息的指派可靠性。
ReliableNonPersistent
ReliableNonPersistent
ReliablePersistent
ReliablePersistent
ExpressNonPersistent
ExpressNonPersistent
AssuredPersistent
AssuredPersistent
BestEffortNonPersistent
BestEffortNonPersistent
sendAllowed
  • true
  • false
true生產者可以將訊息傳給這個目的地。
true
true
false
false

messagingSecurity

wasJmsServer-1.0 特性安全。

messagingSecurity > role

一組對映至使用者和群組的許可權

NameTypeDefaultDescription
idstring唯一的配置 ID。
namestring角色的名稱。

messagingSecurity > role > queuePermission

在佇列中針對一組使用者和群組所定義的許可權

NameTypeDefaultDescription
idstring唯一的配置 ID。
queueRefstring對「傳訊引擎」中所定義的「佇列」的參照

messagingSecurity > role > queuePermission > action

目的地所容許的作業

messagingSecurity > role > tempDestinationPermission

在暫時目的地中針對一組使用者和群組所定義的許可權

NameTypeDefaultDescription
idstring唯一的配置 ID。
prefixstring為暫時目的地所定義的字首

messagingSecurity > role > tempDestinationPermission > action

目的地所容許的作業

messagingSecurity > role > topicPermission

在主題中針對一組使用者和群組所定義的許可權

NameTypeDefaultDescription
idstring唯一的配置 ID。
topicNamestringTopicSpace 內部的「主題」名稱
topicSpaceRefstringDefault.Topic.Space對「傳訊引擎」中所定義的 TopicSpace 的參照

messagingSecurity > role > topicPermission > action

目的地所容許的作業

messagingSecurity > role > user

指派給特定角色的使用者

NameTypeDefaultDescription
idstring唯一的配置 ID。
namestring定義成登錄一部分的使用者。

messagingSecurity > role > group

指派給角色的群組。

NameTypeDefaultDescription
idstring唯一的配置 ID。
namestring定義成使用者登錄一部分的群組。