パッケージ jakarta.jms

インターフェース ObjectMessage

すべてのスーパーインターフェース:
Message
public interface ObjectMessage extends Message
ObjectMessage オブジェクトは、Java プログラミング言語の直列化可能なオブジェクト（「Java オブジェクト」）を含むメッセージを送信するために使用されます。Message インターフェースを継承し、オブジェクトへの単一の参照を含む本体を追加します。Serializable Java オブジェクトのみ使用できます。

Java オブジェクトのコレクションを送信する必要がある場合は、JDK 1.2 を使用できるため、提供されている Collection クラスの 1 つ。

クライアントが ObjectMessage を受信すると、読み取り専用モードになります。この時点でクライアントがメッセージに書き込もうとすると、MessageNotWriteableException がスローされます。clearBody が呼び出されると、メッセージの読み取りと書き込みの両方が可能になります。

導入:
JMS 1.0
バージョン:
Jakarta Messaging 2.0
関連事項:

  • メソッドの詳細

    • setObject

      void setObject(SerializableSE object) throws JMSException
      このメッセージのデータを含む直列化可能なオブジェクトを設定します。setObject() が呼び出されたときの ObjectMessage にはオブジェクトのスナップショットが含まれていることに注意することが重要です。その後のオブジェクトの変更は、ObjectMessage 本体には影響しません。
      パラメーター:
      object - メッセージのデータ
      例外:
      JMSException - 内部エラーのために Jakarta Messaging プロバイダーがオブジェクトの設定に失敗した場合。
      MessageFormatException - オブジェクトの直列化が失敗した場合。
      MessageNotWriteableException - メッセージが読み取り専用モードの場合。

    • getObject

      SerializableSE getObject() throws JMSException
      このメッセージのデータを含む直列化可能なオブジェクトを取得します。デフォルト値は null です。
      戻り値:
      このメッセージのデータを含む直列化可能なオブジェクト
      例外:
      JMSException - 内部エラーが原因で Jakarta Messaging プロバイダーがオブジェクトの取得に失敗した場合。
      MessageFormatException - オブジェクトの逆直列化が失敗した場合。