パッケージ jakarta.jms
インターフェース DeliveryMode
public interface DeliveryMode
Jakarta Messaging API でサポートされている配信モードはPERSISTENT
およびNON_PERSISTENT
です。クライアントは、メッセージが転送中に失われた場合にアプリケーションに問題があると感じた場合、メッセージを永続としてマークします。時折失われるメッセージが許容できる場合、クライアントはメッセージを非永続的としてマークします。クライアントは配信モードを使用して、メッセージ転送の信頼性とスループットのバランスをとる方法を Jakarta Messaging プロバイダーに指示します。
配信モードは、メッセージの宛先への転送のみを対象としています。受信が確認されるまで宛先にメッセージが保持されることは、
PERSISTENT
配信モードでは保証されません。クライアントは、メッセージ保持ポリシーが管理上設定されていると想定する必要があります。メッセージ保持ポリシーは、宛先からメッセージコンシューマーへのメッセージ配信の信頼性を管理します。例: クライアントのメッセージストレージスペースが使い果たされた場合、一部のメッセージはサイト固有のメッセージ保持ポリシーに従ってドロップされる可能性があります。メッセージの配信モードが
PERSISTENT
であり、宛先に十分なメッセージ保持ポリシーがある場合、メッセージは Jakarta Messaging プロバイダーによって 1 回だけ配信されることが保証されます。- 導入:
- JMS 1.0
- バージョン:
- Jakarta Messaging 2.0
フィールドサマリー
フィールド 修飾子と型 フィールド 説明 static int
NON_PERSISTENT
これは、メッセージを安定したストレージに記録する必要がないため、オーバーヘッドが最も少ない配信モードです。static int
PERSISTENT
この配信モードは、クライアントの送信操作の一部としてメッセージを安定したストレージに記録するように Jakarta Messaging プロバイダーに指示します。
フィールドの詳細
NON_PERSISTENT
static final int NON_PERSISTENT
これは、メッセージを安定したストレージに記録する必要がないため、オーバーヘッドが最も少ない配信モードです。NON_PERSISTENT
メッセージが失われる原因となる Jakarta Messaging プロバイダー障害のレベルは定義されていません。Jakarta Messaging プロバイダーは、最大 1 回の保証で
NON_PERSISTENT
メッセージを配信する必要があります。これは、メッセージが失われる可能性があることを意味しますが、2 回配信してはなりません。- 関連事項:
- 定数フィールド値
PERSISTENT
static final int PERSISTENT
この配信モードは、クライアントの送信操作の一部としてメッセージを安定したストレージに記録するように Jakarta Messaging プロバイダーに指示します。ハードメディアに障害が発生した場合にのみ、PERSISTENT
メッセージが失われます。- 関連事項:
- 定数フィールド値