@ManagedObject public class BufferingFlowControlStrategy extends AbstractFlowControlStrategy
A flow control strategy that accumulates updates and emits window control frames when the accumulated value reaches a threshold.
The sender flow control window is represented in the receiver as two buckets: a bigger bucket, initially full, that is drained when data is received, and a smaller bucket, initially empty, that is filled when data is consumed. Only the smaller bucket can refill the bigger bucket.
The smaller bucket is defined as a fraction of the bigger bucket.
For a more visual representation, see the rocking bamboo fountain.
The algorithm works in this way.
The initial bigger bucket (BB) capacity is 100, and let's imagine the smaller bucket (SB) being 40% of the bigger bucket: 40.
The receiver receives a data frame of 60, so now BB=40; the data frame is passed to the application that consumes 25, so now SB=25. Since SB is not full, no window control frames are emitted.
The application consumes other 20, so now SB=45. Since SB is full, its 45 are transferred to BB, which is now BB=85, and a window control frame is sent with delta=45.
The application consumes the remaining 15, so now SB=15, and no window control frame is emitted.
FlowControlStrategy.Factory
LOG
DEFAULT_WINDOW_SIZE
Constructor and Description |
---|
BufferingFlowControlStrategy(float bufferRatio) |
BufferingFlowControlStrategy(int initialStreamSendWindow,
float bufferRatio) |
Modifier and Type | Method and Description |
---|---|
float |
getBufferRatio() |
void |
onDataConsumed(ISession session,
IStream stream,
int length) |
void |
onStreamCreated(IStream stream) |
void |
onStreamDestroyed(IStream stream) |
void |
setBufferRatio(float bufferRatio) |
String |
toString() |
void |
windowUpdate(ISession session,
IStream stream,
WindowUpdateFrame frame) |
dump, dump, getInitialStreamRecvWindow, getInitialStreamSendWindow, getSessionStallTime, getStreamsStallTime, onDataReceived, onDataSending, onDataSent, onSessionStalled, onSessionUnstalled, onStreamStalled, onStreamUnstalled, onWindowUpdate, reset, updateInitialStreamWindow
public BufferingFlowControlStrategy(float bufferRatio)
public BufferingFlowControlStrategy(int initialStreamSendWindow, float bufferRatio)
@ManagedAttribute(value="The ratio between the receive buffer and the consume buffer") public float getBufferRatio()
public void setBufferRatio(float bufferRatio)
public void onStreamCreated(IStream stream)
onStreamCreated
in interface FlowControlStrategy
onStreamCreated
in class AbstractFlowControlStrategy
public void onStreamDestroyed(IStream stream)
onStreamDestroyed
in interface FlowControlStrategy
onStreamDestroyed
in class AbstractFlowControlStrategy
public void windowUpdate(ISession session, IStream stream, WindowUpdateFrame frame)
windowUpdate
in interface FlowControlStrategy
windowUpdate
in class AbstractFlowControlStrategy
Copyright © 1995-2016 Webtide. All Rights Reserved.