org.jboss.marshalling

Class ObjectInputStreamUnmarshaller

java.lang.Object

org.jboss.marshalling.ObjectInputStreamUnmarshaller

All Implemented Interfaces:

java.io.Closeable, java.io.DataInput, java.io.ObjectInput, java.lang.AutoCloseable, ByteInput, Unmarshaller

public class ObjectInputStreamUnmarshaller
extends java.lang.Object
implements Unmarshaller

An Unmarshaller which simply wraps an object stream. Useful for retrofitting and testing applications.

Constructor Summary

Constructors

Constructor and Description
ObjectInputStreamUnmarshaller(java.io.ObjectInputStream ois) Construct a new instance which wraps the given stream.

Method Summary

Methods

Modifier and Type	Method and Description
int	available() Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream.
void	clearClassCache() Discard the class cache.
void	clearInstanceCache() Discard the instance cache.
void	close()
void	finish() Finish unmarshalling from a stream.
int	read() Reads the next byte of data from the input stream.
int	read(byte[] b) Read some bytes from the input stream into the given array.
int	read(byte[] buf, int off, int len) Read some bytes from the input stream into the given array.
boolean	readBoolean()
byte	readByte()
char	readChar()
double	readDouble()
float	readFloat()
void	readFully(byte[] buf)
void	readFully(byte[] buf, int off, int len)
int	readInt()
java.lang.String	readLine() Deprecated.
long	readLong()
java.lang.Object	readObject()
<T> T	readObject(java.lang.Class<T> type) Read and return an object, cast to a specific type.
java.lang.Object	readObjectUnshared() Read and return an unshared object.
<T> T	readObjectUnshared(java.lang.Class<T> type) Read and return an unshared object, cast to a specific type.
short	readShort()
int	readUnsignedByte()
int	readUnsignedShort()
java.lang.String	readUTF()
long	skip(long n) Skips over and discards up to n bytes of data from this input stream.
int	skipBytes(int len)
void	start(ByteInput newInput) Begin unmarshalling from a stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ObjectInputStreamUnmarshaller

public ObjectInputStreamUnmarshaller(java.io.ObjectInputStream ois)

Construct a new instance which wraps the given stream.

Parameters:

ois - the object stream to wrap

Method Detail

readObject

public java.lang.Object readObject()
                            throws java.io.IOException,
                                   java.lang.ClassNotFoundException

Specified by:

readObject in interface java.io.ObjectInput

Throws:

java.io.IOException

java.lang.ClassNotFoundException

readObjectUnshared

public java.lang.Object readObjectUnshared()
                                    throws java.io.IOException,
                                           java.lang.ClassNotFoundException

Read and return an unshared object.

Specified by:

readObjectUnshared in interface Unmarshaller

Returns:

an unshared object

Throws:

java.io.IOException - if an error occurs

java.lang.ClassNotFoundException - if the class of a serialized object cannot be found

read

public int read()
         throws java.io.IOException

Reads the next byte of data from the input stream. If no byte is available because the end of the stream has been reached, the value -1 is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.

Specified by:

read in interface java.io.ObjectInput

Specified by:

read in interface ByteInput

Returns:

the next byte, or -1 if the end of stream has been reached

Throws:

java.io.IOException - if an error occurs

read

public int read(byte[] buf,
       int off,
       int len)
         throws java.io.IOException

Read some bytes from the input stream into the given array. Returns the number of bytes actually read (possibly zero), or -1 if the end of stream has been reached.

Specified by:

read in interface java.io.ObjectInput

Specified by:

read in interface ByteInput

Parameters:

buf - the destination array

off - the offset into the array into which data should be read

len - the number of bytes to attempt to fill in the destination array

Returns:

the number of bytes read (possibly zero), or -1 if the end of stream has been reached

Throws:

java.io.IOException - if an error occurs

available

public int available()
              throws java.io.IOException

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream.

Specified by:

available in interface java.io.ObjectInput

Specified by:

available in interface ByteInput

Returns:

the number of bytes

Throws:

java.io.IOException - if an error occurs

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.io.ObjectInput

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

readBoolean

public boolean readBoolean()
                    throws java.io.IOException

Specified by:

readBoolean in interface java.io.DataInput

Throws:

java.io.IOException

readByte

public byte readByte()
              throws java.io.IOException

Specified by:

readByte in interface java.io.DataInput

Throws:

java.io.IOException

readUnsignedByte

public int readUnsignedByte()
                     throws java.io.IOException

Specified by:

readUnsignedByte in interface java.io.DataInput

Throws:

java.io.IOException

readChar

public char readChar()
              throws java.io.IOException

Specified by:

readChar in interface java.io.DataInput

Throws:

java.io.IOException

readShort

public short readShort()
                throws java.io.IOException

Specified by:

readShort in interface java.io.DataInput

Throws:

java.io.IOException

readUnsignedShort

public int readUnsignedShort()
                      throws java.io.IOException

Specified by:

readUnsignedShort in interface java.io.DataInput

Throws:

java.io.IOException

readInt

public int readInt()
            throws java.io.IOException

Specified by:

readInt in interface java.io.DataInput

Throws:

java.io.IOException

readLong

public long readLong()
              throws java.io.IOException

Specified by:

readLong in interface java.io.DataInput

Throws:

java.io.IOException

readFloat

public float readFloat()
                throws java.io.IOException

Specified by:

readFloat in interface java.io.DataInput

Throws:

java.io.IOException

readDouble

public double readDouble()
                  throws java.io.IOException

Specified by:

readDouble in interface java.io.DataInput

Throws:

java.io.IOException

readFully

public void readFully(byte[] buf)
               throws java.io.IOException

Specified by:

readFully in interface java.io.DataInput

Throws:

java.io.IOException

readFully

public void readFully(byte[] buf,
             int off,
             int len)
               throws java.io.IOException

Specified by:

readFully in interface java.io.DataInput

Throws:

java.io.IOException

skipBytes

public int skipBytes(int len)
              throws java.io.IOException

Specified by:

skipBytes in interface java.io.DataInput

Throws:

java.io.IOException

readLine

@Deprecated
public java.lang.String readLine()
                          throws java.io.IOException

Deprecated.

Specified by:

readLine in interface java.io.DataInput

Throws:

java.io.IOException

readUTF

public java.lang.String readUTF()
                         throws java.io.IOException

Specified by:

readUTF in interface java.io.DataInput

Throws:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

Read some bytes from the input stream into the given array. Returns the number of bytes actually read (possibly zero), or -1 if the end of stream has been reached.

Specified by:

read in interface java.io.ObjectInput

Specified by:

read in interface ByteInput

Parameters:

b - the destination array

Returns:

the number of bytes read (possibly zero), or -1 if the end of stream has been reached

Throws:

java.io.IOException - if an error occurs

skip

public long skip(long n)
          throws java.io.IOException

Skips over and discards up to n bytes of data from this input stream. If the end of stream is reached, this method returns 0 in order to be consistent with InputStream.skip(long).

Specified by:

skip in interface java.io.ObjectInput

Specified by:

skip in interface ByteInput

Parameters:

n - the number of bytes to attempt to skip

Returns:

the number of bytes skipped

Throws:

java.io.IOException - if an error occurs

start

public void start(ByteInput newInput)
           throws java.io.IOException

Begin unmarshalling from a stream.

Specified by:

start in interface Unmarshaller

Parameters:

newInput - the new stream

Throws:

java.io.IOException - if an error occurs during setup, such as an invalid header

clearInstanceCache

public void clearInstanceCache()
                        throws java.io.IOException

Discard the instance cache.

Specified by:

clearInstanceCache in interface Unmarshaller

Throws:

java.io.IOException - if an error occurs

clearClassCache

public void clearClassCache()
                     throws java.io.IOException

Discard the class cache. Implicitly also discards the instance cache.

Specified by:

clearClassCache in interface Unmarshaller

Throws:

java.io.IOException - if an error occurs

finish

public void finish()
            throws java.io.IOException

Finish unmarshalling from a stream. Any transient class or instance cache is discarded.

Specified by:

finish in interface Unmarshaller

Throws:

java.io.IOException - if an error occurs

readObject

public <T> T readObject(java.lang.Class<T> type)
             throws java.lang.ClassNotFoundException,
                    java.io.IOException

Read and return an object, cast to a specific type.

Specified by:

readObject in interface Unmarshaller

Type Parameters:

T - the object type

Parameters:

type - the object class

Returns:

the object read from the stream

Throws:

java.lang.ClassNotFoundException - if the class of a serialized object cannot be found

java.io.InvalidObjectException - if the object is not of the expected type

java.io.IOException - if an error occurs

readObjectUnshared

public <T> T readObjectUnshared(java.lang.Class<T> type)
                     throws java.lang.ClassNotFoundException,
                            java.io.IOException

Read and return an unshared object, cast to a specific type.

Specified by:

readObjectUnshared in interface Unmarshaller

Type Parameters:

T - the object type

Parameters:

type - the object class

Returns:

an unshared object

Throws:

java.lang.ClassNotFoundException - if the class of a serialized object cannot be found

java.io.InvalidObjectException - if the object is not of the expected type

java.io.IOException - if an error occurs