org.deegree.commons.utils.io
Class StreamBufferStore

java.lang.Object
  java.io.OutputStream
      org.deegree.commons.utils.io.StreamBufferStore

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable

public class StreamBufferStore
extends java.io.OutputStream

Scalable alternative to ByteArrayOutputStream that automatically switches to file storage if the amount of written output exceeds a given limit.

Version:

$Revision: 25575 $, $Date: 2010-07-28 10:39:13 +0200 (Mi, 28. Jul 2010) $

Author:

Markus Schneider, last edited by: $Author: sthomas $

Field Summary

static int

DEFAULT_LIMIT Default limit

Constructor Summary

StreamBufferStore()
Creates a new StreamBufferStore instance that switches to file storage when DEFAULT_LIMIT bytes have been written.

StreamBufferStore(int limit)
Creates a new StreamBufferStore instance that switches to file storage when the specified number of bytes have been written.

Method Summary

void	close()
void	flush()
java.io.InputStream	getInputStream() Returns an InputStream for accessing the previously written bytes.
void	reset() Clears any data that exists in the buffer.
int	size() Returns the current size of the buffer.
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)
void	writeTo(java.io.OutputStream outputStream) Writes the complete contents of this buffer to the specified output stream argument, as if by calling the output stream's write method using out.write(buf, 0, count).

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LIMIT

public static final int DEFAULT_LIMIT

Default limit

See Also:

Constant Field Values

Constructor Detail

StreamBufferStore

public StreamBufferStore()

Creates a new StreamBufferStore instance that switches to file storage when DEFAULT_LIMIT bytes have been written.

StreamBufferStore

public StreamBufferStore(int limit)

Creates a new StreamBufferStore instance that switches to file storage when the specified number of bytes have been written.

Parameters:

limit - number of bytes when switching to file will occur

Method Detail

size

public int size()

Returns the current size of the buffer.

Returns:

the number of valid bytes in this buffer

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

Returns an InputStream for accessing the previously written bytes.

Returns:

an InputStream, never null

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.OutputStream

Throws:

java.io.IOException

flush

public void flush()
           throws java.io.IOException

Specified by:

flush in interface java.io.Flushable

Overrides:

flush in class java.io.OutputStream

Throws:

java.io.IOException

write

public void write(byte[] b)
           throws java.io.IOException

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

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

Overrides:

write in class java.io.OutputStream

Throws:

java.io.IOException

write

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

Specified by:

write in class java.io.OutputStream

Throws:

java.io.IOException

writeTo

public void writeTo(java.io.OutputStream outputStream)
             throws java.io.IOException

Writes the complete contents of this buffer to the specified output stream argument, as if by calling the output stream's write method using out.write(buf, 0, count).

Parameters:

outputStream - stream to write to, must not be null

Throws:

java.io.IOException - if an I/O error occurs

reset

public void reset()

Clears any data that exists in the buffer.