Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface MapMessage
A MapMessage
объект используется, чтобы отправить ряд пар значение-имя. Имена String
объекты, и значения являются примитивными типами данных в языке программирования Java. У имен должно быть значение, которое не является нулем, и не пустой строкой. К записям можно получить доступ последовательно или в произвольном порядке по имени. Порядок записей неопределен. MapMessage
наследовался от Message
взаимодействуйте через интерфейс и добавляет текст сообщения, который содержит Карту.
Типы примитивов могут быть считаны или записаны, явно используя методы для каждого типа. Они могут также быть считаны или записаны в общем как объекты. Например, звонок MapMessage.setInt("foo", 6)
эквивалентно MapMessage.setObject("foo", new Integer(6))
. Обе формы обеспечиваются, потому что явная форма удобна для статического программирования, и объектная форма необходима, когда типы не известны во время компиляции.
Когда клиент получает a MapMessage
, это находится в режиме только для чтения. Если клиент пытается записать в сообщение в этой точке, a MessageNotWriteableException
бросается. Если clearBody
вызывается, сообщение может теперь быть и считано из и записано.
MapMessage
объекты поддерживают следующую таблицу преобразования. Отмеченные случаи должны поддерживаться. Неотмеченные случаи должны бросить 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
.
Session.createMapMessage()
, BytesMessage
, Message
, ObjectMessage
, StreamMessage
, TextMessage
Полевая Сводка |
---|
Поля, наследованные от интерфейса javax.jms. Сообщение |
---|
DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE |
Сводка метода | |
---|---|
boolean |
getBoolean(java.lang.String name)
Возвраты boolean значение с указанным именем. |
byte |
getByte(java.lang.String name)
Возвраты byte значение с указанным именем. |
byte[] |
getBytes(java.lang.String name)
Возвращает значение байтового массива с указанным именем. |
char |
getChar(java.lang.String name)
Возвращает значение символа Unicode с указанным именем. |
double |
getDouble(java.lang.String name)
Возвраты double значение с указанным именем. |
float |
getFloat(java.lang.String name)
Возвраты float значение с указанным именем. |
int |
getInt(java.lang.String name)
Возвраты int значение с указанным именем. |
long |
getLong(java.lang.String name)
Возвраты long значение с указанным именем. |
java.util.Enumeration |
getMapNames()
Возвраты Enumeration из всех имен в MapMessage объект. |
java.lang.Object |
getObject(java.lang.String name)
Возвращает значение объекта с указанным именем. |
short |
getShort(java.lang.String name)
Возвраты short значение с указанным именем. |
java.lang.String |
getString(java.lang.String name)
Возвраты String значение с указанным именем. |
boolean |
itemExists(java.lang.String name)
Указывает, существует ли элемент в этом MapMessage объект. |
void |
setBoolean(java.lang.String name, boolean value)
Наборы a boolean значение с указанным именем в Карту. |
void |
setByte(java.lang.String name, byte value)
Наборы a byte значение с указанным именем в Карту. |
void |
setBytes(java.lang.String name, byte[] value)
Устанавливает значение байтового массива с указанным именем в Карту. |
void |
setBytes(java.lang.String name, byte[] value, int offset, int length)
Устанавливает часть значения байтового массива с указанным именем в Карту. |
void |
setChar(java.lang.String name, char value)
Устанавливает значение символа Unicode с указанным именем в Карту. |
void |
setDouble(java.lang.String name, double value)
Наборы a double значение с указанным именем в Карту. |
void |
setFloat(java.lang.String name, float value)
Наборы a float значение с указанным именем в Карту. |
void |
setInt(java.lang.String name, int value)
Наборы int значение с указанным именем в Карту. |
void |
setLong(java.lang.String name, long value)
Наборы a long значение с указанным именем в Карту. |
void |
setObject(java.lang.String name, java.lang.Object value)
Устанавливает объектное значение с указанным именем в Карту. |
void |
setShort(java.lang.String name, short value)
Наборы a short значение с указанным именем в Карту. |
void |
setString(java.lang.String name, java.lang.String value)
Наборы a String значение с указанным именем в Карту. |
Деталь метода |
---|
boolean getBoolean(java.lang.String name) throws JMSException
boolean
значение с указанным именем.
name
- имя boolean
boolean
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.byte getByte(java.lang.String name) throws JMSException
byte
значение с указанным именем.
name
- имя byte
byte
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.short getShort(java.lang.String name) throws JMSException
short
значение с указанным именем.
name
- имя short
short
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.char getChar(java.lang.String name) throws JMSException
name
- имя символа Unicode JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.int getInt(java.lang.String name) throws JMSException
int
значение с указанным именем.
name
- имя int
int
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.long getLong(java.lang.String name) throws JMSException
long
значение с указанным именем.
name
- имя long
long
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.float getFloat(java.lang.String name) throws JMSException
float
значение с указанным именем.
name
- имя float
float
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.double getDouble(java.lang.String name) throws JMSException
double
значение с указанным именем.
name
- имя double
double
значение с указанным именем JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.java.lang.String getString(java.lang.String name) throws JMSException
String
значение с указанным именем.
name
- имя String
String
значение с указанным именем; если нет никакого элемента этим именем, нулевое значение возвращается JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.byte[] getBytes(java.lang.String name) throws JMSException
name
- имя байтового массива JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки. MessageFormatException
- если это преобразование типов недопустимо.java.lang.Object getObject(java.lang.String name) throws JMSException
Этот метод может использоваться, чтобы возвратиться, в воплощенном формате, объекте в языке программирования Java ("объект Java"), который был сохранен в Карте с эквивалентом setObject
вызов метода, или его эквивалентный примитив settype
метод.
Отметьте, что значения байта возвращаются как byte[]
, нет Byte[]
.
name
- имя объекта Java int
, Integer
возвращается); если нет никакого элемента этим именем, нулевое значение возвращается JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки.java.util.Enumeration getMapNames() throws JMSException
Enumeration
из всех имен в MapMessage
объект.
MapMessage
JMSException
- если провайдер JMS не в состоянии считать сообщение из-за некоторой внутренней ошибки.void setBoolean(java.lang.String name, boolean value) throws JMSException
boolean
значение с указанным именем в Карту.
name
- имя boolean
value
- boolean
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setByte(java.lang.String name, byte value) throws JMSException
byte
значение с указанным именем в Карту.
name
- имя byte
value
- byte
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setShort(java.lang.String name, short value) throws JMSException
short
значение с указанным именем в Карту.
name
- имя short
value
- short
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setChar(java.lang.String name, char value) throws JMSException
name
- имя символа Unicodevalue
- значение символа Unicode, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setInt(java.lang.String name, int value) throws JMSException
int
значение с указанным именем в Карту.
name
- имя int
value
- int
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setLong(java.lang.String name, long value) throws JMSException
long
значение с указанным именем в Карту.
name
- имя long
value
- long
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setFloat(java.lang.String name, float value) throws JMSException
float
значение с указанным именем в Карту.
name
- имя float
value
- float
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setDouble(java.lang.String name, double value) throws JMSException
double
значение с указанным именем в Карту.
name
- имя double
value
- double
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setString(java.lang.String name, java.lang.String value) throws JMSException
String
значение с указанным именем в Карту.
name
- имя String
value
- String
значение, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setBytes(java.lang.String name, byte[] value) throws JMSException
name
- имя байтового массиваvalue
- значение байтового массива, чтобы установить в Карте; массив копируется так, чтобы значение для name
не будет изменен будущими модификациями JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. java.lang.NullPointerException
- если имя является нулем, или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setBytes(java.lang.String name, byte[] value, int offset, int length) throws JMSException
name
- имя байтового массиваvalue
- значение байтового массива, чтобы установить в Картеoffset
- начальное смещение в пределах байтового массиваlength
- число байтов, чтобы использовать JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.void setObject(java.lang.String name, java.lang.Object value) throws JMSException
Этот метод работает только на воплощенные примитивные объектные типы (Integer
, Double
, Long
...), String
объекты, и байтовые массивы.
name
- имя объекта Javavalue
- значение объекта Java, чтобы установить в Карте JMSException
- если провайдер JMS не в состоянии записать сообщение из-за некоторой внутренней ошибки. IllegalArgumentException
- если имя является нулем или если имя является пустой строкой. MessageFormatException
- если объект недопустим. MessageNotWriteableException
- если сообщение находится в режиме только для чтения.boolean itemExists(java.lang.String name) throws JMSException
MapMessage
объект.
name
- имя элемента, чтобы протестировать JMSException
- если провайдер JMS не в состоянии определить, существует ли элемент из-за некоторой внутренней ошибки.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41