public interface ObjectMessage extends Message
ObjectMessage
オブジェクトは、Java プログラミング言語の直列化可能なオブジェクト(「Java オブジェクト」)を含むメッセージを送信するために使用されます。Message
インターフェースを継承し、オブジェクトへの単一の参照を含む本体を追加します。Serializable
Java オブジェクトのみ使用できます。Java オブジェクトのコレクションを送信する必要がある場合は、JDK 1.2 を使用できるため、提供されている Collection
クラスの 1 つ。
クライアントが ObjectMessage
を受信すると、読み取り専用モードになります。この時点でクライアントがメッセージに書き込もうとすると、MessageNotWriteableException
がスローされます。clearBody
が呼び出されると、メッセージの読み取りと書き込みの両方が可能になります。
Session.createObjectMessage()
, Session.createObjectMessage(Serializable)
, BytesMessage
, MapMessage
, Message
, StreamMessage
, TextMessage
DEFAULT_DELIVERY_DELAY, DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE
修飾子と型 | メソッドと説明 |
---|---|
SerializableSE | getObject() このメッセージのデータを含む直列化可能なオブジェクトを取得します。 |
void | setObject(SerializableSE object) このメッセージのデータを含む直列化可能なオブジェクトを設定します。 |
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
void setObject(SerializableSE object) throws JMSException
setObject()
が呼び出されたときの ObjectMessage
にはオブジェクトのスナップショットが含まれていることに注意することが重要です。その後のオブジェクトの変更は、ObjectMessage
本体には影響しません。object
- メッセージのデータ JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがオブジェクトの設定に失敗した場合。MessageFormatException
- オブジェクトの直列化が失敗した場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。SerializableSE getObject() throws JMSException
JMSException
- 内部エラーが原因で Jakarta Messaging プロバイダーがオブジェクトの取得に失敗した場合。MessageFormatException
- オブジェクトの逆直列化が失敗した場合。Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.