Modifier and Type	Class and Description
private static class	DefaultBufferAllocators.UncloseableBufferAllocator

Modifier and Type	Field and Description
private static final BufferAllocator	DEFAULT_OFF_HEAP_ALLOCATOR
private static final BufferAllocator	DEFAULT_ON_HEAP_ALLOCATOR
private static final BufferAllocator	DEFAULT_PREFERRED_ALLOCATOR
private static final InternalLogger	logger

Access	Constructor and Description
private	DefaultBufferAllocators()

Modifier and Type	Method and Description
public static BufferAllocator	Returns: The shared off-heap allocator. offHeapAllocator() Get the shared off-heap allocator.
public static BufferAllocator	Returns: The shared on-heap allocator. onHeapAllocator() Get the shared on-heap allocator.
public static BufferAllocator	Returns: The shared, generally preferred allocator. preferredAllocator() Get the preferred, shared allocator.

DEFAULT_OFF_HEAP_ALLOCATOR	back to summary
private static final BufferAllocator DEFAULT_OFF_HEAP_ALLOCATOR

DEFAULT_ON_HEAP_ALLOCATOR	back to summary
private static final BufferAllocator DEFAULT_ON_HEAP_ALLOCATOR

DEFAULT_PREFERRED_ALLOCATOR	back to summary
private static final BufferAllocator DEFAULT_PREFERRED_ALLOCATOR

logger	back to summary
private static final InternalLogger logger

DefaultBufferAllocators	back to summary
private DefaultBufferAllocators()

offHeapAllocator	back to summary
public static BufferAllocator offHeapAllocator() Get the shared off-heap allocator. This allocator always allocates off-heap buffers, and is either pooled, or unpooled. Returns:BufferAllocator The shared off-heap allocator.

onHeapAllocator	back to summary
public static BufferAllocator onHeapAllocator() Get the shared on-heap allocator. This allocator always allocates on-heap buffers, and is either pooled, or unpooled. Returns:BufferAllocator The shared on-heap allocator.

preferredAllocator	back to summary
public static BufferAllocator preferredAllocator() Get the preferred, shared allocator. This allocator is either on- or off-heap, and either pooling or unpooled, depending on the global configuration. Returns:BufferAllocator The shared, generally preferred allocator.

private final Class DefaultBufferAllocators.UncloseableBufferAllocator

Class Inheritance

extends Object
implements BufferAllocator

java.lang.Object
io.netty5.buffer.DefaultBufferAllocators.UncloseableBufferAllocator

All Implemented Interfaces

io.netty5.buffer.BufferAllocator, io.netty5.util.SafeCloseable, java.lang.AutoCloseable

Field Summary

Modifier and Type	Field and Description
private final BufferAllocator	delegate

Constructor Summary

Access	Constructor and Description
pack-priv	UncloseableBufferAllocator(BufferAllocator delegate)

Method Summary

Modifier and Type	Method and Description
public Buffer	allocate(int The size of `Buffer` to allocate. size) Implements io.netty5.buffer.BufferAllocator.allocate. Allocate a `Buffer` of the given size in bytes.
public void	close() Implements io.netty5.buffer.BufferAllocator.close. Close this allocator, freeing all of its internal resources.
public Supplier<Buffer>	constBufferSupplier(byte[] The byte contents of the buffers produced by the returned supplier. bytes) Implements io.netty5.buffer.BufferAllocator.constBufferSupplier. Create a supplier of "constant" Buffers from this allocator, that all have the given byte contents.
public AllocationType	getAllocationType() Implements io.netty5.buffer.BufferAllocator.getAllocationType. Get the `AllocationType` from this allocator.
public boolean	isPooling() Implements io.netty5.buffer.BufferAllocator.isPooling. Determine if this allocator is pooling and reusing its allocated memory.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

delegate	back to summary
private final BufferAllocator delegate

Constructor Detail

UncloseableBufferAllocator	back to summary
pack-priv UncloseableBufferAllocator(BufferAllocator delegate)

Method Detail

allocate back to summary

allocate	back to summary
public Buffer allocate(int size) Implements io.netty5.buffer.BufferAllocator.allocate. Doc from io.netty5.buffer.BufferAllocator.allocate. Allocate a `Buffer` of the given size in bytes. This method may throw an `OutOfMemoryError` if there is not enough free memory available to allocate a `Buffer` of the requested size. The buffer will use big endian byte order. Note unlike the JDK `ByteBuffer`s, Netty `Buffers` are not guaranteed to be zeroed when allocated. In other words, the memory of a newly allocated buffer may contain garbage data from prior allocations, and the memory is likewise not guaranteed to be erased when the buffer is closed. If the data is sensitive and needs to be overwritten when the buffer is closed, then the buffer should be allocated with the `SensitiveBufferAllocator`. Parameters size:int The size of `Buffer` to allocate. Returns:Buffer The newly allocated `Buffer`. Annotations @Override

public Buffer allocate(int size)

Implements io.netty5.buffer.BufferAllocator.allocate.

Doc from io.netty5.buffer.BufferAllocator.allocate.

Allocate a Buffer of the given size in bytes. This method may throw an OutOfMemoryError if there is not enough free memory available to allocate a Buffer of the requested size.

The buffer will use big endian byte order.

Note

unlike the JDK ByteBuffers, Netty Buffers are not guaranteed to be zeroed when allocated. In other words, the memory of a newly allocated buffer may contain garbage data from prior allocations, and the memory is likewise not guaranteed to be erased when the buffer is closed. If the data is sensitive and needs to be overwritten when the buffer is closed, then the buffer should be allocated with the SensitiveBufferAllocator.

Parameters

size:int: The size of Buffer to allocate.

Returns:Buffer

The newly allocated Buffer.

Annotations

@Override

close back to summary

close	back to summary
public void close() Implements io.netty5.buffer.BufferAllocator.close. Doc from io.netty5.buffer.BufferAllocator.close. Close this allocator, freeing all of its internal resources. Existing (currently in-use) allocated buffers will not be impacted by calling this method. If this is a pooling or caching allocator, then existing buffers will be immediately freed when they are closed, instead of being pooled or cached. The allocator can no longer be used to allocate more buffers after calling this method. Attempting to allocate from a closed allocator will cause `IllegalStateException`s to be thrown. Annotations @Override Exceptions UnsupportedOperationException: Close is not supported on this allocator.

public void close()

Implements io.netty5.buffer.BufferAllocator.close.

Doc from io.netty5.buffer.BufferAllocator.close.

Close this allocator, freeing all of its internal resources.

Existing (currently in-use) allocated buffers will not be impacted by calling this method. If this is a pooling or caching allocator, then existing buffers will be immediately freed when they are closed, instead of being pooled or cached.

The allocator can no longer be used to allocate more buffers after calling this method. Attempting to allocate from a closed allocator will cause IllegalStateExceptions to be thrown.

Annotations

@Override

Exceptions

UnsupportedOperationException:: Close is not supported on this allocator.

constBufferSupplier back to summary

constBufferSupplier	back to summary
public Supplier<Buffer> constBufferSupplier(byte[] bytes) Implements io.netty5.buffer.BufferAllocator.constBufferSupplier. Doc from io.netty5.buffer.BufferAllocator.constBufferSupplier. Create a supplier of "constant" Buffers from this allocator, that all have the given byte contents. The buffer has the same capacity as the byte array length, and its write offset is placed at the end, and its read offset is at the beginning, such that the entire buffer contents are readable. The buffers produced by the supplier will each have their own independent life-cycle, and closing them will make them inaccessible, just like normally allocated buffers. The buffers produced are "constants", in the sense that they are read-only. It can generally be expected, but is not guaranteed, that the returned supplier is more resource efficient than allocating and copying memory with other available APIs. In such optimised implementations, the underlying memory baking the buffers will be shared among all the buffers produced by the supplier. The primary use case for this API, is when you need to repeatedly produce buffers with the same contents, and you perhaps wish to keep a `static final` field with these contents. The supplier-based API enforces that each usage get their own distinct buffer instance. Each of these instances cannot interfere with each other, so bugs like closing, or modifying the contents, of a shared buffer cannot occur. Parameters bytes:byte[] The byte contents of the buffers produced by the returned supplier. Returns:Supplier<Buffer> A supplier of read-only buffers with the given contents. Annotations @Override

public Supplier<Buffer> constBufferSupplier(byte[] bytes)

Implements io.netty5.buffer.BufferAllocator.constBufferSupplier.

Doc from io.netty5.buffer.BufferAllocator.constBufferSupplier.

Create a supplier of "constant" Buffers from this allocator, that all have the given byte contents. The buffer has the same capacity as the byte array length, and its write offset is placed at the end, and its read offset is at the beginning, such that the entire buffer contents are readable.

The buffers produced by the supplier will each have their own independent life-cycle, and closing them will make them inaccessible, just like normally allocated buffers.

The buffers produced are "constants", in the sense that they are read-only.

It can generally be expected, but is not guaranteed, that the returned supplier is more resource efficient than allocating and copying memory with other available APIs. In such optimised implementations, the underlying memory baking the buffers will be shared among all the buffers produced by the supplier.

The primary use case for this API, is when you need to repeatedly produce buffers with the same contents, and you perhaps wish to keep a static final field with these contents. The supplier-based API enforces that each usage get their own distinct buffer instance. Each of these instances cannot interfere with each other, so bugs like closing, or modifying the contents, of a shared buffer cannot occur.

Parameters

bytes:byte[]: The byte contents of the buffers produced by the returned supplier.

Returns:Supplier<Buffer>

A supplier of read-only buffers with the given contents.

Annotations

@Override

getAllocationType back to summary

getAllocationType	back to summary
public AllocationType getAllocationType() Implements io.netty5.buffer.BufferAllocator.getAllocationType. Doc from io.netty5.buffer.BufferAllocator.getAllocationType. Get the `AllocationType` from this allocator. This would typically be one of the `StandardAllocationTypes`. Returns:AllocationType The type of allocations performed by this allocator. Annotations @Override

public AllocationType getAllocationType()

Implements io.netty5.buffer.BufferAllocator.getAllocationType.

Doc from io.netty5.buffer.BufferAllocator.getAllocationType.

Get the AllocationType from this allocator. This would typically be one of the StandardAllocationTypes.

Returns:AllocationType

The type of allocations performed by this allocator.

Annotations

@Override

isPooling back to summary

isPooling	back to summary
public boolean isPooling() Implements io.netty5.buffer.BufferAllocator.isPooling. Doc from io.netty5.buffer.BufferAllocator.isPooling. Determine if this allocator is pooling and reusing its allocated memory. Returns:boolean `true` if this allocator is pooling and reusing its memory, `false` otherwise. Annotations @Override

public boolean isPooling()

Implements io.netty5.buffer.BufferAllocator.isPooling.

Doc from io.netty5.buffer.BufferAllocator.isPooling.

Determine if this allocator is pooling and reusing its allocated memory.

Returns:boolean

true if this allocator is pooling and reusing its memory, false otherwise.

Annotations

@Override

public final Class DefaultBufferAllocators

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class DefaultBufferAllocators.UncloseableBufferAllocator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail