orc.trace.handles
Class HandleInputStream

java.lang.Object
  extended by java.io.InputStream
      extended by java.io.ObjectInputStream
          extended by orc.trace.handles.HandleInputStream
All Implemented Interfaces:
java.io.Closeable, java.io.DataInput, java.io.ObjectInput, java.io.ObjectStreamConstants

public class HandleInputStream
extends java.io.ObjectInputStream

Used in conjunction with Handle to explicitly manage the lifetime of serialized references.

Author:
quark
See Also:
HandleOutputStream, Handle

Nested Class Summary
 
Nested classes/interfaces inherited from class java.io.ObjectInputStream
java.io.ObjectInputStream.GetField
 
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
HandleInputStream()
           
HandleInputStream(java.io.InputStream in)
           
 
Method Summary
 void freeHandled(int id)
          Free a handle ID.
 java.lang.Object getHandled(int id)
          Get the value referenced by a handle ID.
 void putHandled(int id, java.lang.Object value)
          Set the value referenced by a handle ID.
<E> Handle<E>
readHandle()
           
 
Methods inherited from class java.io.ObjectInputStream
available, close, defaultReadObject, enableResolveObject, read, read, readBoolean, readByte, readChar, readClassDescriptor, readDouble, readFields, readFloat, readFully, readFully, readInt, readLine, readLong, readObject, readObjectOverride, readShort, readStreamHeader, readUnshared, readUnsignedByte, readUnsignedShort, readUTF, registerValidation, resolveClass, resolveObject, resolveProxyClass, skipBytes
 
Methods inherited from class java.io.InputStream
mark, markSupported, read, reset, skip
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface java.io.ObjectInput
read, skip
 

Constructor Detail

HandleInputStream

public HandleInputStream()
                  throws java.io.IOException,
                         java.lang.SecurityException
Throws:
java.io.IOException
java.lang.SecurityException

HandleInputStream

public HandleInputStream(java.io.InputStream in)
                  throws java.io.IOException
Throws:
java.io.IOException
Method Detail

getHandled

public java.lang.Object getHandled(int id)
Get the value referenced by a handle ID.


putHandled

public void putHandled(int id,
                       java.lang.Object value)
Set the value referenced by a handle ID.


freeHandled

public void freeHandled(int id)
Free a handle ID.


readHandle

public <E> Handle<E> readHandle()
                     throws java.io.IOException
Throws:
java.io.IOException