Interface FramePriority<C extends AbstractFramedChannel<C,R,S>,R extends AbstractFramedStreamSourceChannel<C,R,S>,S extends AbstractFramedStreamSinkChannel<C,R,S>>
-
- All Known Implementing Classes:
WebSocketFramePriority
public interface FramePriority<C extends AbstractFramedChannel<C,R,S>,R extends AbstractFramedStreamSourceChannel<C,R,S>,S extends AbstractFramedStreamSinkChannel<C,R,S>>
Interface that can be used to determine where to insert a given frame into the pending frame queue.- Author:
- Stuart Douglas
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
frameAdded(S addedFrame, java.util.List<S> pendingFrames, java.util.Deque<S> holdFrames)
Invoked when a new frame is successfully added to the pending frames queue.boolean
insertFrame(S newFrame, java.util.List<S> pendingFrames)
Inserts the new frame at the correct location in the pending frame list.
-
-
-
Method Detail
-
insertFrame
boolean insertFrame(S newFrame, java.util.List<S> pendingFrames)
Inserts the new frame at the correct location in the pending frame list. Note that this must never insert a frame at the very start of the senders list, as this frame has already been activated. This method should return true if the frame was successfully inserted into the pending frame list, if it returns false the frame must not be inserted and will be added to the held frames list instead. Frames held in the held frames list are frames that are not yet ready to be included in the pending frame list, generally because other frames have to be written first. Note that if this method returns true without adding the frame the frame will be dropped.- Parameters:
newFrame
- The new frame to insert into the pending frame listpendingFrames
- The pending frame list- Returns:
- true if the frame can be inserted into the pending frame list
-
frameAdded
void frameAdded(S addedFrame, java.util.List<S> pendingFrames, java.util.Deque<S> holdFrames)
Invoked when a new frame is successfully added to the pending frames queue. If frames in the held frame queue are now eligible to be sent they can be added to the pending frames queue. Note that if the protocol has explicitly asked for the held frames to be recalculated then the added frame may be null.- Parameters:
addedFrame
- The newly added framependingFrames
- The pending frame queueholdFrames
- The held frame queue
-
-