Package com.fasterxml.jackson.core.util

Class RecyclerPool.NonRecyclingPoolBase<P extends RecyclerPool.WithPool<P>>

java.lang.Object

com.fasterxml.jackson.core.util.RecyclerPool.NonRecyclingPoolBase<P>

All Implemented Interfaces:

RecyclerPool<P>, java.io.Serializable

Direct Known Subclasses:

JsonRecyclerPools.NonRecyclingPool

Enclosing interface:

RecyclerPool<P extends RecyclerPool.WithPool<P>>

public abstract static class RecyclerPool.NonRecyclingPoolBase<P extends RecyclerPool.WithPool<P>>
extends java.lang.Object
implements RecyclerPool<P>

RecyclerPool implementation that does not use any pool but simply creates new instances when necessary.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.fasterxml.jackson.core.util.RecyclerPool

RecyclerPool.BoundedPoolBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.ConcurrentDequePoolBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.LockFreePoolBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.NonRecyclingPoolBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.StatefulImplBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.ThreadLocalPoolBase<P extends RecyclerPool.WithPool<P>>, RecyclerPool.WithPool<P extends RecyclerPool.WithPool<P>>

Constructor Summary

Constructors

Constructor	Description
NonRecyclingPoolBase()

Method Summary

Modifier and Type	Method	Description
P	acquireAndLinkPooled()	Method called to acquire a Pooled value from this pool AND make sure it is linked back to this RecyclerPool as necessary for it to be released (see RecyclerPool.releasePooled(P)) later after usage ends.
abstract P	acquirePooled()	Method for sub-classes to implement for actual acquire logic; called by RecyclerPool.acquireAndLinkPooled().
boolean	clear()	Although no pooling occurs, we consider clearing to succeed, so returns always true.
int	pooledCount()	Diagnostic method for obtaining an estimate of number of pooled items this pool contains, available for recycling.
void	releasePooled(P pooled)	Method that should be called when previously acquired (see RecyclerPool.acquireAndLinkPooled()) pooled value that is no longer needed; this lets pool to take ownership for possible reuse.

Methods inherited from class java.lang.Object

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

Constructor Detail

NonRecyclingPoolBase

public NonRecyclingPoolBase()

Method Detail

acquireAndLinkPooled

public P acquireAndLinkPooled()

Description copied from interface: RecyclerPool

Method called to acquire a Pooled value from this pool AND make sure it is linked back to this RecyclerPool as necessary for it to be released (see RecyclerPool.releasePooled(P)) later after usage ends. Actual acquisition is done by a call to RecyclerPool.acquirePooled().

Default implementation calls RecyclerPool.acquirePooled() followed by a call to RecyclerPool.WithPool.withPool(com.fasterxml.jackson.core.util.RecyclerPool<P>).

Specified by:

acquireAndLinkPooled in interface RecyclerPool<P extends RecyclerPool.WithPool<P>>

Returns:

Pooled instance for caller to use; caller expected to call RecyclerPool.releasePooled(P) after it is done using instance.

acquirePooled

public abstract P acquirePooled()

Description copied from interface: RecyclerPool

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

Specified by:

acquirePooled in interface RecyclerPool<P extends RecyclerPool.WithPool<P>>

Returns:

Instance acquired (pooled or just constructed)

releasePooled

public void releasePooled(P pooled)

Description copied from interface: RecyclerPool

Method that should be called when previously acquired (see RecyclerPool.acquireAndLinkPooled()) pooled value that is no longer needed; this lets pool to take ownership for possible reuse.

Specified by:

releasePooled in interface RecyclerPool<P extends RecyclerPool.WithPool<P>>

Parameters:

pooled - Pooled instance to release back to pool

pooledCount

public int pooledCount()

Description copied from interface: RecyclerPool

Diagnostic method for obtaining an estimate of number of pooled items this pool contains, available for recycling. Note that in addition to this information possibly not being available (denoted by return value of -1) even when available this may be just an approximation.

Default method implementation simply returns -1 and is meant to be overridden by concrete sub-classes.

Specified by:

pooledCount in interface RecyclerPool<P extends RecyclerPool.WithPool<P>>

Returns:

Number of pooled entries available from this pool, if available; -1 if not.

clear

public boolean clear()

Although no pooling occurs, we consider clearing to succeed, so returns always true.

Specified by:

clear in interface RecyclerPool<P extends RecyclerPool.WithPool<P>>

Returns:

Always returns true