|
Keel 2.1RC2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectorg.apache.avalon.framework.logger.AbstractLogEnabled
org.apache.avalon.excalibur.pool.ResourceLimitingPool
General Pool implementation which supports; weak and strong pool size limits, optional blocking gets when poolables are not available, and automatic pool trimming of unused poolables.
Whenever get() is called, the pool tests to see whether it is time to trim old poolables from the pool. If any old poolables exist then they are removed at this time. This means that old poolables will not be removed if get() is never called. Applications can optionally call trim() to force old objects to be trimmed. See the trim() method for details of how trimming works.
| Field Summary | |
private boolean |
m_blockingWhether or not the pool should cause threads requesting a Poolable to block when m_maxStrict is true, the pool size is equal to m_max and there are no Poolable instances available. |
private long |
m_blockTimeoutThe maximum amount of time in milliseconds that the pool will block. |
private boolean |
m_disposedKeeps track of whether or not the Pool has been disposed. |
private ObjectFactory |
m_factoryThe Object Factory used to generate new Poolable instances for the pool. |
private long |
m_lastTrimThe last time that the pool was trimmed. |
private int |
m_maxThe maximum size of the pool. |
private boolean |
m_maxStrictWhether or not the pool allows for the creation of objects beyond the maximum pool size. |
private java.util.LinkedList |
m_oldReadyList of the Poolable instance which are available for use but have been idle for a while. |
private int |
m_oldReadySizeStore the size of the old ready list to optimize operations which require this value. |
private java.util.LinkedList |
m_readyList of the Poolable instances which are available for use. |
private int |
m_readySizeStore the size of the ready list to optimize operations which require this value. |
protected java.lang.Object |
m_semaphoreObject used to synchronize access to the get and put methods |
private int |
m_sizeTotal number of Poolable instances in the pool |
private long |
m_trimIntervalThe minimum interval with which old unused poolables will be removed from the pool. |
| Fields inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled |
|
| Constructor Summary | |
ResourceLimitingPool(ObjectFactory factory, int max, boolean maxStrict, boolean blocking, long blockTimeout, long trimInterval)Creates a new ResourceLimitingPool |
|
| Method Summary | |
void |
dispose()The dispose operation is called at the end of a components lifecycle. |
Poolable |
get()Gets a Poolable from the pool. |
int |
getReadySize()Returns the number of available Poolables waiting in the pool. |
int |
getSize()Returns the total number of Poolables created by the pool. |
protected Poolable |
newPoolable()Create a new poolable instance by by calling the newInstance method on the pool's ObjectFactory. |
protected void |
permanentlyRemovePoolable(Poolable poolable)Permanently removes a poolable from the pool's active list and destroys it so that it will not ever be reused. |
void |
put(Poolable poolable)Returns a poolable to the pool and notifies any thread blocking. |
protected void |
removePoolable(Poolable poolable)Called when an object is being removed permanently from the pool. |
int |
trim()Forces the pool to trim, remove, old Poolables from the pool. |
private int |
trimInner()See trim() for details. |
| Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled |
enableLogging, getLogger, setupLogger, setupLogger, setupLogger |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface org.apache.avalon.framework.logger.LogEnabled |
enableLogging |
| Field Detail |
protected final java.lang.Object m_semaphore
private boolean m_disposed
private final ObjectFactory m_factory
private final int m_max
private final boolean m_maxStrict
private final boolean m_blocking
private final long m_blockTimeout
private final long m_trimInterval
private long m_lastTrim
private java.util.LinkedList m_ready
private int m_readySize
private java.util.LinkedList m_oldReady
private int m_oldReadySize
private int m_size
| Constructor Detail |
public ResourceLimitingPool(ObjectFactory factory,
int max,
boolean maxStrict,
boolean blocking,
long blockTimeout,
long trimInterval)
factory - The ObjectFactory which will be used to create new Poolables as needed by the pool.max - Maximum number of Poolables which can be stored in the pool, 0 implies no limit.maxStrict - true if the pool should never allow more than max Poolable to be created. Will cause an exception to be thrown if more than max Poolables are requested and blocking is false.blocking - true if the pool should cause a thread calling get() to block when Poolables are not currently available in the pool.blockTimeout - The maximum amount of time, in milliseconds, that a call to get() will block before an exception is thrown. A value of 0 implies an indefinate wait.trimInterval - The minimum interval with which old unused poolables will be removed from the pool. A value of 0 will cause the pool to never trim poolables.| Method Detail |
public Poolable get()
throws java.lang.Exception
get in interface Pooljava.lang.Exception - An exception may be thrown as described above or if there is an exception thrown by the ObjectFactory's newInstance() method.public void put(Poolable poolable)
put in interface Poolpoolable - Poolable to return to the pool.public void dispose()
dispose in interface Disposableprotected void permanentlyRemovePoolable(Poolable poolable)
This method is only called by threads that have m_semaphore locked.
public int getSize()
public int getReadySize()
protected Poolable newPoolable()
throws java.lang.Exception
This is the method to override when you need to enforce creational policies.
This method is only called by threads that have m_semaphore locked.
java.lang.Exceptionprotected void removePoolable(Poolable poolable)
This method is only called by threads that have m_semaphore locked.
poolable - Poolable to be completely removed from the pool.public int trim()
Trimming is done by maintaining two lists of objects. The first is a ready list of new poolables. The second is a list of old poolables. Each time trim() is called, the contents of the old list are removed from the pool. Then the contents of the new list is moved into the old list.
Each time get() is called on the pool, the new list is checked first, then the old list is checked, finally a new poolable may be created if both lists are empty. Then whenever put() is called, the poolables are always returned to the new list. In this way, the need for maining time stamps for each poolable can be avoided while at the same time avoiding unnecessary removal and creation on poolables.
This works out to a poolable having a maximum idle time of two calls to trim() or twice the value of trimInterval.
NOTE - The trimming feature does not harm performance because pools with high load will not have old poolables to be trimmed, and the benefits to system resources from not keeping around unused poolables makes up for any hit.
private int trimInner()
|
Keel 2.1RC2 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||