com.fasterxml.jackson.core.util

Class JsonRecyclerPools

java.lang.Object

com.fasterxml.jackson.core.util.JsonRecyclerPools

public final class JsonRecyclerPools
extends Object

Set of RecyclerPool implementations to be used by the default JSON-backed JsonFactory for recycling BufferRecycler containers.

Since:

2.16

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JsonRecyclerPools.BoundedPool RecyclerPool implementation that uses a bounded queue (ArrayBlockingQueue for recycling instances.
static class	JsonRecyclerPools.ConcurrentDequePool RecyclerPool implementation that uses ConcurrentLinkedDeque for recycling instances.
static class	JsonRecyclerPools.LockFreePool Deprecated. Since 2.18: use other implementations instead
static class	JsonRecyclerPools.NonRecyclingPool Dummy RecyclerPool implementation that does not recycle anything but simply creates new instances when asked to acquire items.
static class	JsonRecyclerPools.ThreadLocalPool ThreadLocal-based RecyclerPool implementation used for recycling BufferRecycler instances: see RecyclerPool.ThreadLocalPoolBase for full explanation of functioning.

Constructor Summary

Constructors

Constructor and Description
JsonRecyclerPools()

Method Summary

Modifier and Type	Method and Description
static RecyclerPool<BufferRecycler>	defaultPool() Method to call to get the default recycler pool instance: as of Jackson 2.18 this is same as calling threadLocalPool(): Jackson 2.17.0 instead had this call newLockFreePool() but this was reverted due to problems reported.
static RecyclerPool<BufferRecycler>	newBoundedPool(int size) Accessor for constructing a new, non-shared JsonRecyclerPools.BoundedPool instance.
static RecyclerPool<BufferRecycler>	newConcurrentDequePool() Accessor for constructing a new, non-shared JsonRecyclerPools.ConcurrentDequePool instance.
static RecyclerPool<BufferRecycler>	newLockFreePool() Deprecated. Since 2.18: use one of other implementations instead; see JsonRecyclerPools.LockFreePool Javadocs for details
static RecyclerPool<BufferRecycler>	nonRecyclingPool() Accessor for getting the shared/global JsonRecyclerPools.NonRecyclingPool instance (due to design only one instance ever needed)
static RecyclerPool<BufferRecycler>	sharedBoundedPool() Accessor for getting the shared/global JsonRecyclerPools.BoundedPool instance.
static RecyclerPool<BufferRecycler>	sharedConcurrentDequePool() Accessor for getting the shared/global JsonRecyclerPools.ConcurrentDequePool instance.
static RecyclerPool<BufferRecycler>	sharedLockFreePool() Deprecated. Since 2.18: use one of other implementations instead; see JsonRecyclerPools.LockFreePool Javadocs for details
static RecyclerPool<BufferRecycler>	threadLocalPool() Accessor for getting the shared/global JsonRecyclerPools.ThreadLocalPool instance (due to design only one instance ever needed)

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonRecyclerPools

public JsonRecyclerPools()

Method Detail

defaultPool

public static RecyclerPool<BufferRecycler> defaultPool()

Method to call to get the default recycler pool instance: as of Jackson 2.18 this is same as calling threadLocalPool(): Jackson 2.17.0 instead had this call newLockFreePool() but this was reverted due to problems reported.

Default pool will likely be changed in Jackson 3.0 to something else.

Returns:

the default RecyclerPool implementation to use if no specific implementation desired.

threadLocalPool

public static RecyclerPool<BufferRecycler> threadLocalPool()

Accessor for getting the shared/global JsonRecyclerPools.ThreadLocalPool instance (due to design only one instance ever needed)

Returns:

Globally shared instance of JsonRecyclerPools.ThreadLocalPool

nonRecyclingPool

public static RecyclerPool<BufferRecycler> nonRecyclingPool()

Accessor for getting the shared/global JsonRecyclerPools.NonRecyclingPool instance (due to design only one instance ever needed)

Returns:

Globally shared instance of JsonRecyclerPools.NonRecyclingPool.

sharedConcurrentDequePool

public static RecyclerPool<BufferRecycler> sharedConcurrentDequePool()

Accessor for getting the shared/global JsonRecyclerPools.ConcurrentDequePool instance.

Returns:

Globally shared instance of JsonRecyclerPools.NonRecyclingPool.

newConcurrentDequePool

public static RecyclerPool<BufferRecycler> newConcurrentDequePool()

Accessor for constructing a new, non-shared JsonRecyclerPools.ConcurrentDequePool instance.

Returns:

Globally shared instance of JsonRecyclerPools.NonRecyclingPool.

sharedLockFreePool

@Deprecated
public static RecyclerPool<BufferRecycler> sharedLockFreePool()

Deprecated. Since 2.18: use one of other implementations instead; see JsonRecyclerPools.LockFreePool Javadocs for details

Accessor for getting the shared/global JsonRecyclerPools.LockFreePool instance.

Returns:

Globally shared instance of JsonRecyclerPools.LockFreePool.

newLockFreePool

@Deprecated
public static RecyclerPool<BufferRecycler> newLockFreePool()

Deprecated. Since 2.18: use one of other implementations instead; see JsonRecyclerPools.LockFreePool Javadocs for details

Accessor for constructing a new, non-shared JsonRecyclerPools.LockFreePool instance.

Returns:

Globally shared instance of JsonRecyclerPools.LockFreePool.

sharedBoundedPool

public static RecyclerPool<BufferRecycler> sharedBoundedPool()

Accessor for getting the shared/global JsonRecyclerPools.BoundedPool instance.

Returns:

Globally shared instance of JsonRecyclerPools.BoundedPool.

newBoundedPool

public static RecyclerPool<BufferRecycler> newBoundedPool(int size)

Accessor for constructing a new, non-shared JsonRecyclerPools.BoundedPool instance.

Parameters:

size - Maximum number of values to pool

Returns:

Globally shared instance of JsonRecyclerPools.BoundedPool.