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 - если у сообщения есть недопустимый формат.


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter