Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
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 к потоковому сообщению. |
Деталь метода |
---|
boolean readBoolean() throws JMSException
boolean
из потокового сообщения.
boolean
значение читало JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.byte readByte() throws JMSException
byte
значение из потокового сообщения.
byte
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.short readShort() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.char readChar() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо MessageNotReadableException
- если сообщение находится в режиме только для записи.int readInt() throws JMSException
int
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.long readLong() throws JMSException
long
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.float readFloat() throws JMSException
float
из потокового сообщения.
float
значение из потокового сообщения JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.double readDouble() throws JMSException
double
из потокового сообщения.
double
значение из потокового сообщения JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.java.lang.String readString() throws JMSException
String
из потокового сообщения.
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readBytes(byte[] value) throws JMSException
byte[]
объект (буфер чтения). Считать значение поля, readBytes
должен быть последовательно вызван, пока это не возвращает значение меньше чем длина буфера чтения. Значение байтов в буфере после последнего побайтового чтения неопределено.
Если readBytes
возвращает значение, равное длине буфера, последующего readBytes
вызов должен быть выполнен. Если нет больше байтов, которое будет считано, этот вызов возвращается-1.
Если значение поля байтового массива является нулем, readBytes
возвраты-1.
Если значение поля байтового массива пусто, readBytes
возвраты 0.
Однажды первое readBytes
запрос a byte[]
значение поля было сделано, полная стоимость поля должна быть считана прежде, чем это будет допустимо, чтобы считать следующее поле. Попытка считать следующее поле прежде, чем это было сделано, бросит a MessageFormatException
.
Считать значение поля байта в новое byte[]
объект, используйте readObject
метод.
value
- буфер, в который читаются данные JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.readObject()
java.lang.Object readObject() throws JMSException
Этот метод может использоваться, чтобы возвратиться, в воплощенном формате, объекте в языке программирования Java ("объект Java"), который был записан потоку с эквивалентом writeObject
вызов метода, или его эквивалентный примитив writetype
метод.
Отметьте, что значения байта возвращаются как byte[]
, нет Byte[]
.
Попытка вызвать readObject
считать значение поля байта в новое byte[]
объект перед полной стоимостью поля байта был считан, бросит a MessageFormatException
.
int
, Integer
возвращается), JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока сообщения был достигнут. MessageFormatException
- если это преобразование типов недопустимо. MessageNotReadableException
- если сообщение находится в режиме только для записи.readBytes(byte[] value)
void writeBoolean(boolean value) throws JMSException
boolean
к потоковому сообщению. Значение true
пишется как значение (byte)1
; значение false
пишется как значение (byte)0
.
value
- boolean
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeByte(byte value) throws JMSException
byte
к потоковому сообщению.
value
- byte
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeShort(short value) throws JMSException
short
к потоковому сообщению.
value
- short
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeChar(char value) throws JMSException
char
к потоковому сообщению.
value
- char
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeInt(int value) throws JMSException
int
к потоковому сообщению.
value
- int
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeLong(long value) throws JMSException
long
к потоковому сообщению.
value
- long
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeFloat(float value) throws JMSException
float
к потоковому сообщению.
value
- float
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeDouble(double value) throws JMSException
double
к потоковому сообщению.
value
- double
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeString(java.lang.String value) throws JMSException
String
к потоковому сообщению.
value
- String
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeBytes(byte[] value) throws JMSException
Байтовый массив value
пишется сообщению как поле байтового массива. Последовательно записанные поля байтового массива обрабатываются как два отличных поля, когда поля читаются.
value
- значение байтового массива, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeBytes(byte[] value, int offset, int length) throws JMSException
Часть байтового массива value
пишется сообщению как поле байтового массива. Последовательно записанные поля байтового массива обрабатываются как два отличных поля, когда поля читаются.
value
- значение байтового массива, которое будет записаноoffset
- начальное смещение в пределах байтового массиваlength
- число байтов, чтобы использовать JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.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
- если у сообщения есть недопустимый формат.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41