public interface MapMessage extends Message
MapMessage
オブジェクトは、名前と値のペアのセットを送信するために使用されます。名前は String
オブジェクトであり、値は Java プログラミング言語のプリミティブデータ型です。名前には、null ではなく、空の文字列ではない値を含める必要があります。エントリには、名前で順次またはランダムにアクセスできます。エントリの順序は定義されていません。MapMessage
は Message
インターフェースを継承し、マップを含むメッセージ本文を追加します。 プリミティブ型は、各型のメソッドを使用して明示的に読み書きできます。また、オブジェクトとして一般的に読み書きすることもできます。たとえば、MapMessage.setInt("foo", 6)
の呼び出しは MapMessage.setObject("foo", new Integer(6))
と同等です。明示的なフォームは静的プログラミングに便利であり、コンパイル時に型が不明な場合はオブジェクトフォームが必要であるため、両方のフォームが提供されます。
クライアントが MapMessage
を受信すると、読み取り専用モードになります。この時点でクライアントがメッセージに書き込もうとすると、MessageNotWriteableException
がスローされます。clearBody
が呼び出されると、メッセージの読み取りと書き込みの両方が可能になります。
MapMessage
オブジェクトは、次の変換テーブルをサポートしています。マークされたケースはサポートされている必要があります。マークされていないケースは JMSException
をスローする必要があります。プリミティブの valueOf()
メソッドがプリミティブの有効な String
表現として受け入れない場合、String
-to-primitive 変換はランタイム例外をスローする可能性があります。
行型として書き込まれた値は、列型として読み取ることができます。
| | 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 |----------------------------------------------------------------------
null 値をプリミティブ型として読み取ろうとすると、null 値を指定して、プリミティブの対応する valueOf(String)
変換メソッドを呼び出すことになります。char
は String
変換をサポートしていないため、char
として null 値を読み取ろうとすると、NullPointerException
がスローされます。
Session.createMapMessage()
, BytesMessage
, Message
, ObjectMessage
, StreamMessage
, TextMessage
DEFAULT_DELIVERY_DELAY, DEFAULT_DELIVERY_MODE, DEFAULT_PRIORITY, DEFAULT_TIME_TO_LIVE
修飾子と型 | メソッドと説明 |
---|---|
boolean | getBoolean(StringSE name) 指定された名前の boolean 値を返します。 |
byte | getByte(StringSE name) 指定された名前の byte 値を返します。 |
byte[] | getBytes(StringSE name) 指定された名前のバイト配列値を返します。 |
char | getChar(StringSE name) 指定された名前の Unicode 文字値を返します。 |
double | getDouble(StringSE name) 指定された名前の double 値を返します。 |
float | getFloat(StringSE name) 指定された名前の float 値を返します。 |
int | getInt(StringSE name) 指定された名前の int 値を返します。 |
long | getLong(StringSE name) 指定された名前の long 値を返します。 |
EnumerationSE | getMapNames() MapMessage オブジェクト内のすべての名前の Enumeration を返します。 |
ObjectSE | getObject(StringSE name) 指定された名前のオブジェクトの値を返します。 |
short | getShort(StringSE name) 指定された名前の short 値を返します。 |
StringSE | getString(StringSE name) 指定された名前の String 値を返します。 |
boolean | itemExists(StringSE name) この MapMessage オブジェクトにアイテムが存在するかどうかを示します。 |
void | setBoolean(StringSE name, boolean value) 指定された名前の boolean 値をマップに設定します。 |
void | setByte(StringSE name, byte value) 指定された名前の byte 値をマップに設定します。 |
void | setBytes(StringSE name, byte[] value) 指定された名前のバイト配列値をマップに設定します。 |
void | setBytes(StringSE name, byte[] value, int offset, int length) 指定された名前のバイト配列値の一部をマップに設定します。 |
void | setChar(StringSE name, char value) 指定された名前の Unicode 文字値をマップに設定します。 |
void | setDouble(StringSE name, double value) 指定された名前の double 値をマップに設定します。 |
void | setFloat(StringSE name, float value) 指定された名前の float 値をマップに設定します。 |
void | setInt(StringSE name, int value) 指定された名前の int 値をマップに設定します。 |
void | setLong(StringSE name, long value) 指定された名前の long 値をマップに設定します。 |
void | setObject(StringSE name, ObjectSE value) 指定された名前のオブジェクト値をマップに設定します。 |
void | setShort(StringSE name, short value) 指定された名前の short 値をマップに設定します。 |
void | setString(StringSE name, StringSE value) 指定された名前の String 値をマップに設定します。 |
acknowledge, clearBody, clearProperties, getBody, getBooleanProperty, getByteProperty, getDoubleProperty, getFloatProperty, getIntProperty, getJMSCorrelationID, getJMSCorrelationIDAsBytes, getJMSDeliveryMode, getJMSDeliveryTime, getJMSDestination, getJMSExpiration, getJMSMessageID, getJMSPriority, getJMSRedelivered, getJMSReplyTo, getJMSTimestamp, getJMSType, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, isBodyAssignableTo, propertyExists, setBooleanProperty, setByteProperty, setDoubleProperty, setFloatProperty, setIntProperty, setJMSCorrelationID, setJMSCorrelationIDAsBytes, setJMSDeliveryMode, setJMSDeliveryTime, setJMSDestination, setJMSExpiration, setJMSMessageID, setJMSPriority, setJMSRedelivered, setJMSReplyTo, setJMSTimestamp, setJMSType, setLongProperty, setObjectProperty, setShortProperty, setStringProperty
boolean getBoolean(StringSE name) throws JMSException
boolean
値を返します。name
- boolean
の名前 boolean
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。byte getByte(StringSE name) throws JMSException
byte
値を返します。name
- byte
の名前 byte
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。short getShort(StringSE name) throws JMSException
short
値を返します。name
- short
の名前 short
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。char getChar(StringSE name) throws JMSException
name
- Unicode 文字の名前 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。int getInt(StringSE name) throws JMSException
int
値を返します。name
- int
の名前 int
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。long getLong(StringSE name) throws JMSException
long
値を返します。name
- long
の名前 long
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。float getFloat(StringSE name) throws JMSException
float
値を返します。name
- float
の名前 float
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。double getDouble(StringSE name) throws JMSException
double
値を返します。name
- double
の名前 double
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。StringSE getString(StringSE name) throws JMSException
String
値を返します。name
- String
の名前 String
値。この名前のアイテムがない場合は、null 値が返されます JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。byte[] getBytes(StringSE name) throws JMSException
name
- バイト配列の名前 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。MessageFormatException
- この型変換が無効な場合。ObjectSE getObject(StringSE name) throws JMSException
このメソッドを使用して、同等の setObject
メソッド呼び出しまたは同等のプリミティブ settype
メソッドで Map に格納されていた Java プログラミング言語のオブジェクト(「Java オブジェクト」)をオブジェクト化された形式で返すことができます。
バイト値は Byte[]
ではなく byte[]
として返されることに注意してください。
name
- Java オブジェクトの名前 int
として設定された場合、Integer
が返されます); この名前のアイテムがない場合は、null 値が返されます JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。EnumerationSE getMapNames() throws JMSException
MapMessage
オブジェクト内のすべての名前の Enumeration
を返します。MapMessage
のすべての名前の列挙 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの読み取りに失敗した場合。void setBoolean(StringSE name, boolean value) throws JMSException
boolean
値をマップに設定します。name
- boolean
の名前 value
- マップに設定する boolean
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setByte(StringSE name, byte value) throws JMSException
byte
値をマップに設定します。name
- byte
の名前 value
- マップに設定する byte
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setShort(StringSE name, short value) throws JMSException
short
値をマップに設定します。name
- short
の名前 value
- マップに設定する short
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setChar(StringSE name, char value) throws JMSException
name
- Unicode 文字の名前 value
- マップに設定する Unicode 文字値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setInt(StringSE name, int value) throws JMSException
int
値をマップに設定します。name
- int
の名前 value
- マップに設定する int
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setLong(StringSE name, long value) throws JMSException
long
値をマップに設定します。name
- long
の名前 value
- マップに設定する long
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setFloat(StringSE name, float value) throws JMSException
float
値をマップに設定します。name
- float
の名前 value
- マップに設定する float
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setDouble(StringSE name, double value) throws JMSException
double
値をマップに設定します。name
- double
の名前 value
- マップに設定する double
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setString(StringSE name, StringSE value) throws JMSException
String
値をマップに設定します。name
- String
の名前 value
- マップに設定する String
値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setBytes(StringSE name, byte[] value) throws JMSException
name
- バイト配列の名前 value
- マップに設定するバイト配列値。name
の値が将来の変更によって変更されないように配列がコピーされます JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setBytes(StringSE name, byte[] value, int offset, int length) throws JMSException
name
- バイト配列の名前 value
- マップに設定するバイト配列値 offset
- バイト配列内の初期オフセット length
- 使用するバイト数 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。void setObject(StringSE name, ObjectSE value) throws JMSException
このメソッドは、オブジェクト化されたプリミティブオブジェクト型(Integer
、Double
、Long
...)、String
オブジェクト、バイト配列に対してのみ機能します。
name
- Java オブジェクトの名前 value
- マップに設定する Java オブジェクトの値 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがメッセージの書き込みに失敗した場合。IllegalArgumentExceptionSE
- 名前が null の場合、または名前が空の文字列の場合。MessageFormatException
- オブジェクトが無効な場合。MessageNotWriteableException
- メッセージが読み取り専用モードの場合。boolean itemExists(StringSE name) throws JMSException
MapMessage
オブジェクトにアイテムが存在するかどうかを示します。name
- テストするアイテムの名前 JMSException
- 内部エラーのために Jakarta Messaging プロバイダーがアイテムの存在を確認できない場合 Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.