org.apache.hadoop.hbase.io.hadoopbackport

Class ThrottledInputStream

java.lang.Object

java.io.InputStream

org.apache.hadoop.hbase.io.hadoopbackport.ThrottledInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

@InterfaceAudience.Private
public class ThrottledInputStream
extends java.io.InputStream

The ThrottleInputStream provides bandwidth throttling on a specified InputStream. It is implemented as a wrapper on top of another InputStream instance. The throttling works by examining the number of bytes read from the underlying InputStream from the beginning, and sleep()ing for a time interval if the byte-transfer is found exceed the specified tolerable maximum. (Thus, while the read-rate might exceed the maximum for a given short interval, the average tends towards the specified maximum, overall.)

Constructor Summary

Constructors

Constructor and Description
ThrottledInputStream(java.io.InputStream rawStream)
ThrottledInputStream(java.io.InputStream rawStream, long maxBytesPerSec)

Method Summary

Modifier and Type	Method and Description
void	close()
long	getBytesPerSec() Getter for the read-rate from this stream, since creation.
long	getTotalBytesRead() Getter for the number of bytes read from this stream, since creation.
long	getTotalSleepTime() Getter the total time spent in sleep.
int	read()
int	read(byte[] b)
int	read(byte[] b, int off, int len)
int	read(long position, byte[] buffer, int offset, int length) Read bytes starting from the specified position.
java.lang.String	toString()

Methods inherited from class java.io.InputStream

available, mark, markSupported, reset, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

ThrottledInputStream

public ThrottledInputStream(java.io.InputStream rawStream)

ThrottledInputStream

public ThrottledInputStream(java.io.InputStream rawStream,
                            long maxBytesPerSec)

Method Detail

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException

read

public int read()
         throws java.io.IOException

Specified by:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

read

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

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(long position,
                byte[] buffer,
                int offset,
                int length)
         throws java.io.IOException

Read bytes starting from the specified position. This requires rawStream is an instance of PositionedReadable.

Parameters:

position -

buffer -

offset -

length -

Returns:

the number of bytes read

Throws:

java.io.IOException

getTotalBytesRead

public long getTotalBytesRead()

Getter for the number of bytes read from this stream, since creation.

Returns:

The number of bytes.

getBytesPerSec

public long getBytesPerSec()

Getter for the read-rate from this stream, since creation. Calculated as bytesRead/elapsedTimeSinceStart.

Returns:

Read rate, in bytes/sec.

getTotalSleepTime

public long getTotalSleepTime()

Getter the total time spent in sleep.

Returns:

Number of milliseconds spent in sleep.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object