com.scaleoutsoftware.soss.client.util

Class ResourceRecycler<R extends ResourceAllocationValidator>

java.lang.Object

com.scaleoutsoftware.soss.client.util.ResourceRecycler<R>

Type Parameters:

R - the type of resource to recycle

Direct Known Subclasses:

StructRecycler

public class ResourceRecycler<R extends ResourceAllocationValidator>
extends java.lang.Object

A simple resource recycler that functions like a ResourcePool except that resources are created whenever the cache is empty and resources are left for garbage collection if there are already more than a fixed number in the buffer.

TODO: it would be nice to free up resources from this recycler if they haven't been used after some period of time.

Constructor Summary

Constructors

Constructor and Description
ResourceRecycler(ResourceFactory<R> resourceFactory, int maxBufferedResources)

Method Summary

Modifier and Type	Method and Description
R	getResource() Return an available resource from the pool, lazily creating a new one if none are available.
void	releaseResource(R resource) Release a resource back to the buffer.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceRecycler

public ResourceRecycler(ResourceFactory<R> resourceFactory,
                        int maxBufferedResources)

Method Detail

getResource

public R getResource()
              throws java.util.concurrent.ExecutionException

Return an available resource from the pool, lazily creating a new one if none are available.

Returns:

an available resource

Throws:

java.util.concurrent.ExecutionException - as a wrapper around any exceptions thrown by the resource factory.

releaseResource

public void releaseResource(R resource)

Release a resource back to the buffer. If there are already a sufficient number of resources in the buffer, leave the resource alone, allowing it to be garbage collected.

Parameters:

resource - the resource to return to the buffer