org.apache.arrow.memory

インタフェース AllocationListener

public interface AllocationListener

An allocation listener being notified for allocation/deallocation

It might be called from multiple threads if the allocator hierarchy shares a listener, in which case, the provider should take care of making the implementation thread-safe.

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static AllocationListener	NOOP

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	onAllocation(long size) Called each time a new buffer is allocated
void	onChildAdded(BufferAllocator parentAllocator, BufferAllocator childAllocator) Called immediately after a child allocator was added to the parent allocator
void	onChildRemoved(BufferAllocator parentAllocator, BufferAllocator childAllocator) Called immediately after a child allocator was removed from the parent allocator
boolean	onFailedAllocation(long size, AllocationOutcome outcome) Called whenever an allocation failed, giving the caller a chance to create some space in the allocator (either by freeing some resource, or by changing the limit), and, if successful, allowing the allocator to retry the allocation.

フィールドの詳細

NOOP

static final AllocationListener NOOP

メソッドの詳細

onAllocation

void onAllocation(long size)

Called each time a new buffer is allocated

パラメータ:

size - the buffer size being allocated

onFailedAllocation

boolean onFailedAllocation(long size,
                           AllocationOutcome outcome)

Called whenever an allocation failed, giving the caller a chance to create some space in the allocator (either by freeing some resource, or by changing the limit), and, if successful, allowing the allocator to retry the allocation.

パラメータ:

size - the buffer size that was being allocated

outcome - the outcome of the failed allocation. Carries information of what failed

戻り値:

true, if the allocation can be retried; false if the allocation should fail

onChildAdded

void onChildAdded(BufferAllocator parentAllocator,
                  BufferAllocator childAllocator)

Called immediately after a child allocator was added to the parent allocator

パラメータ:

parentAllocator - The parent allocator to which a child was added

childAllocator - The child allocator that was just added

onChildRemoved

void onChildRemoved(BufferAllocator parentAllocator,
                    BufferAllocator childAllocator)

Called immediately after a child allocator was removed from the parent allocator

パラメータ:

parentAllocator - The parent allocator from which a child was removed

childAllocator - The child allocator that was just removed