info.pppc.base.io

Class ObjectOutputStream

java.lang.Object

java.io.OutputStream

info.pppc.base.io.ObjectOutputStream

All Implemented Interfaces:

IObjectOutput, java.io.Closeable, java.io.Flushable, java.lang.AutoCloseable

public final class ObjectOutputStream
extends java.io.OutputStream
implements IObjectOutput

This simple (and rather slow) ObjectOutputStream is capable of serializing objects to a stream. It supports primitive arrays, object arrays, primitive type wrapper arrays and objects with one of the following types java.util.Hashtable, java.util.Stack, java.util.Vector and base.system.io.Serializable.

Author:

Marcus Handte

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAXIMUM_LENGTH The maximum length for writing strings.

Constructor Summary

Constructors

Constructor and Description
ObjectOutputStream(java.io.OutputStream stream) Creates a new ObjectOutputStream that writes to the specified DataOutputStream.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes the underlying stream.
void	flush() Flushes the underlying stream.
void	write(int i) Writes an integer to the underlying output stream.
void	writeBoolean(boolean val) Writes a boolean.
void	writeByte(byte val) Writes a 8-bit byte.
void	writeBytes(byte[] buffer) Writes a number of bytes from the byte array buffer.
void	writeBytes(byte[] buffer, int offset, int length) Writes a number of bytes from the byte array buffer starting at the offset index.
void	writeChar(char val) Writes the specified 16-bit character.
void	writeInt(int val) Writes a 32-bit integer.
void	writeLong(long val) Writes a 64-bit integer.
void	writeObject(java.lang.Object object) Writes the passed object to the underlying DataOutputStream and performs the necessary buffer management.
void	writeShort(int val) Writes the specified 16-bit integer.
void	writeUTF(java.lang.String val) Writes the specified String out in UTF format.

Methods inherited from class java.io.OutputStream

write, write

Methods inherited from class java.lang.Object

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

Field Detail

MAXIMUM_LENGTH

public static final int MAXIMUM_LENGTH

The maximum length for writing strings.

See Also:

Constant Field Values

Constructor Detail

ObjectOutputStream

public ObjectOutputStream(java.io.OutputStream stream)

Creates a new ObjectOutputStream that writes to the specified DataOutputStream.

Parameters:

stream - The DataOutputStream to write to.

Method Detail

write

public void write(int i)
           throws java.io.IOException

Writes an integer to the underlying output stream.

Specified by:

write in class java.io.OutputStream

Parameters:

i - The integer to write.

Throws:

java.io.IOException - Thrown if the underlying stream throws an exception.

flush

public void flush()
           throws java.io.IOException

Flushes the underlying stream.

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.OutputStream

Throws:

java.io.IOException - Thrown if the underlying stream throws an exception.

close

public void close()
           throws java.io.IOException

Closes the underlying stream.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.OutputStream

Throws:

java.io.IOException - Thrown if the underlying stream throws an exception.

writeObject

public void writeObject(java.lang.Object object)
                 throws java.io.IOException

Writes the passed object to the underlying DataOutputStream and performs the necessary buffer management.

Specified by:

writeObject in interface IObjectOutput

Parameters:

object - The object to write.

Throws:

java.io.IOException - Thrown if an exception occurs while writing the object.

writeBoolean

public void writeBoolean(boolean val)
                  throws java.io.IOException

Writes a boolean.

Specified by:

writeBoolean in interface IObjectOutput

Parameters:

val - the boolean value to write

Throws:

java.io.IOException - Thrown if an problem occurs.

writeChar

public void writeChar(char val)
               throws java.io.IOException

Writes the specified 16-bit character.

Specified by:

writeChar in interface IObjectOutput

Parameters:

val - The character to be written

Throws:

java.io.IOException - Thrown if an problem occurs.

writeInt

public void writeInt(int val)
              throws java.io.IOException

Writes a 32-bit integer.

Specified by:

writeInt in interface IObjectOutput

Parameters:

val - The integer to be written.

Throws:

java.io.IOException - Thrown if an problem occurs.

writeLong

public void writeLong(long val)
               throws java.io.IOException

Writes a 64-bit integer.

Specified by:

writeLong in interface IObjectOutput

Parameters:

val - The 64-bit integer.

Throws:

java.io.IOException - Thrown if an problem occurs.

writeShort

public void writeShort(int val)
                throws java.io.IOException

Writes the specified 16-bit integer.

Specified by:

writeShort in interface IObjectOutput

Parameters:

val - The 16-bit integer to be written.

Throws:

java.io.IOException - Thrown if an problem occurs.

writeUTF

public void writeUTF(java.lang.String val)
              throws java.io.IOException

Writes the specified String out in UTF format.

Specified by:

writeUTF in interface IObjectOutput

Parameters:

val - The String to be written in UTF format.

Throws:

java.io.IOException - Thrown if an problem occurs.

writeByte

public void writeByte(byte val)
               throws java.io.IOException

Writes a 8-bit byte.

Specified by:

writeByte in interface IObjectOutput

Parameters:

val - The byte value to write

Throws:

java.io.IOException - Thrown if an problem occurs.

writeBytes

public void writeBytes(byte[] buffer)
                throws java.io.IOException

Writes a number of bytes from the byte array buffer. The number of bytes is defined by the length of the array.

Specified by:

writeBytes in interface IObjectOutput

Parameters:

buffer - The buffer to be written

Throws:

java.io.IOException - Thrown if an problem occurs.

writeBytes

public void writeBytes(byte[] buffer,
              int offset,
              int length)
                throws java.io.IOException

Writes a number of bytes from the byte array buffer starting at the offset index. The number of bytes is defined by the length parameter.

Specified by:

writeBytes in interface IObjectOutput

Parameters:

buffer - The buffer to be written.

offset - The offset in buffer.

length - The number of bytes to write.

Throws:

java.io.IOException - Thrown if an problem occurs.