bayou.bytes

Interface ThrottledByteSource.Curve

Enclosing class:

ThrottledByteSource

public static interface ThrottledByteSource.Curve

The curve used in ThrottledByteSource.

The throttling is based on a curve b(t). At time t, the total number of bytes served should not exceed b(t).

The unit of t is milli-second. t is relative to the 1st read, i.e. t=0 on the first read() call.

This interface uses long type for b and t. Both the caller and the implementer should be careful with arithmetic precisions.

Method Summary

Abstract Methods
long	b(long t) The max total number of bytes that can be served at time t (ms).
long	t(long b) The inverse function of b(t).
Static Method
ThrottledByteSource.Curve	linear(long b0, long bytesPerSecond) Create a linear curve.

Method Detail

b

long b(long t)

The max total number of bytes that can be served at time t (ms).

Required: if t1<=t2, then b(t1)<=b(t2)

t

long t(long b)

The inverse function of b(t).

Required: t(b(x)) = x (approximately)

linear

static ThrottledByteSource.Curve linear(long b0,
                                        long bytesPerSecond)

Create a linear curve.

The curve will be b(t) = b0 + t * bytesPerSecond / 1000

CAUTION: the unit of `bytesPerSecond` is byte/second, not milli-second.