SMILA (incubation) API documentation

org.eclipse.smila.objectstore
Class StoreOutputStream

java.lang.Object
  extended by java.io.OutputStream
      extended by org.eclipse.smila.objectstore.StoreOutputStream
All Implemented Interfaces:
java.io.Closeable, java.io.Flushable
Direct Known Subclasses:
SimpleStoreOutputStream

public abstract class StoreOutputStream
extends java.io.OutputStream

Extension of Java's OutputStream to support aborting a created but not yet closed object. The purpose is to tell the ObjectStoreService that the object this stream writes to should never become visible because it is not valid. See description of abort() for details. If abort() is not called before OutputStream.close() the object will become visible in the store after the call to OutputStream.close(). The IOExceptions thrown by the OutputStream.write(int), OutputStream.write(byte[]), OutputStream.write(byte[], int, int), OutputStream.flush(), and OutputStream.close() exceptions may contain ObjectStoreExceptions as cause which describe the error in more detail.


Constructor Summary
StoreOutputStream()
           
 
Method Summary
abstract  void abort()
          abort the object written to.
 
Methods inherited from class java.io.OutputStream
close, flush, write, write, write
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StoreOutputStream

public StoreOutputStream()
Method Detail

abort

public abstract void abort()
abort the object written to. Must be called before OutputStream.close() to prevent the object from becoming visible in the store. After aborting the object, no further write operations are possible.


SMILA (incubation) API documentation