com.gc.iotools.stream.os
Class StatsOutputStream

java.lang.Object
  java.io.OutputStream
      com.gc.iotools.stream.os.StatsOutputStream

All Implemented Interfaces:

Closeable, Flushable

Direct Known Subclasses:

SizeRecorderOutputStream

public class StatsOutputStream
extends OutputStream

Gather some statistics on the OutputStream passed in the constructor.

It can be used to read:

• The size of the data written to the underlying stream.
• The time spent writing the bytes.
• The bandwidth of the underlying stream.

Full statistics are available after the stream has been fully processed (by other parts of the application), or after invoking the method close() while partial statistics are available on the fly.

Since:

1.2.1

Author:

dvd.smnt

Constructor Summary

StatsOutputStream(OutputStream destination)
Creates a new SizeRecorderOutputStream with the given destination stream.

Method Summary

void	close()
void	flush()
String	getBitRateString() Returns the writing bit rate formatted with a convenient unit.
long	getSize() Returns the number of bytes written until now.
long	getTime(TimeUnit tu) Returns the time spent until now waiting for the internal stream to write the data.
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

StatsOutputStream

public StatsOutputStream(OutputStream destination)

Creates a new SizeRecorderOutputStream with the given destination stream.

Parameters:

destination - Destination stream where data are written.

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream

Throws:

IOException

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException

getSize

public long getSize()

Returns the number of bytes written until now.

Returns:

return the number of bytes written until now.

getBitRateString

public String getBitRateString()

Returns the writing bit rate formatted with a convenient unit.

Returns:

The bitRate of the stream.

Since:

1.2.2

getTime

public long getTime(TimeUnit tu)

Returns the time spent until now waiting for the internal stream to write the data.

Parameters:

tu - Unit to measure the time.

Returns:

time spent in waiting.

write

public void write(byte[] b)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

write

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

Overrides:

write in class OutputStream

Throws:

IOException

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException