games.strategy.engine.data
Class GameObjectOutputStream

java.lang.Object
  extended by java.io.OutputStream
      extended by java.io.ObjectOutputStream
          extended by games.strategy.engine.data.GameObjectOutputStream
All Implemented Interfaces:
java.io.Closeable, java.io.DataOutput, java.io.Flushable, java.io.ObjectOutput, java.io.ObjectStreamConstants

public class GameObjectOutputStream
extends java.io.ObjectOutputStream

To maintain == relationships and the singleton nature of many classes in GameData we do some work in the ObjectSteam. For example, when we serialize a Territory over a GameObjectOutputStream, we do not send an instance of Territory, but rather a marker saying that this is the territory, and this is its name. When it comes time for a GameObjectOutputStream to read the territory on the other side, the territory name is read, and the territory returned by the GameObjectInputStream is the territory with that name beloning to the GameData associated with the GameObjectInputStream. This ensures the state of the territory remains consistent.

Author:
Sean Bridges

Nested Class Summary
 
Nested classes/interfaces inherited from class java.io.ObjectOutputStream
java.io.ObjectOutputStream.PutField
 
Field Summary
 
Fields inherited from interface java.io.ObjectStreamConstants
baseWireHandle, PROTOCOL_VERSION_1, PROTOCOL_VERSION_2, SC_BLOCK_DATA, SC_ENUM, SC_EXTERNALIZABLE, SC_SERIALIZABLE, SC_WRITE_METHOD, STREAM_MAGIC, STREAM_VERSION, SUBCLASS_IMPLEMENTATION_PERMISSION, SUBSTITUTION_PERMISSION, TC_ARRAY, TC_BASE, TC_BLOCKDATA, TC_BLOCKDATALONG, TC_CLASS, TC_CLASSDESC, TC_ENDBLOCKDATA, TC_ENUM, TC_EXCEPTION, TC_LONGSTRING, TC_MAX, TC_NULL, TC_OBJECT, TC_PROXYCLASSDESC, TC_REFERENCE, TC_RESET, TC_STRING
 
Constructor Summary
GameObjectOutputStream(java.io.OutputStream output)
          Creates a new instance of GameObjectOutputStream
 
Method Summary
protected  java.lang.Object replaceObject(java.lang.Object obj)
           
 
Methods inherited from class java.io.ObjectOutputStream
annotateClass, annotateProxyClass, close, defaultWriteObject, drain, enableReplaceObject, flush, putFields, reset, useProtocolVersion, write, write, write, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeClassDescriptor, writeDouble, writeFields, writeFloat, writeInt, writeLong, writeObject, writeObjectOverride, writeShort, writeStreamHeader, writeUnshared, writeUTF
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GameObjectOutputStream

public GameObjectOutputStream(java.io.OutputStream output)
                       throws java.io.IOException
Creates a new instance of GameObjectOutputStream

Throws:
java.io.IOException
Method Detail

replaceObject

protected java.lang.Object replaceObject(java.lang.Object obj)
                                  throws java.io.IOException
Overrides:
replaceObject in class java.io.ObjectOutputStream
Throws:
java.io.IOException