Class StreamMessageImpl

  • All Implemented Interfaces:
    java.io.Serializable, javax.jms.Message, javax.jms.StreamMessage

    public class StreamMessageImpl
    extends MessageImpl
    implements javax.jms.StreamMessage
    Implementation of a StreamMessage.
    Author:
    IIT GmbH, Bremen/Germany, Copyright (c) 2000-2002, All Rights Reserved
    See Also:
    Serialized Form
    • Constructor Detail

      • StreamMessageImpl

        public StreamMessageImpl()
    • Method Detail

      • writeBody

        protected void writeBody​(java.io.DataOutput out)
                          throws java.io.IOException
        Overrides:
        writeBody in class MessageImpl
        Throws:
        java.io.IOException
      • readBody

        protected void readBody​(java.io.DataInput in)
                         throws java.io.IOException
        Overrides:
        readBody in class MessageImpl
        Throws:
        java.io.IOException
      • readBoolean

        public boolean readBoolean()
                            throws javax.jms.JMSException
        Read a boolean from the stream message.
        Specified by:
        readBoolean in interface javax.jms.StreamMessage
        Returns:
        the boolean value read.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readByte

        public byte readByte()
                      throws javax.jms.JMSException
        Read a byte value from the stream message.
        Specified by:
        readByte in interface javax.jms.StreamMessage
        Returns:
        the next byte from the stream message as a 8-bit byte.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readShort

        public short readShort()
                        throws javax.jms.JMSException
        Read a 16-bit number from the stream message.
        Specified by:
        readShort in interface javax.jms.StreamMessage
        Returns:
        a 16-bit number from the stream message.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readChar

        public char readChar()
                      throws javax.jms.JMSException
        Read a Unicode character value from the stream message.
        Specified by:
        readChar in interface javax.jms.StreamMessage
        Returns:
        a Unicode character from the stream message.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readInt

        public int readInt()
                    throws javax.jms.JMSException
        Read a 32-bit integer from the stream message.
        Specified by:
        readInt in interface javax.jms.StreamMessage
        Returns:
        a 32-bit integer value from the stream message, interpreted as a int.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readLong

        public long readLong()
                      throws javax.jms.JMSException
        Read a 64-bit integer from the stream message.
        Specified by:
        readLong in interface javax.jms.StreamMessage
        Returns:
        a 64-bit integer value from the stream message, interpreted as a long.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readFloat

        public float readFloat()
                        throws javax.jms.JMSException
        Read a float from the stream message.
        Specified by:
        readFloat in interface javax.jms.StreamMessage
        Returns:
        a float value from the stream message.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readDouble

        public double readDouble()
                          throws javax.jms.JMSException
        Read a double from the stream message.
        Specified by:
        readDouble in interface javax.jms.StreamMessage
        Returns:
        a double value from the stream message.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readString

        public java.lang.String readString()
                                    throws javax.jms.JMSException
        Read in a string from the stream message.
        Specified by:
        readString in interface javax.jms.StreamMessage
        Returns:
        a Unicode string from the stream message.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readBytes

        public int readBytes​(byte[] value)
                      throws javax.jms.JMSException
        Read a byte array from the stream message.
        Specified by:
        readBytes in interface javax.jms.StreamMessage
        Parameters:
        value - the buffer into which the data is read.
        Returns:
        the total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageFormatException - if this type conversion is invalid
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • readObject

        public java.lang.Object readObject()
                                    throws javax.jms.JMSException
        Read a Java object from the stream message.

        Note that this method can be used to return in objectified format, an object that had been written to the Stream with the equivalent writeObject method call, or it's equivalent primitive write method.

        Specified by:
        readObject in interface javax.jms.StreamMessage
        Returns:
        a Java object from the stream message, in objectified format (ie. if it set as an int, then a Integer is returned).
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageEOFException - if an end of message stream
        javax.jms.MessageNotReadableException - if message in write-only mode.
      • writeBoolean

        public void writeBoolean​(boolean value)
                          throws javax.jms.JMSException
        Write a boolean to the stream message. The value true is written out as the value (byte)1; the value false is written out as the value (byte)0.
        Specified by:
        writeBoolean in interface javax.jms.StreamMessage
        Parameters:
        value - the boolean value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to read message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeByte

        public void writeByte​(byte value)
                       throws javax.jms.JMSException
        Write out a byte to the stream message.
        Specified by:
        writeByte in interface javax.jms.StreamMessage
        Parameters:
        value - the byte value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeShort

        public void writeShort​(short value)
                        throws javax.jms.JMSException
        Write a short to the stream message.
        Specified by:
        writeShort in interface javax.jms.StreamMessage
        Parameters:
        value - the short to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeChar

        public void writeChar​(char value)
                       throws javax.jms.JMSException
        Write a char to the stream message.
        Specified by:
        writeChar in interface javax.jms.StreamMessage
        Parameters:
        value - the char value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeInt

        public void writeInt​(int value)
                      throws javax.jms.JMSException
        Write an int to the stream message.
        Specified by:
        writeInt in interface javax.jms.StreamMessage
        Parameters:
        value - the int to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeLong

        public void writeLong​(long value)
                       throws javax.jms.JMSException
        Write a long to the stream message.
        Specified by:
        writeLong in interface javax.jms.StreamMessage
        Parameters:
        value - the long to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeFloat

        public void writeFloat​(float value)
                        throws javax.jms.JMSException
        Write a float to the stream message.
        Specified by:
        writeFloat in interface javax.jms.StreamMessage
        Parameters:
        value - the float value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeDouble

        public void writeDouble​(double value)
                         throws javax.jms.JMSException
        Write a double to the stream message.
        Specified by:
        writeDouble in interface javax.jms.StreamMessage
        Parameters:
        value - the double value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeString

        public void writeString​(java.lang.String value)
                         throws javax.jms.JMSException
        Write a string to the stream message.
        Specified by:
        writeString in interface javax.jms.StreamMessage
        Parameters:
        value - the String value to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeBytes

        public void writeBytes​(byte[] value)
                        throws javax.jms.JMSException
        Write a byte array to the stream message.
        Specified by:
        writeBytes in interface javax.jms.StreamMessage
        Parameters:
        value - the byte array to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeBytes

        public void writeBytes​(byte[] value,
                               int offset,
                               int length)
                        throws javax.jms.JMSException
        Write a portion of a byte array to the stream message.
        Specified by:
        writeBytes in interface javax.jms.StreamMessage
        Parameters:
        value - the byte array value to be written.
        offset - the initial offset within the byte array.
        length - the number of bytes to use.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
      • writeObject

        public void writeObject​(java.lang.Object value)
                         throws javax.jms.JMSException
        Write a Java object to the stream message.

        Note that this method only works for the objectified primitive object types (Integer, Double, Long ...), String's and byte arrays.

        Specified by:
        writeObject in interface javax.jms.StreamMessage
        Parameters:
        value - the Java object to be written.
        Throws:
        javax.jms.JMSException - if JMS fails to write message due to some internal JMS error.
        javax.jms.MessageNotWriteableException - if message in read-only mode.
        javax.jms.MessageFormatException - if the object is invalid
      • reset

        public void reset()
                   throws javax.jms.JMSException
        Put the message in read-only mode, and reposition the stream to the beginning.
        Specified by:
        reset in interface javax.jms.StreamMessage
        Overrides:
        reset in class MessageImpl
        Throws:
        javax.jms.JMSException - if JMS fails to reset the message due to some internal JMS error.
        javax.jms.MessageFormatException - if message has an invalid format
      • clearBody

        public void clearBody()
                       throws javax.jms.JMSException
        Clear out the message body. All other parts of the message are left untouched.
        Specified by:
        clearBody in interface javax.jms.Message
        Overrides:
        clearBody in class MessageImpl
        Throws:
        javax.jms.JMSException - if JMS fails to due to some internal JMS error.