ObjectMessage (Jakarta EE Platform API) - Javadoc

すべてのスーパーインターフェース:
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
関連事項:
Session.createObjectMessage(), Session.createObjectMessage(Serializable), BytesMessage, MapMessage, Message, StreamMessage, TextMessage

フィールドのサマリー
- インターフェース jakarta.jms.Message から継承されたフィールド
  DEFAULT_DELIVERY_DELAY, DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッド
修飾子と型	メソッド	説明
`SerializableSE`	`getObject()`	このメッセージのデータを含む直列化可能なオブジェクトを取得します。
`void`	`setObject(SerializableSE object)`	このメッセージのデータを含む直列化可能なオブジェクトを設定します。

インターフェース jakarta.jms.Message から継承されたメソッド
acknowledge, clearBody, clearProperties, getBody, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDeliveryTime, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, isBodyAssignableTo, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDeliveryTime, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

- メソッドの詳細
  - 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 - オブジェクトの逆直列化が失敗した場合。