Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface BytesMessage
A BytesMessage
объект используется, чтобы отправить сообщение, содержащее поток неинтерпретируемых байтов. Это наследовалось от Message
взаимодействуйте через интерфейс и добавляет текст сообщения байтов. Получатель сообщения предоставляет интерпретацию байтов.
BytesMessage
методы базируются в значительной степени на найденных в java.io.DataInputStream
и java.io.DataOutputStream
.
Этот тип сообщения для клиентского кодирования существующих форматов сообщения. Если возможный, один из других типов сообщения самоопределения должен использоваться вместо этого.
Хотя API JMS позволяет использование свойств сообщения с сообщениями байта, они обычно не используются, так как включение свойств может влиять на формат.
Типы примитивов могут быть записаны, явно используя методы для каждого типа. Они могут также быть записаны в общем как объекты. Например, звонок BytesMessage.writeInt(6)
эквивалентно BytesMessage.writeObject(new Integer(6))
. Обе формы обеспечиваются, потому что явная форма удобна для статического программирования, и объектная форма необходима, когда типы не известны во время компиляции.
Когда сообщение сначала создается, и когда clearBody
вызывается, тело сообщения находится в режиме только для записи. После первого звонка reset
был сделан, текст сообщения находится в режиме только для чтения. После того, как сообщение было отправлено, клиент, который передался, оно может сохранить и изменить это, не влияя на сообщение, которое было отправлено. Тот же самый объект сообщения может быть отправлен многократно. Когда сообщение было получено, провайдер вызвал reset
так, чтобы текст сообщения был в режиме только для чтения для клиента.
Если clearBody
вызывается на сообщении в режиме только для чтения, текст сообщения очищается, и сообщение находится в режиме только для записи.
Если клиент пытается считать сообщение в режиме только для записи, a MessageNotReadableException
бросается.
Если клиент пытается записать сообщение в режиме только для чтения, a MessageNotWriteableException
бросается.
Session.createBytesMessage()
, MapMessage
, Message
, ObjectMessage
, StreamMessage
, TextMessage
Полевая Сводка |
---|
Поля, наследованные от интерфейса javax.jms. Сообщение |
---|
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Сводка метода | |
---|---|
long |
getBodyLength()
Получает число байтов текста сообщения, когда сообщение находится в режиме только для чтения. |
boolean |
readBoolean()
Чтения a boolean от байтов передают поток. |
byte |
readByte()
Читает подписанное 8-разрядное значение от байтов передают поток. |
int |
readBytes(byte[] value)
Читает байтовый массив от байтов передают поток. |
int |
readBytes(byte[] value, int length)
Читает часть байтов передают поток. |
char |
readChar()
Читает значение символа Unicode от байтов передают поток. |
double |
readDouble()
Чтения a double от байтов передают поток. |
float |
readFloat()
Чтения a float от байтов передают поток. |
int |
readInt()
Читает подписанное 32-разрядное целое число от байтов передают поток. |
long |
readLong()
Читает подписанное 64-разрядное целое число от байтов передают поток. |
short |
readShort()
Читает подписанное 16-разрядное число от байтов передают поток. |
int |
readUnsignedByte()
Читает 8-разрядное число без знака от байтов передают поток. |
int |
readUnsignedShort()
Читает 16-разрядное число без знака от байтов передают поток. |
java.lang.String |
readUTF()
Читает строку, которая была закодирована, используя измененный формат UTF-8 от потока сообщения байтов. |
void |
reset()
Помещает текст сообщения в режим только для чтения и репозиции поток байтов к началу. |
void |
writeBoolean(boolean value)
Записи a boolean к байтам передают поток как 1-байтовое значение. |
void |
writeByte(byte value)
Записи a byte к байтам передают поток как 1-байтовое значение. |
void |
writeBytes(byte[] value)
Пишет, что байтовый массив к байтам передает поток. |
void |
writeBytes(byte[] value, int offset, int length)
Пишет, что часть байтового массива к байтам передает поток. |
void |
writeChar(char value)
Записи a char к байтам передают поток как 2-байтовое значение, высокий байт сначала. |
void |
writeDouble(double value)
Преобразовывает double параметр a long использование doubleToLongBits метод в class Double , и затем записи это long оцените потоку сообщения байтов как 8-байтовое количество, высокий байт сначала. |
void |
writeFloat(float value)
Преобразовывает float параметр int использование floatToIntBits метод в class Float , и затем записи это int оцените потоку сообщения байтов как 4-байтовое количество, высокий байт сначала. |
void |
writeInt(int value)
Записи int к байтам передают поток как четыре байта, высокий байт сначала. |
void |
writeLong(long value)
Записи a long к байтам передают поток как восемь байтов, высокий байт сначала. |
void |
writeObject(java.lang.Object value)
Пишет, что объект к байтам передает поток. |
void |
writeShort(short value)
Записи a short к байтам передают поток как два байта, высокий байт сначала. |
void |
writeUTF(java.lang.String value)
Пишет, что строка к байтам передает поток, используя UTF-8, кодирующий машинно-независимым способом. |
Деталь метода |
---|
long getBodyLength() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageNotReadableException
- если сообщение находится в режиме только для записи.boolean readBoolean() throws JMSException
boolean
от байтов передают поток.
boolean
значение читало JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.byte readByte() throws JMSException
byte
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readUnsignedByte() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.short readShort() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readUnsignedShort() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.char readChar() throws JMSException
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readInt() throws JMSException
int
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.long readLong() throws JMSException
long
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.float readFloat() throws JMSException
float
от байтов передают поток.
float
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.double readDouble() throws JMSException
double
от байтов передают поток.
double
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.java.lang.String readUTF() throws JMSException
Для получения дополнительной информации по формату UTF-8 см. "Файловую систему Безопасный Формат Преобразования UCS (FSS_UTF)", Предварительная Спецификация X/Open, X/Open Company Ltd., Номер документа: P316. Эта информация также появляется в ISO/IEC 10646, Приложении P.
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageEOFException
- если неожиданный конец потока байтов был достигнут. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readBytes(byte[] value) throws JMSException
Если длина массива value
меньше чем число байтов, остающихся быть считанными из потока, массив должен быть переполнен. Последующий вызов читает следующий инкремент и так далее.
Если число байтов, остающихся в потоке, является меньше чем длина массива value
, байты должны быть считаны в массив. Возвращаемое значение общего количества чтения байтов будет меньше чем длина массива, указывая, что нет больше байтов, оставленных быть считанным из потока. Следующее чтение потока возвращается-1.
value
- буфер, в который читаются данные JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageNotReadableException
- если сообщение находится в режиме только для записи.int readBytes(byte[] value, int length) throws JMSException
Если длина массива value
меньше чем число байтов, остающихся быть считанными из потока, массив должен быть переполнен. Последующий вызов читает следующий инкремент и так далее.
Если число байтов, остающихся в потоке, является меньше чем длина массива value
, байты должны быть считаны в массив. Возвращаемое значение общего количества чтения байтов будет меньше чем длина массива, указывая, что нет больше байтов, оставленных быть считанным из потока. Следующее чтение потока возвращается-1.
Если length
отрицательно, или length
больше чем длина массива value
, тогда IndexOutOfBoundsException
бросается. Никакие байты не будут считаны из потока для этого случая исключения.
value
- буфер, в который читаются данныеlength
- число байтов, чтобы читать; должно быть меньше чем или равным value.length
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageNotReadableException
- если сообщение находится в режиме только для записи.void writeBoolean(boolean value) throws JMSException
boolean
к байтам передают поток как 1-байтовое значение. Значение true
пишется как значение (byte)1
; значение false
пишется как значение (byte)0
.
value
- boolean
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeByte(byte value) throws JMSException
byte
к байтам передают поток как 1-байтовое значение.
value
- byte
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeShort(short value) throws JMSException
short
к байтам передают поток как два байта, высокий байт сначала.
value
- short
быть записанным JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeChar(char value) throws JMSException
char
к байтам передают поток как 2-байтовое значение, высокий байт сначала.
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
параметр int
использование floatToIntBits
метод в class Float
, и затем записи это int
оцените потоку сообщения байтов как 4-байтовое количество, высокий байт сначала.
value
- float
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeDouble(double value) throws JMSException
double
параметр a long
использование doubleToLongBits
метод в class Double
, и затем записи это long
оцените потоку сообщения байтов как 8-байтовое количество, высокий байт сначала.
value
- double
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeUTF(java.lang.String value) throws JMSException
Для получения дополнительной информации по формату UTF-8 см. "Файловую систему Безопасный Формат Преобразования UCS (FSS_UTF)", Предварительная Спецификация X/Open, X/Open Company Ltd., Номер документа: P316. Эта информация также появляется в ISO/IEC 10646, Приложении P.
value
- String
значение, которое будет записано JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeBytes(byte[] value) throws JMSException
value
- байтовый массив, который будет записан JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeBytes(byte[] value, int offset, int length) throws JMSException
value
- значение байтового массива, которое будет записаноoffset
- начальное смещение в пределах байтового массиваlength
- число байтов, чтобы использовать JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void writeObject(java.lang.Object value) throws JMSException
Этот метод работает только на воплощенные примитивные объектные типы (Integer
, Double
, Long
...), String
объекты, и байтовые массивы.
value
- объект в языке программирования Java ("Java возражают") быть записанным; это не должен быть нуль JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если объект имеет недопустимый тип. MessageNotWriteableException
- если сообщение находится в режиме только для чтения. java.lang.NullPointerException
- если параметр value
нуль.void reset() throws JMSException
JMSException
- если провайдер JMS не в состоянии сбросить сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если у сообщения есть недопустимый формат.
|
|||||||||
ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41