Module io.netty5.transport

Package io.netty5.channel

Class CoalescingBufferQueue

java.lang.Object

io.netty5.channel.AbstractCoalescingBufferQueue

io.netty5.channel.CoalescingBufferQueue

public final class CoalescingBufferQueue
extends AbstractCoalescingBufferQueue

A FIFO queue of bytes where producers add bytes by repeatedly adding Buffer and consumers take bytes in arbitrary lengths. This allows producers to add lots of small buffers and the consumer to take all the bytes out in a single buffer. Conversely, the producer may add larger buffers and the consumer could take the bytes in many small buffers.

Bytes are added and removed with promises. If the last byte of a buffer added with a promise is removed then that promise will complete when the promise passed to remove(int, io.netty5.util.concurrent.Promise<java.lang.Void>) completes.

This functionality is useful for aggregating or partitioning writes into fixed size buffers for framing protocols such as HTTP2.

Constructor Summary

Constructors

Constructor	Description
CoalescingBufferQueue(Channel channel)
CoalescingBufferQueue(Channel channel, int initSize)

Method Summary

Modifier and Type	Method	Description
protected io.netty5.buffer.Buffer	compose(io.netty5.buffer.BufferAllocator alloc, io.netty5.buffer.Buffer cumulation, io.netty5.buffer.Buffer next)	Calculate the result of current + next.
void	releaseAndFailAll(Throwable cause)	Release all buffers in the queue and complete all listeners and promises.
io.netty5.buffer.Buffer	remove(int bytes, io.netty5.util.concurrent.Promise<Void> aggregatePromise)	Remove a Buffer from the queue with the specified number of bytes.
protected io.netty5.buffer.Buffer	removeEmptyValue()	The value to return when AbstractCoalescingBufferQueue.remove(BufferAllocator, int, Promise) is called but the queue is empty.

Methods inherited from class io.netty5.channel.AbstractCoalescingBufferQueue

add, add, add, addFirst, composeFirst, composeIntoComposite, copyAndCompose, copyTo, isEmpty, readableBytes, releaseAndFailAll, remove, removeFirst, size, toString, writeAndRemoveAll

Methods inherited from class java.lang.Object

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

Constructor Detail

CoalescingBufferQueue

public CoalescingBufferQueue(Channel channel)

CoalescingBufferQueue

public CoalescingBufferQueue(Channel channel,
                             int initSize)

Method Detail

remove

public io.netty5.buffer.Buffer remove(int bytes,
                                      io.netty5.util.concurrent.Promise<Void> aggregatePromise)

Remove a Buffer from the queue with the specified number of bytes. Any added buffer whose bytes are fully consumed during removal will have it's promise completed when the passed aggregate Promise completes.

Parameters:

bytes - the maximum number of readable bytes in the returned Buffer, if bytes is greater than AbstractCoalescingBufferQueue.readableBytes() then a buffer of length AbstractCoalescingBufferQueue.readableBytes() is returned.

aggregatePromise - used to aggregate the promises and listeners for the constituent buffers.

Returns:

a Buffer composed of the enqueued buffers.

releaseAndFailAll

public void releaseAndFailAll(Throwable cause)

Release all buffers in the queue and complete all listeners and promises.

compose

protected io.netty5.buffer.Buffer compose(io.netty5.buffer.BufferAllocator alloc,
                                          io.netty5.buffer.Buffer cumulation,
                                          io.netty5.buffer.Buffer next)

Description copied from class: AbstractCoalescingBufferQueue

Calculate the result of current + next.

Specified by:

compose in class AbstractCoalescingBufferQueue

removeEmptyValue

protected io.netty5.buffer.Buffer removeEmptyValue()

Description copied from class: AbstractCoalescingBufferQueue

The value to return when AbstractCoalescingBufferQueue.remove(BufferAllocator, int, Promise) is called but the queue is empty.

Specified by:

removeEmptyValue in class AbstractCoalescingBufferQueue

Returns:

the Buffer which represents an empty queue.