com.j_spaces.kernel.pool

Class TraceableResource

java.lang.Object

com.j_spaces.kernel.pool.Resource

com.j_spaces.kernel.pool.TraceableResource

All Implemented Interfaces:

IResource

public abstract class TraceableResource
extends Resource

A resource that can be traced back to it's allocation point. Helps to find leaks in code which acquire a resource but do not return it back into the pool.

Usage: replace the Resource with a TraceableResource e.g., public myResource extends Resource { ... } would be replaced with public myResource extends TraceableResource {...}

Since:

6.0.2

Version:

1.0

Author:

moran

Constructor Summary

Constructors

Constructor and Description
TraceableResource()

Method Summary

Modifier and Type	Method and Description
boolean	acquire() Atomically acquires a free resource.
void	release() Atomically sets this resource as free; usually when returning a resource to the pool.

Methods inherited from class com.j_spaces.kernel.pool.Resource

clear, isAcquired, isFromPool, setAcquired, setFromPool

Methods inherited from class java.lang.Object

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

Constructor Detail

TraceableResource

public TraceableResource()

Method Detail

release

public void release()

Description copied from interface: IResource

Atomically sets this resource as free; usually when returning a resource to the pool.

Before releasing the resource back into the pool, IResource.clear() is invoked.

Specified by:

release in interface IResource

Overrides:

release in class Resource

acquire

public boolean acquire()

Description copied from interface: IResource

Atomically acquires a free resource. But, due to race conditions, it may fail.

Specified by:

acquire in interface IResource

Overrides:

acquire in class Resource

Returns:

true if acquire succeeded; false otherwise (may have already been acquired by another thread).