Nested and Inner Type Summary

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

Constructor Summary

Access	Constructor and Description
public	JsonRecyclerPools()

Method Summary

Modifier and Type	Method and Description
public static RecyclerPool<BufferRecycler>	Returns: the default `RecyclerPool` implementation to use if no specific implementation desired. 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.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `BoundedPool`. newBoundedPool(int Maximum number of values to pool size) Accessor for constructing a new, non-shared `BoundedPool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `NonRecyclingPool`. newConcurrentDequePool() Accessor for constructing a new, non-shared `ConcurrentDequePool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `LockFreePool`. newLockFreePool() Deprecated Since 2.18: use one of other implementations instead; see `LockFreePool` Javadocs for details Accessor for constructing a new, non-shared `LockFreePool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `NonRecyclingPool`. nonRecyclingPool() Accessor for getting the shared/global `NonRecyclingPool` instance (due to design only one instance ever needed)
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `BoundedPool`. sharedBoundedPool() Accessor for getting the shared/global `BoundedPool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `NonRecyclingPool`. sharedConcurrentDequePool() Accessor for getting the shared/global `ConcurrentDequePool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `LockFreePool`. sharedLockFreePool() Deprecated Since 2.18: use one of other implementations instead; see `LockFreePool` Javadocs for details Accessor for getting the shared/global `LockFreePool` instance.
public static RecyclerPool<BufferRecycler>	Returns: Globally shared instance of `ThreadLocalPool` threadLocalPool() Accessor for getting the shared/global `ThreadLocalPool` instance (due to design only one instance ever needed)

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

Constructor Detail

JsonRecyclerPools	back to summary
public JsonRecyclerPools()

Method Detail

defaultPool back to summary

defaultPool	back to summary
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:RecyclerPool<BufferRecycler> the default `RecyclerPool` implementation to use if no specific implementation desired.

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:RecyclerPool<BufferRecycler>: the default RecyclerPool implementation to use if no specific implementation desired.

newBoundedPool back to summary

newBoundedPool	back to summary
public static RecyclerPool<BufferRecycler> newBoundedPool(int size) Accessor for constructing a new, non-shared `BoundedPool` instance. Parameters size:int Maximum number of values to pool Returns:RecyclerPool<BufferRecycler> Globally shared instance of `BoundedPool`.

public static RecyclerPool<BufferRecycler> newBoundedPool(int size)

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

Parameters

size:int: Maximum number of values to pool

Returns:RecyclerPool<BufferRecycler>

Globally shared instance of BoundedPool.

newConcurrentDequePool back to summary

newConcurrentDequePool	back to summary
public static RecyclerPool<BufferRecycler> newConcurrentDequePool() Accessor for constructing a new, non-shared `ConcurrentDequePool` instance. Returns:RecyclerPool<BufferRecycler> Globally shared instance of `NonRecyclingPool`.

public static RecyclerPool<BufferRecycler> newConcurrentDequePool()

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

Returns:RecyclerPool<BufferRecycler>: Globally shared instance of NonRecyclingPool.

newLockFreePool back to summary

newLockFreePool	back to summary
public static RecyclerPool<BufferRecycler> newLockFreePool() Deprecated Since 2.18: use one of other implementations instead; see `LockFreePool` Javadocs for details Accessor for constructing a new, non-shared `LockFreePool` instance. Returns:RecyclerPool<BufferRecycler> Globally shared instance of `LockFreePool`. Annotations @Deprecated

public static RecyclerPool<BufferRecycler> newLockFreePool()

Deprecated

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

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

Returns:RecyclerPool<BufferRecycler>

Globally shared instance of LockFreePool.

Annotations

@Deprecated

nonRecyclingPool back to summary

nonRecyclingPool	back to summary
public static RecyclerPool<BufferRecycler> nonRecyclingPool() Accessor for getting the shared/global `NonRecyclingPool` instance (due to design only one instance ever needed) Returns:RecyclerPool<BufferRecycler> Globally shared instance of `NonRecyclingPool`.

public static RecyclerPool<BufferRecycler> nonRecyclingPool()

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

Returns:RecyclerPool<BufferRecycler>: Globally shared instance of NonRecyclingPool.

sharedBoundedPool back to summary

sharedBoundedPool	back to summary
public static RecyclerPool<BufferRecycler> sharedBoundedPool() Accessor for getting the shared/global `BoundedPool` instance. Returns:RecyclerPool<BufferRecycler> Globally shared instance of `BoundedPool`.

public static RecyclerPool<BufferRecycler> sharedBoundedPool()

Accessor for getting the shared/global BoundedPool instance.

Returns:RecyclerPool<BufferRecycler>: Globally shared instance of BoundedPool.

sharedConcurrentDequePool back to summary

sharedConcurrentDequePool	back to summary
public static RecyclerPool<BufferRecycler> sharedConcurrentDequePool() Accessor for getting the shared/global `ConcurrentDequePool` instance. Returns:RecyclerPool<BufferRecycler> Globally shared instance of `NonRecyclingPool`.

public static RecyclerPool<BufferRecycler> sharedConcurrentDequePool()

Accessor for getting the shared/global ConcurrentDequePool instance.

Returns:RecyclerPool<BufferRecycler>: Globally shared instance of NonRecyclingPool.

sharedLockFreePool back to summary

sharedLockFreePool	back to summary
public static RecyclerPool<BufferRecycler> sharedLockFreePool() Deprecated Since 2.18: use one of other implementations instead; see `LockFreePool` Javadocs for details Accessor for getting the shared/global `LockFreePool` instance. Returns:RecyclerPool<BufferRecycler> Globally shared instance of `LockFreePool`. Annotations @Deprecated

public static RecyclerPool<BufferRecycler> sharedLockFreePool()

Deprecated

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

Accessor for getting the shared/global LockFreePool instance.

Returns:RecyclerPool<BufferRecycler>

Globally shared instance of LockFreePool.

Annotations

@Deprecated

threadLocalPool back to summary

threadLocalPool	back to summary
public static RecyclerPool<BufferRecycler> threadLocalPool() Accessor for getting the shared/global `ThreadLocalPool` instance (due to design only one instance ever needed) Returns:RecyclerPool<BufferRecycler> Globally shared instance of `ThreadLocalPool`

public static RecyclerPool<BufferRecycler> threadLocalPool()

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

Returns:RecyclerPool<BufferRecycler>: Globally shared instance of ThreadLocalPool

com.fasterxml.jackson.core.util back to summary

public Class JsonRecyclerPools.BoundedPool

Class Inheritance

extends RecyclerPool.BoundedPoolBase<BufferRecycler>

java.lang.Object
com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase
com.fasterxml.jackson.core.util.RecyclerPool.BoundedPoolBase
com.fasterxml.jackson.core.util.JsonRecyclerPools.BoundedPool

RecyclerPool implementation that uses a bounded queue (ArrayBlockingQueue for recycling instances. This is "bounded" pool since it will never hold on to more BufferRecycler instances than its size configuration: the default size is BoundedPoolBase#DEFAULT_CAPACITY.

Field Summary

Modifier and Type	Field and Description
protected static final JsonRecyclerPools.BoundedPool	GLOBAL
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.BoundedPoolBase.serialVersionUID.

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.BoundedPoolBase:: DEFAULT_CAPACITY

Constructor Summary

Access	Constructor and Description
protected	BoundedPool(int capacityAsId)

Method Summary

Modifier and Type	Method and Description
public static JsonRecyclerPools.BoundedPool	construct(int capacity)
public BufferRecycler	createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.
protected Object	readResolve()

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.BoundedPoolBase:: acquirePooled capacity releasePooled

Field Detail

GLOBAL	back to summary
protected static final JsonRecyclerPools.BoundedPool GLOBAL

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.BoundedPoolBase.serialVersionUID.

Constructor Detail

BoundedPool	back to summary
protected BoundedPool(int capacityAsId)

Method Detail

construct	back to summary
public static JsonRecyclerPools.BoundedPool construct(int capacity)

createPooled	back to summary
public BufferRecycler createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled. Annotations @Override

createPooled

back to summary

public BufferRecycler createPooled()

Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.

Annotations

@Override

readResolve	back to summary
protected Object readResolve()

com.fasterxml.jackson.core.util back to summary

public Class JsonRecyclerPools.ConcurrentDequePool

Class Inheritance

extends RecyclerPool.ConcurrentDequePoolBase<BufferRecycler>

java.lang.Object
com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase
com.fasterxml.jackson.core.util.RecyclerPool.ConcurrentDequePoolBase
com.fasterxml.jackson.core.util.JsonRecyclerPools.ConcurrentDequePool

RecyclerPool implementation that uses ConcurrentLinkedDeque for recycling instances.

Pool is unbounded: see RecyclerPool what this means.

Field Summary

Modifier and Type	Field and Description
protected static final JsonRecyclerPools.ConcurrentDequePool	GLOBAL
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.ConcurrentDequePoolBase.serialVersionUID.

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.ConcurrentDequePoolBase:: pool

Constructor Summary

Access	Constructor and Description
protected	ConcurrentDequePool(int serialization)

Method Summary

Modifier and Type	Method and Description
public static JsonRecyclerPools.ConcurrentDequePool	construct()
public BufferRecycler	createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.
protected Object	readResolve()

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.ConcurrentDequePoolBase:: acquirePooled releasePooled

Field Detail

GLOBAL	back to summary
protected static final JsonRecyclerPools.ConcurrentDequePool GLOBAL

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.ConcurrentDequePoolBase.serialVersionUID.

Constructor Detail

ConcurrentDequePool	back to summary
protected ConcurrentDequePool(int serialization)

Method Detail

construct	back to summary
public static JsonRecyclerPools.ConcurrentDequePool construct()

createPooled	back to summary
public BufferRecycler createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled. Annotations @Override

createPooled

back to summary

public BufferRecycler createPooled()

Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.

Annotations

@Override

readResolve	back to summary
protected Object readResolve()

com.fasterxml.jackson.core.util back to summary

public Class JsonRecyclerPools.LockFreePool

Class Inheritance

extends RecyclerPool.LockFreePoolBase<BufferRecycler>

java.lang.Object
com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase
com.fasterxml.jackson.core.util.RecyclerPool.LockFreePoolBase
com.fasterxml.jackson.core.util.JsonRecyclerPools.LockFreePool

Annotations

@Deprecated

Deprecated

Since 2.18: use other implementations instead

RecyclerPool implementation that uses a lock free linked list for recycling instances.

Pool is unbounded: see RecyclerPool for details on what this means.

Note

serious issues found with 2.17.0 lead to deprecation of this implementation -- basically it is possible to have unbalanced acquire/release success rate lead to excessive growth of pooled instances. See jackson-core#1260 for details.

Field Summary

Modifier and Type	Field and Description
protected static final JsonRecyclerPools.LockFreePool	GLOBAL References Deprecated `JsonRecyclerPools.LockFreePool` is deprecated or references (maybe indirectly) at least one deprecated element.
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.LockFreePoolBase.serialVersionUID.

Constructor Summary

Access	Constructor and Description
protected	LockFreePool(int serialization)

Method Summary

Modifier and Type	Method and Description
public static JsonRecyclerPools.LockFreePool	construct() References Deprecated `JsonRecyclerPools.LockFreePool` is deprecated or references (maybe indirectly) at least one deprecated element.
public BufferRecycler	createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.
protected Object	readResolve()

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.LockFreePoolBase:: acquirePooled releasePooled

Field Detail

GLOBAL	back to summary
protected static final JsonRecyclerPools.LockFreePool GLOBAL References Deprecated `JsonRecyclerPools.LockFreePool` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.LockFreePoolBase.serialVersionUID.

Constructor Detail

LockFreePool	back to summary
protected LockFreePool(int serialization)

Method Detail

construct	back to summary
public static JsonRecyclerPools.LockFreePool construct() References Deprecated `JsonRecyclerPools.LockFreePool` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

createPooled	back to summary
public BufferRecycler createPooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled. Annotations @Override

createPooled

back to summary

public BufferRecycler createPooled()

Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.StatefulImplBase.createPooled.

Annotations

@Override

readResolve	back to summary
protected Object readResolve()

com.fasterxml.jackson.core.util back to summary

public Class JsonRecyclerPools.NonRecyclingPool

Class Inheritance

extends RecyclerPool.NonRecyclingPoolBase<BufferRecycler>

java.lang.Object
com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase
com.fasterxml.jackson.core.util.JsonRecyclerPools.NonRecyclingPool

Dummy RecyclerPool implementation that does not recycle anything but simply creates new instances when asked to acquire items.

Field Summary

Modifier and Type	Field and Description
protected static final JsonRecyclerPools.NonRecyclingPool	GLOBAL
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase.serialVersionUID.

Constructor Summary

Access	Constructor and Description
protected	NonRecyclingPool()

Method Summary

Modifier and Type	Method and Description
public BufferRecycler	acquirePooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase.acquirePooled. Implements com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled. Method for sub-classes to implement for actual acquire logic; called by `acquireAndLinkPooled()`.
protected Object	readResolve()

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase:: acquireAndLinkPooled releasePooled

Field Detail

GLOBAL	back to summary
protected static final JsonRecyclerPools.NonRecyclingPool GLOBAL

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase.serialVersionUID.

Constructor Detail

NonRecyclingPool	back to summary
protected NonRecyclingPool()

Method Detail

acquirePooled back to summary

acquirePooled	back to summary
public BufferRecycler acquirePooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase.acquirePooled. Implements com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled. Doc from com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled. Method for sub-classes to implement for actual acquire logic; called by `acquireAndLinkPooled()`. Returns:BufferRecycler Instance acquired (pooled or just constructed) Annotations @Override

public BufferRecycler acquirePooled()

Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase.acquirePooled.

Implements com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled.

Doc from com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled.

Method for sub-classes to implement for actual acquire logic; called by acquireAndLinkPooled().

Returns:BufferRecycler

Instance acquired (pooled or just constructed)

Annotations

@Override

readResolve	back to summary
protected Object readResolve()

com.fasterxml.jackson.core.util back to summary

public Class JsonRecyclerPools.ThreadLocalPool

Class Inheritance

extends RecyclerPool.ThreadLocalPoolBase<BufferRecycler>

java.lang.Object
com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase
com.fasterxml.jackson.core.util.JsonRecyclerPools.ThreadLocalPool

ThreadLocal-based RecyclerPool implementation used for recycling BufferRecycler instances: see RecyclerPool.ThreadLocalPoolBase for full explanation of functioning.

Field Summary

Modifier and Type	Field and Description
protected static final JsonRecyclerPools.ThreadLocalPool	GLOBAL
private static final long	serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase.serialVersionUID.

Constructor Summary

Access	Constructor and Description
private	ThreadLocalPool()

Method Summary

Modifier and Type	Method and Description
public BufferRecycler	acquirePooled() Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase.acquirePooled. Implements com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled. Method for sub-classes to implement for actual acquire logic; called by `acquireAndLinkPooled()`.
protected Object	readResolve()

Inherited from com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase:: acquireAndLinkPooled releasePooled

Field Detail

GLOBAL	back to summary
protected static final JsonRecyclerPools.ThreadLocalPool GLOBAL

serialVersionUID	back to summary
private static final long serialVersionUID Hides com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase.serialVersionUID.

Constructor Detail

ThreadLocalPool	back to summary
private ThreadLocalPool()

Method Detail

acquirePooled back to summary

public BufferRecycler acquirePooled()

Implements abstract com.fasterxml.jackson.core.util.RecyclerPool.ThreadLocalPoolBase.acquirePooled.

Implements com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled.

Doc from com.fasterxml.jackson.core.util.RecyclerPool.acquirePooled.

Method for sub-classes to implement for actual acquire logic; called by acquireAndLinkPooled().

Returns:BufferRecycler

Instance acquired (pooled or just constructed)

Annotations

@SuppressWarnings:deprecation
@Override

readResolve	back to summary
protected Object readResolve()

public final Class JsonRecyclerPools

Nested and Inner Type Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

public Class JsonRecyclerPools.BoundedPool

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JsonRecyclerPools.ConcurrentDequePool

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JsonRecyclerPools.LockFreePool

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JsonRecyclerPools.NonRecyclingPool

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JsonRecyclerPools.ThreadLocalPool

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail