| Methods Summary |
|---|
| public long | getBodyLength()Gets the number of bytes of the message body when the message
is in read-only mode. The value returned can be used to allocate
a byte array. The value returned is the entire length of the message
body, regardless of where the pointer for reading the message
is currently located.
|
| public boolean | readBoolean()Reads a boolean from the bytes message stream.
|
| public byte | readByte()Reads a signed 8-bit value from the bytes message stream.
|
| public int | readBytes(byte[] value)Reads a byte array from the bytes message stream.
If the length of array value is less than the number of
bytes remaining to be read from the stream, the array should
be filled. A subsequent call reads the next increment, and so on.
If the number of bytes remaining in the stream is less than the
length of
array value, the bytes should be read into the array.
The return value of the total number of bytes read will be less than
the length of the array, indicating that there are no more bytes left
to be read from the stream. The next read of the stream returns -1.
|
| public int | readBytes(byte[] value, int length)Reads a portion of the bytes message stream.
If the length of array value is less than the number of
bytes remaining to be read from the stream, the array should
be filled. A subsequent call reads the next increment, and so on.
If the number of bytes remaining in the stream is less than the
length of
array value, the bytes should be read into the array.
The return value of the total number of bytes read will be less than
the length of the array, indicating that there are no more bytes left
to be read from the stream. The next read of the stream returns -1.
If length is negative, or
length is greater than the length of the array
value, then an IndexOutOfBoundsException is
thrown. No bytes will be read from the stream for this exception case.
|
| public char | readChar()Reads a Unicode character value from the bytes message stream.
|
| public double | readDouble()Reads a double from the bytes message stream.
|
| public float | readFloat()Reads a float from the bytes message stream.
|
| public int | readInt()Reads a signed 32-bit integer from the bytes message stream.
|
| public long | readLong()Reads a signed 64-bit integer from the bytes message stream.
|
| public short | readShort()Reads a signed 16-bit number from the bytes message stream.
|
| public java.lang.String | readUTF()Reads a string that has been encoded using a modified UTF-8
format from the bytes message stream.
For more information on the UTF-8 format, see "File System Safe
UCS Transformation Format (FSS_UTF)", X/Open Preliminary Specification,
X/Open Company Ltd., Document Number: P316. This information also
appears in ISO/IEC 10646, Annex P.
|
| public int | readUnsignedByte()Reads an unsigned 8-bit number from the bytes message stream.
|
| public int | readUnsignedShort()Reads an unsigned 16-bit number from the bytes message stream.
|
| public void | reset()Puts the message body in read-only mode and repositions the stream of
bytes to the beginning.
|
| public void | writeBoolean(boolean value)Writes a boolean to the bytes message stream as a 1-byte
value.
The value true is written as the value
(byte)1; the value false is written as
the value (byte)0.
|
| public void | writeByte(byte value)Writes a byte to the bytes message stream as a 1-byte
value.
|
| public void | writeBytes(byte[] value)Writes a byte array to the bytes message stream.
|
| public void | writeBytes(byte[] value, int offset, int length)Writes a portion of a byte array to the bytes message stream.
|
| public void | writeChar(char value)Writes a char to the bytes message stream as a 2-byte
value, high byte first.
|
| public void | writeDouble(double value)Converts the double argument to a long using
the
doubleToLongBits method in class Double,
and then writes that long value to the bytes message
stream as an 8-byte quantity, high byte first.
|
| public void | writeFloat(float value)Converts the float argument to an int using
the
floatToIntBits method in class Float,
and then writes that int value to the bytes message
stream as a 4-byte quantity, high byte first.
|
| public void | writeInt(int value)Writes an int to the bytes message stream as four bytes,
high byte first.
|
| public void | writeLong(long value)Writes a long to the bytes message stream as eight bytes,
high byte first.
|
| public void | writeObject(java.lang.Object value)Writes an object to the bytes message stream.
This method works only for the objectified primitive
object types (Integer, Double,
Long ...), String objects, and byte
arrays.
|
| public void | writeShort(short value)Writes a short to the bytes message stream as two bytes,
high byte first.
|
| public void | writeUTF(java.lang.String value)Writes a string to the bytes message stream using UTF-8 encoding in a
machine-independent manner.
For more information on the UTF-8 format, see "File System Safe
UCS Transformation Format (FSS_UTF)", X/Open Preliminary Specification,
X/Open Company Ltd., Document Number: P316. This information also
appears in ISO/IEC 10646, Annex P.
|
