com.google.android.exoplayer.upstream

Class DefaultAllocator

java.lang.Object

com.google.android.exoplayer.upstream.DefaultAllocator

All Implemented Interfaces:

Allocator

public final class DefaultAllocator
extends Object
implements Allocator

Default implementation of Allocator.

Constructor Summary

Constructors

Constructor and Description
DefaultAllocator(int individualAllocationSize) Constructs an initially empty pool.
DefaultAllocator(int individualAllocationSize, int initialAllocationCount) Constructs a pool with some Allocations created up front.

Method Summary

Modifier and Type	Method and Description
Allocation	allocate() Obtain an Allocation.
void	blockWhileTotalBytesAllocatedExceeds(int limit) Blocks execution until the number of bytes allocated is not greater than the limit, or the thread is interrupted.
int	getIndividualAllocationLength() Returns the length of each individual Allocation.
int	getTotalBytesAllocated() Returns the total number of bytes currently allocated.
void	release(Allocation allocation) Return an Allocation.
void	release(Allocation[] allocations) Return an array of Allocations.
void	trim(int targetSize) Hints to the Allocator that it should make a best effort to release any memory that it has allocated, beyond the specified target number of bytes.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultAllocator

public DefaultAllocator(int individualAllocationSize)

Constructs an initially empty pool.

Parameters:

individualAllocationSize - The length of each individual allocation.

DefaultAllocator

public DefaultAllocator(int individualAllocationSize,
                        int initialAllocationCount)

Constructs a pool with some Allocations created up front.

Note: Initial Allocations will never be discarded by trim(int).

Parameters:

individualAllocationSize - The length of each individual allocation.

initialAllocationCount - The number of allocations to create up front.

Method Detail

allocate

public Allocation allocate()

Description copied from interface: Allocator

Obtain an Allocation.

When the caller has finished with the Allocation, it should be returned by calling Allocator.release(Allocation).

Specified by:

allocate in interface Allocator

Returns:

The Allocation.

release

public void release(Allocation allocation)

Description copied from interface: Allocator

Return an Allocation.

Specified by:

release in interface Allocator

Parameters:

allocation - The Allocation being returned.

release

public void release(Allocation[] allocations)

Description copied from interface: Allocator

Return an array of Allocations.

Specified by:

release in interface Allocator

Parameters:

allocations - The array of Allocations being returned.

trim

public void trim(int targetSize)

Description copied from interface: Allocator

Hints to the Allocator that it should make a best effort to release any memory that it has allocated, beyond the specified target number of bytes.

Specified by:

trim in interface Allocator

Parameters:

targetSize - The target size in bytes.

getTotalBytesAllocated

public int getTotalBytesAllocated()

Description copied from interface: Allocator

Returns the total number of bytes currently allocated.

Specified by:

getTotalBytesAllocated in interface Allocator

blockWhileTotalBytesAllocatedExceeds

public void blockWhileTotalBytesAllocatedExceeds(int limit)
                                          throws InterruptedException

Description copied from interface: Allocator

Blocks execution until the number of bytes allocated is not greater than the limit, or the thread is interrupted.

Specified by:

blockWhileTotalBytesAllocatedExceeds in interface Allocator

Parameters:

limit - The limit in bytes.

Throws:

InterruptedException - If the thread is interrupted.

getIndividualAllocationLength

public int getIndividualAllocationLength()

Description copied from interface: Allocator

Returns the length of each individual Allocation.

Specified by:

getIndividualAllocationLength in interface Allocator