org.apache.commons.vfs2.util

Class MonitorOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.BufferedOutputStream

org.apache.commons.vfs2.util.MonitorOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class MonitorOutputStream
extends BufferedOutputStream

An OutputStream that provides buffering and end-of-stream monitoring.

Field Summary

Fields inherited from class java.io.BufferedOutputStream

buf, count

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

Constructors

Constructor and Description
MonitorOutputStream(OutputStream out) Constructs a MonitorOutputStream from the passed OutputStream
MonitorOutputStream(OutputStream out, int bufferSize) Constructs a MonitorOutputStream from the passed OutputStream and with the specified buffer size

Method Summary

Modifier and Type	Method and Description
protected void	assertOpen() Check if file is still open.
void	close() Closes this output stream.
void	flush()
protected void	onClose() Called after this stream is closed.
void	write(byte[] b)
void	write(byte[] b, int off, int len)
void	write(int b)

Methods inherited from class java.lang.Object

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

Constructor Detail

MonitorOutputStream

public MonitorOutputStream(OutputStream out)

Constructs a MonitorOutputStream from the passed OutputStream

Parameters:

out - The output stream to wrap.

MonitorOutputStream

public MonitorOutputStream(OutputStream out,
                           int bufferSize)

Constructs a MonitorOutputStream from the passed OutputStream and with the specified buffer size

Parameters:

out - The output stream to wrap.

bufferSize - The buffer size to use.

Since:

2.4

Method Detail

close

public void close()
           throws IOException

Closes this output stream.

This makes sure the buffers are flushed, close the output stream and it will call onClose() and re-throw last exception from any of the three.

This does nothing if the stream is closed already.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FilterOutputStream

Throws:

IOException - if an IO error occurs.

write

public void write(int b)
           throws IOException

Overrides:

write in class BufferedOutputStream

Parameters:

b - The character to write.

Throws:

IOException - if an error occurs.

Since:

2.0

write

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

Overrides:

write in class BufferedOutputStream

Parameters:

b - The byte array.

off - The offset into the array.

len - The number of bytes to write.

Throws:

IOException - if an error occurs.

Since:

2.0

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Overrides:

flush in class BufferedOutputStream

Throws:

IOException - if an error occurs.

Since:

2.0

write

public void write(byte[] b)
           throws IOException

Overrides:

write in class FilterOutputStream

Parameters:

b - The byte array.

Throws:

IOException - if an error occurs.

Since:

2.0

assertOpen

protected void assertOpen()
                   throws FileSystemException

Check if file is still open.

This is a workaround for an oddity with Java's BufferedOutputStream where you can write to even if the stream has been closed.

Throws:

FileSystemException - if already closed.

Since:

2.0

onClose

protected void onClose()
                throws IOException

Called after this stream is closed.

This implementation does nothing.

Throws:

IOException - if an error occurs.