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

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

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

Сообщение

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

A StreamMessage объект используется, чтобы отправить поток типов примитивов в языке программирования Java. Это заполнено, и читайте последовательно. Это наследовалось от Message взаимодействуйте через интерфейс и добавляет потоковый текст сообщения. Его методы базируются в значительной степени на найденных в java.io.DataInputStream и java.io.DataOutputStream.

Типы примитивов могут быть считаны или записаны, явно используя методы для каждого типа. Они могут также быть считаны или записаны в общем как объекты. Например, звонок StreamMessage.writeInt(6) эквивалентно StreamMessage.writeObject(new Integer(6)). Обе формы обеспечиваются, потому что явная форма удобна для статического программирования, и объектная форма необходима, когда типы не известны во время компиляции.

Когда сообщение сначала создается, и когда clearBody вызывается, тело сообщения находится в режиме только для записи. После первого звонка reset был сделан, текст сообщения находится в режиме только для чтения. После того, как сообщение было отправлено, клиент, который передался, оно может сохранить и изменить это, не влияя на сообщение, которое было отправлено. Тот же самый объект сообщения может быть отправлен многократно. Когда сообщение было получено, провайдер вызвал reset так, чтобы текст сообщения был в режиме только для чтения для клиента.

Если clearBody вызывается на сообщении в режиме только для чтения, текст сообщения очищается, и текст сообщения находится в режиме только для записи.

Если клиент пытается считать сообщение в режиме только для записи, a MessageNotReadableException бросается.

Если клиент пытается записать сообщение в режиме только для чтения, a MessageNotWriteableException бросается.

StreamMessage объекты поддерживают следующую таблицу преобразования. Отмеченные случаи должны поддерживаться. Неотмеченные случаи должны бросить a JMSException. String- к-примитивному преобразования могут бросить исключение на этапе выполнения если примитив valueOf() метод не принимает это как допустимое String представление примитива.

Значение, записанное как тип строки, может быть считано как тип столбца.

 |        | boolean byte short char int long float double String byte[]
 |----------------------------------------------------------------------
 |boolean |    X                                            X
 |byte    |          X     X         X   X                  X   
 |short   |                X         X   X                  X   
 |char    |                     X                           X
 |int     |                          X   X                  X   
 |long    |                              X                  X   
 |float   |                                    X     X      X   
 |double  |                                          X      X   
 |String  |    X     X     X         X   X     X     X      X   
 |byte[]  |                                                        X
 |----------------------------------------------------------------------
 

Пытаясь считать нулевое значение, поскольку тип примитива должен быть обработан как вызов соответствия примитива valueOf(String) метод преобразования с нулевым значением. С тех пор char не поддерживает a String преобразование, пытаясь считать нулевое значение как a char должен бросить a NullPointerException.

См. Также:

BytesMessage, MapMessage, Message, ObjectMessage, TextMessage

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

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

DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE

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

boolean	readBoolean() Чтения a boolean из потокового сообщения.
byte	readByte() Чтения a byte значение из потокового сообщения.
int	readBytes(byte[] value) Читает поле байтового массива из потокового сообщения в указанное byte[] объект (буфер чтения).
char	readChar() Читает значение символа Unicode из потокового сообщения.
double	readDouble() Чтения a double из потокового сообщения.
float	readFloat() Чтения a float из потокового сообщения.
int	readInt() Читает 32-разрядное целое число из потокового сообщения.
long	readLong() Читает 64-разрядное целое число из потокового сообщения.
java.lang.Object	readObject() Читает объект из потокового сообщения.
short	readShort() Читает 16-разрядное целое число из потокового сообщения.
java.lang.String	readString() Чтения a String из потокового сообщения.
void	reset() Помещает текст сообщения в режим только для чтения и репозиции поток к началу.
void	writeBoolean(boolean value) Записи a boolean к потоковому сообщению.
void	writeByte(byte value) Записи a byte к потоковому сообщению.
void	writeBytes(byte[] value) Пишет поле байтового массива в потоковое сообщение.
void	writeBytes(byte[] value, int offset, int length) Пишет часть байтового массива как поле байтового массива к потоковому сообщению.
void	writeChar(char value) Записи a char к потоковому сообщению.
void	writeDouble(double value) Записи a double к потоковому сообщению.
void	writeFloat(float value) Записи a float к потоковому сообщению.
void	writeInt(int value) Записи int к потоковому сообщению.
void	writeLong(long value) Записи a long к потоковому сообщению.
void	writeObject(java.lang.Object value) Пишет объект в потоковое сообщение.
void	writeShort(short value) Записи a short к потоковому сообщению.
void	writeString(java.lang.String value) Записи a String к потоковому сообщению.

Методы, наследованные от интерфейса 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

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

readBoolean

boolean readBoolean()
                    throws JMSException

Чтения a boolean из потокового сообщения.

Возвраты:

boolean значение читало

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readByte

byte readByte()
              throws JMSException

Чтения a byte значение из потокового сообщения.

Возвраты:

следующий байт от потока обменивается сообщениями как 8-разрядное byte

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readShort

short readShort()
                throws JMSException

Читает 16-разрядное целое число из потокового сообщения.

Возвраты:

16-разрядное целое число из потокового сообщения

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readChar

char readChar()
              throws JMSException

Читает значение символа Unicode из потокового сообщения.

Возвраты:

символ Unicode из потокового сообщения

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо

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

readInt

int readInt()
            throws JMSException

Читает 32-разрядное целое число из потокового сообщения.

Возвраты:

32-разрядное целочисленное значение из потокового сообщения, интерпретируемого как int

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readLong

long readLong()
              throws JMSException

Читает 64-разрядное целое число из потокового сообщения.

Возвраты:

64-разрядное целочисленное значение из потокового сообщения, интерпретируемого как a long

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readFloat

float readFloat()
                throws JMSException

Чтения a float из потокового сообщения.

Возвраты:

a float значение из потокового сообщения

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readDouble

double readDouble()
                  throws JMSException

Чтения a double из потокового сообщения.

Возвраты:

a double значение из потокового сообщения

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readString

java.lang.String readString()
                            throws JMSException

Чтения a String из потокового сообщения.

Возвраты:

Unicode представляет в виде строки из потокового сообщения

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

readBytes

int readBytes(byte[] value)
              throws JMSException

Читает поле байтового массива из потокового сообщения в указанное byte[] объект (буфер чтения).

Считать значение поля, readBytes должен быть последовательно вызван, пока это не возвращает значение меньше чем длина буфера чтения. Значение байтов в буфере после последнего побайтового чтения неопределено.

Если readBytes возвращает значение, равное длине буфера, последующего readBytes вызов должен быть выполнен. Если нет больше байтов, которое будет считано, этот вызов возвращается-1.

Если значение поля байтового массива является нулем, readBytes возвраты-1.

Если значение поля байтового массива пусто, readBytes возвраты 0.

Однажды первое readBytes запрос a byte[] значение поля было сделано, полная стоимость поля должна быть считана прежде, чем это будет допустимо, чтобы считать следующее поле. Попытка считать следующее поле прежде, чем это было сделано, бросит a MessageFormatException.

Считать значение поля байта в новое byte[] объект, используйте readObject метод.

Параметры:

value - буфер, в который читаются данные

Возвраты:

общее количество чтения байтов в буфер, или-1, если нет больше данных, потому что конец поля байта был достигнут

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

См. Также:

readObject()

readObject

java.lang.Object readObject()
                            throws JMSException

Читает объект из потокового сообщения.

Этот метод может использоваться, чтобы возвратиться, в воплощенном формате, объекте в языке программирования Java ("объект Java"), который был записан потоку с эквивалентом writeObject вызов метода, или его эквивалентный примитив writetype метод.

Отметьте, что значения байта возвращаются как byte[], нет Byte[].

Попытка вызвать readObject считать значение поля байта в новое byte[] объект перед полной стоимостью поля байта был считан, бросит a MessageFormatException.

Возвраты:

объект Java из потокового сообщения, в воплощенном формате (например, если объект был записан как int, Integer возвращается),

Броски:

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

MessageEOFException - если неожиданный конец потока сообщения был достигнут.

MessageFormatException - если это преобразование типов недопустимо.

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

См. Также:

readBytes(byte[] value)

writeBoolean

void writeBoolean(boolean value)
                  throws JMSException

Записи a boolean к потоковому сообщению. Значение true пишется как значение (byte)1; значение false пишется как значение (byte)0.

Параметры:

value - boolean значение, которое будет записано

Броски:

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

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

writeByte

void writeByte(byte value)
               throws JMSException

Записи a byte к потоковому сообщению.

Параметры:

value - byte значение, которое будет записано

Броски:

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

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

writeShort

void writeShort(short value)
                throws JMSException

Записи a short к потоковому сообщению.

Параметры:

value - short значение, которое будет записано

Броски:

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

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

writeChar

void writeChar(char value)
               throws JMSException

Записи a char к потоковому сообщению.

Параметры:

value - char значение, которое будет записано

Броски:

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

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

writeInt

void writeInt(int value)
              throws JMSException

Записи int к потоковому сообщению.

Параметры:

value - int значение, которое будет записано

Броски:

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

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

writeLong

void writeLong(long value)
               throws JMSException

Записи a long к потоковому сообщению.

Параметры:

value - long значение, которое будет записано

Броски:

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

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

writeFloat

void writeFloat(float value)
                throws JMSException

Записи a float к потоковому сообщению.

Параметры:

value - float значение, которое будет записано

Броски:

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

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

writeDouble

void writeDouble(double value)
                 throws JMSException

Записи a double к потоковому сообщению.

Параметры:

value - double значение, которое будет записано

Броски:

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

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

writeString

void writeString(java.lang.String value)
                 throws JMSException

Записи a String к потоковому сообщению.

Параметры:

value - String значение, которое будет записано

Броски:

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

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

writeBytes

void writeBytes(byte[] value)
                throws JMSException

Пишет поле байтового массива в потоковое сообщение.

Байтовый массив value пишется сообщению как поле байтового массива. Последовательно записанные поля байтового массива обрабатываются как два отличных поля, когда поля читаются.

Параметры:

value - значение байтового массива, которое будет записано

Броски:

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

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

writeBytes

void writeBytes(byte[] value,
                int offset,
                int length)
                throws JMSException

Пишет часть байтового массива как поле байтового массива к потоковому сообщению.

Часть байтового массива value пишется сообщению как поле байтового массива. Последовательно записанные поля байтового массива обрабатываются как два отличных поля, когда поля читаются.

Параметры:

value - значение байтового массива, которое будет записано

offset - начальное смещение в пределах байтового массива

length - число байтов, чтобы использовать

Броски:

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

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

writeObject

void writeObject(java.lang.Object value)
                 throws JMSException

Пишет объект в потоковое сообщение.

Этот метод работает только на воплощенные примитивные объектные типы (Integer, Double, Long ...), String объекты, и байтовые массивы.

Параметры:

value - объект Java, который будет записан

Броски:

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

MessageFormatException - если объект недопустим.

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

сброс

void reset()
           throws JMSException

Помещает текст сообщения в режим только для чтения и репозиции поток к началу.

Броски:

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

MessageFormatException - если у сообщения есть недопустимый формат.