Spec-Zone .ru спецификации, руководства, описания, API

javax.jms
Интерфейс ObjectMessage

Все Суперинтерфейсы:

Сообщение

public interface ObjectMessage
расширяет сообщение

ObjectMessage объект используется, чтобы отправить сообщение, которое содержит сериализуемый объект в языке программирования Java ("объект Java"). Это наследовалось от Message взаимодействуйте через интерфейс и добавляет тело, содержащее единственную ссылку на объект. Только Serializable Объекты Java могут использоваться.

Если набор объектов Java должен быть отправлен, один из Collection могут использоваться классы, обеспеченные начиная с JDK 1.2.

Когда клиент получает ObjectMessage, это находится в режиме только для чтения. Если клиент пытается записать в сообщение в этой точке, a MessageNotWriteableException бросается. Если clearBody вызывается, сообщение может теперь быть и считано из и записано.

См. Также:

Session.createObjectMessage(), Session.createObjectMessage(Serializable), BytesMessage, MapMessage, Message, StreamMessage, TextMessage

Полевая Сводка

Поля, наследованные от интерфейса javax.jms. Сообщение

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

Сводка метода

java.io.Serializable	getObject() Получает сериализуемый объект, содержащий данные этого сообщения.
void	setObject(java.io.Serializable object) Устанавливает сериализуемый объект, содержащий данные этого сообщения.

Методы, наследованные от интерфейса javax.jms. Сообщение

acknowledge, clearBody, clearProperties, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

Деталь метода

setObject

void setObject(java.io.Serializable object)
               throws JMSException

Устанавливает сериализуемый объект, содержащий данные этого сообщения. Важно отметить что ObjectMessage содержит снимок объекта в это время setObject() вызывается; последующие модификации объекта не будут иметь никакого эффекта на ObjectMessage тело.

Параметры:

object - данные сообщения

Броски:

JMSException - если провайдер JMS не в состоянии установить объект из-за некоторой внутренней ошибки.

MessageFormatException - если объектная сериализация перестала работать.

MessageNotWriteableException - если сообщение находится в режиме только для чтения.

getObject

java.io.Serializable getObject()
                               throws JMSException

Получает сериализуемый объект, содержащий данные этого сообщения. Значение по умолчанию является нулем.

Возвраты:

сериализуемый объект, содержащий данные этого сообщения

Броски:

JMSException - если провайдер JMS не в состоянии получить объект из-за некоторой внутренней ошибки.

MessageFormatException - если объектная десериализация перестала работать.