|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
com.stc.eways.MQSeriesETD.Message
| Inner Class Summary | |
class |
Message.MsgBody
Contained class to wrap the ETD's concept of a MsgBody |
class |
Message.MsgHeader
Contained class to wrap the ETD's concept of a MsgHeader. |
| Constructor Summary | |
Message()
|
|
| Method Summary | |
void |
clearMessage()
Discards data in the message buffer and reset the data offset to zero. |
int |
getDataLength()
Reports the number of bytes of data remaining to be read in the message. |
int |
getDataOffset()
Returns the current position of the cursor within the message. |
int |
getMessageLength()
Reports the total number of bytes in the stored message on the queue. |
int |
getTotalMessageLength()
If MQQueue.get() fails with a message-truncated error code, getTotalMessageLength() reports the total number of bytes in the stored message on the queue. |
boolean |
readBoolean()
Reads a (signed) byte from the present position in the message buffer. |
char |
readChar()
Reads a Unicode character from the present position in the message buffer. |
short |
readDecimal2()
Reads a 2-byte packed decimal number (-999 to 999). |
int |
readDecimal4()
Reads a 4-byte packed decimal number (-9999999 to 9999999). |
long |
readDecimal8()
Reads an 8-byte packed decimal number (-999999999999999 to 999999999999999). |
double |
readDouble()
Reads a double from the present position in the message buffer. |
float |
readFloat()
Reads a float from the present position in the message buffer. |
void |
readFully(byte[] buffer)
Fills the byte array b with data from the message buffer. |
void |
readFully(byte[] buffer,
int offset,
int len)
Fills the len elements of the byte array b with data from the message buffer, starting at offset off. |
int |
readInt()
Reads an integer from the present position in the message buffer. |
short |
readInt2()
Equivalent to readshort(), readInt2 is provided for cross-language MQSeries API compatibility. |
int |
readInt4()
Equivalent to readInt(), readInt4 is provided for cross-language MQSeries API compatibility. |
long |
readInt8()
Equivalent to readlong(), readInt8 is provided for cross-language MQSeries API compatibility. |
java.lang.String |
readLine()
Converts from the codeset defined in the characterSet member variable to Unicode, then reads in a line that has been terminated by \n, \r, \r\n, or EOF. |
long |
readLong()
Reads a long from the present position in the message buffer. |
java.lang.Object |
readObject()
Reads an object, its class, class signature, and the value of the non-transient and nonstatic fields of the class. |
short |
readShort()
Reads a short from the present position in the message buffer. |
java.lang.String |
readString(int length)
Reads a string in the codeset defined by the characterSet member variable. |
int |
readUInt2()
Equivalent to readUnsignedShort(), readUInt2 is provided for cross-language MQSeries API compatibility. |
int |
readUnsignedByte()
Reads an unsigned byte from the present position in the message buffer. |
int |
readUnsignedShort()
Reads an unsigned short from the present position in the message buffer. |
java.lang.String |
readUTF()
Reads a UTF string, prefixed by a 2-byte length field, from the present position in the message buffer. |
void |
resizeBuffer(int size)
Clues the MQMessage object as to the size of buffer that may be necessary for subsequent get operations. |
void |
seek(int pos)
Relocates the cursor to the absolute position in the message buffer given by pos. |
void |
setDataOffset(int offset)
Relocates the cursor to the absolute position in the message buffer. |
void |
setVersion(int version)
Sets the version of the structure to be used. |
int |
skipBytes(int numberOfBytes)
Advances n bytes in the message buffer. |
void |
write(byte[] byteArray)
Writes a byte, an array of bytes, or a series of bytes into the message buffer at the present position. |
void |
write(byte[] byteArray,
int offset,
int len)
Writes a byte, an array of bytes, or a series of bytes into the message buffer at the present position. |
void |
write(int byteValue)
Writes a byte, an array of bytes, or a series of bytes into the message buffer at the present position. |
void |
writeBoolean(boolean boolValue)
Writes a Boolean into the message buffer at the present position. |
void |
writeByte(int byteValue)
Writes a byte into the message buffer at the present position. |
void |
writeBytes(java.lang.String stringValue)
Writes the string to the message buffer as a sequence of bytes. |
void |
writeChar(int unicodeChar)
Writes a Unicode character into the message buffer at the present position. |
void |
writeChars(java.lang.String str)
Writes a string as a sequence of Unicode characters into the message buffer at the current position. |
void |
writeDecimal2(short decimal2Value)
Writes a 2-byte packed decimal format number into the message buffer at the present position. |
void |
writeDecimal4(int decimal4Value)
Writes a 4-byte packed decimal format number into the message buffer at the present position. |
void |
writeDecimal8(long decimal8Value)
Writes an 8-byte packed decimal format number into the message buffer at the present position. |
void |
writeDouble(double doubleValue)
Writes a double into the message buffer at the present position. |
void |
writeFloat(float floatValue)
Writes a float into the message buffer at the present position. |
void |
writeInt(int intValue)
Writes an integer into the message buffer at the present position. |
void |
writeLong(long longValue)
Writes a long into the message buffer at the present position. |
void |
writeObject(java.lang.Object objValue)
Writes the specified object, object class, class signature, and the values of the nontransient and non-static fields of the class and all its supertypes. |
void |
writeShort(int shortValue)
Writes a short into the message buffer at the present position. |
void |
writeString(java.lang.String stringValue)
Writes a string into the message buffer at the present position, converting it to the codeset identified by the characterSet member variable. |
void |
writeUTF(java.lang.String utfString)
Writes a UTF string, prefixed by a 2-byte length field, into the message buffer at the present position. |
| Constructor Detail |
public Message()
| Method Detail |
public void clearMessage()
throws com.stc.common.collabService.CollabConnException
void - None.
public int getDataLength()
throws com.stc.common.collabService.CollabConnException
int - Returns the number, in bytes, of message data remaining to be read.
public int getDataOffset()
throws com.stc.common.collabService.CollabConnException
int - Returns the current cursor position.
public int getMessageLength()
throws com.stc.common.collabService.CollabConnException
void - None.
public int getTotalMessageLength()
throws com.stc.common.collabService.CollabConnException
int - Returns the number of bytes of the message as stored on the message queue.
public boolean readBoolean()
throws com.stc.common.collabService.CollabConnException
Boolean - A byte from the current position in the message buffer.
public char readChar()
throws com.stc.common.collabService.CollabConnException
char - Returns a unicode character from the current position in the message buffer.
public short readDecimal2()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL reads a big-endian packed decimal number, and a value of MQC.MQENC_DECIMAL_REVERSED reads a little-endian packed decimal number.
short - Returns a 2-byte packed decimal number.
public int readDecimal4()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL reads a big-endian packed decimal number, and a value of MQC.MQENC_DECIMAL_REVERSED reads a little-endian packed decimal number.
int - Returns a 4-byte packed decimal number.
public long readDecimal8()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL reads a big-endian packed decimal number, and a value of MQC.MQENC_DECIMAL_REVERSED reads a little-endian packed decimal number.
long - Returns an 8-byte packed decimal number.
public double readDouble()
throws com.stc.common.collabService.CollabConnException
MQC.MQENC_FLOAT_S390 reads a System/390 format floating point number. MQC.MQENC_FLOAT_IEEE_NORMAL and MQC.MQENC_FLOAT_IEEE_REVERSED read IEEE standard doubles in bigendian and little-endian formats respectively.
double - Returns a double from the present position in the message buffer.
public float readFloat()
throws com.stc.common.collabService.CollabConnException
MQC.MQENC_FLOAT_S390 reads a System/390 format floating point number. MQC.MQENC_FLOAT_IEEE_NORMAL and MQC.MQENC_FLOAT_IEEE_REVERSED read IEEE standard floats in big-endian and little-endian formats respectively.
float - Returns a float from the present position in the message buffer.
public void readFully(byte[] buffer)
throws com.stc.common.collabService.CollabConnException
buffer - Fills the byte array b with data from the message buffer.void - None.
public void readFully(byte[] buffer,
int offset,
int len)
throws com.stc.common.collabService.CollabConnException
buffer - Fills the byte array b with data from the message buffer.offset - The offset at which the fill starts.len - Fills len elements of the byte array b with data from the message buffer.void - None.
public int readInt()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL reads a big-endian integer, a value of MQC.MQENC_INTEGER_REVERSED reads a little-endian integer.
int - Returns an integer from the current position in the message buffer.
public short readInt2()
throws com.stc.common.collabService.CollabConnException
short - Returns a short from the present position in the message buffer.
public int readInt4()
throws com.stc.common.collabService.CollabConnException
int - Returns an integer from the current position in the message buffer.
public long readInt8()
throws com.stc.common.collabService.CollabConnException
long - Returns a long from the present position in the message buffer.
public java.lang.String readLine()
throws com.stc.common.collabService.CollabConnException
String - Returns the unicode characterSet.
public long readLong()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL reads a big-endian long, a value of MQC.MQENC_INTEGER_REVERSED reads a little-endian long.
long - Returns a long from the present position in the message buffer.
public java.lang.Object readObject()
throws com.stc.common.collabService.CollabConnException
object - Returns an object, its class, class signature, and vield value.
public short readShort()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL reads a big-endian short, a value of MQC.MQENC_INTEGER_REVERSED reads a little-endian short.
short - Returns a short from the present position in the message buffer.
public java.lang.String readString(int length)
throws com.stc.common.collabService.CollabConnException
length - The number of characters to read (not the same as the number of bytes)String - Returns the Unicode value of the string in the codeset
defined by the characterSet member variable.
public int readUInt2()
throws com.stc.common.collabService.CollabConnException
int - Returns an unsigned int from the present position in the message buffer.
public int readUnsignedByte()
throws com.stc.common.collabService.CollabConnException
int - Returns an unsigned byte from the present position in the message buffer.
public int readUnsignedShort()
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL reads a big-endian unsigned short, a value of MQC.MQENC_INTEGER_REVERSED reads a little-endian unsigned short.
int - Returns an unsigned int from the present position in the message buffer.
public java.lang.String readUTF()
throws com.stc.common.collabService.CollabConnException
String - Returns a UTF String, beginning with a 2-byte length field, from the present
position in the message buffer.
public void resizeBuffer(int size)
throws com.stc.common.collabService.CollabConnException
size - The size of the buffer.int - Returns the new message size.
public void seek(int pos)
throws com.stc.common.collabService.CollabConnException
pos - Gives the absolute position in the message buffer.void - None.
public void setDataOffset(int offset)
throws com.stc.common.collabService.CollabConnException
offset - Gives the absolute position in the message buffer.void - None.
public void setVersion(int version)
throws com.stc.common.collabService.CollabConnException
This method is used when it is necessary to force a client to use a version 1 structure when connected to a queue manager that is able to handling version 2 structures. In all other situations, the client determines the correct version by querying the queue manager's capabilities.
version - The version number.void - None.
public int skipBytes(int numberOfBytes)
throws com.stc.common.collabService.CollabConnException
numberOfBytes - Move forward n bytes in the message buffer.int - Returns the number of bytes skipped, which is always n.
public void write(byte[] byteArray)
throws com.stc.common.collabService.CollabConnException
byteArray - The number of characters to read (not the same as the number of bytes)void - None.
public void write(byte[] byteArray,
int offset,
int len)
throws com.stc.common.collabService.CollabConnException
byteArray - The number of characters to read (not the same as the number of bytes)offset - The offset in the arraylen - The number of bytes to be writtenvoid - None.
public void write(int byteValue)
throws com.stc.common.collabService.CollabConnException
byteValue - The number of characters to read (not the same as the number of bytes).void - None.
public void writeBoolean(boolean boolValue)
throws com.stc.common.collabService.CollabConnException
boolValue - The Boolean value.void - None.
public void writeByte(int byteValue)
throws com.stc.common.collabService.CollabConnException
byteValue - The byte value.void - None.
public void writeBytes(java.lang.String stringValue)
throws com.stc.common.collabService.CollabConnException
stringValue - The string of bytes.void - None.
public void writeChar(int unicodeChar)
throws com.stc.common.collabService.CollabConnException
unicodeChar - The unicode value.void - None.
public void writeChars(java.lang.String str)
throws com.stc.common.collabService.CollabConnException
str - The string value.void - None.
public void writeDecimal2(short decimal2Value)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL writes a big-endian packed decimal. A value of MQC.MQENC_DECIMAL_REVERSED writes a little-endian packed decimal.
decimal2Value - The 2-byte decimal value.void - None.
public void writeDecimal4(int decimal4Value)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL writes a big-endian packed decimal. A value of MQC.MQENC_DECIMAL_REVERSED writes a little-endian packed decimal.
decimal4Value - The 4-byte decimal value.void - None.
public void writeDecimal8(long decimal8Value)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_DECIMAL_NORMAL writes a big-endian packed decimal. A value of MQC.MQENC_DECIMAL_REVERSED writes a little-endian packed decimal.
decimal8Value - The 8-byte decimal value..void - None.
public void writeDouble(double doubleValue)
throws com.stc.common.collabService.CollabConnException
A Value of MQC.MQENC_FLOAT_IEEE_NORMAL or MQC.MQENC_FLOAT_IEEE_REVERSED write IEEE standard floats in big-endian and little-endian formats respectively. A value of MQC.MQENC_FLOAT_S390 writes a System/390 format floating point number. The range of IEEE doubles is greater than the range of S/390 double precision floating point numbers. Very large numbers cannot be converted.
doubleValue - The number of characters to read (not the same as the number of bytes).void - None.
public void writeFloat(float floatValue)
throws com.stc.common.collabService.CollabConnException
A Value of MQC.MQENC_FLOAT_IEEE_NORMAL or MQC.MQENC_FLOAT_IEEE_REVERSED write IEEE standard floats in big-endian and little-endian formats respectively. A value of MQC.MQENC_FLOAT_S390 writes a System/390 format floating point number.
floatValue - The float value.void - None.
public void writeInt(int intValue)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL writes a big-endian integer. A value of MQC.MQENC_INTEGER_REVERSED writes a little-endian integer.
intValue - The int value.void - None.
public void writeLong(long longValue)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL writes a big-endian long. A value of MQC.MQENC_INTEGER_REVERSED writes a little-endian long.
longValue - The long value.void - None.
public void writeObject(java.lang.Object objValue)
throws com.stc.common.collabService.CollabConnException
objValue - The object value.void - None.
public void writeShort(int shortValue)
throws com.stc.common.collabService.CollabConnException
A value of MQC.MQENC_INTEGER_NORMAL writes a big-endian short. A value of MQC.MQENC_INTEGER_REVERSED writes a little-endian short.
shortValue - The short value.void - None.
public void writeString(java.lang.String stringValue)
throws com.stc.common.collabService.CollabConnException
stringValue - The string value.void - None.
public void writeUTF(java.lang.String utfString)
throws com.stc.common.collabService.CollabConnException
utfString - The string value.void - None.
|
|||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
Copyright 2003 by SeeBeyond Technology Corporation. All Rights Reserved.