|
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.InstrumentedResourceLimitingPool
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 | |
static java.lang.String |
DEFAULT_INSTRUMENTABLE_NAME |
static java.lang.String |
INSTRUMENT_BLOCKS_NAME |
static java.lang.String |
INSTRUMENT_CREATES_NAME |
static java.lang.String |
INSTRUMENT_DECOMMISSIONS_NAME |
static java.lang.String |
INSTRUMENT_GETS_NAME |
static java.lang.String |
INSTRUMENT_PUTS_NAME |
static java.lang.String |
INSTRUMENT_READY_SIZE_NAME |
static java.lang.String |
INSTRUMENT_SIZE_NAME |
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 CounterInstrument |
m_blocksInstrumentInstrument used to profile the number of blocks. |
private long |
m_blockTimeoutThe maximum amount of time in milliseconds that the pool will block. |
private CounterInstrument |
m_createsInstrumentInstrument used to profile the number of created poolables. |
private CounterInstrument |
m_decommissionsInstrumentInstrument used to profile the number of decommissioned poolables. |
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 CounterInstrument |
m_getsInstrumentInstrument used to profile the number of gets. |
private java.lang.String |
m_instrumentableNameInstrumentable Name assigned to this Instrumentable |
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 CounterInstrument |
m_putsInstrumentInstrument used to profile the number of puts. |
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. |
private ValueInstrument |
m_readySizeInstrumentInstrument used to profile the number of available poolables. |
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 ValueInstrument |
m_sizeInstrumentInstrument used to profile the size of 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 |
|
| Fields inherited from interface org.apache.excalibur.instrument.Instrumentable |
EMPTY_INSTRUMENT_ARRAY, EMPTY_INSTRUMENTABLE_ARRAY |
| Constructor Summary | |
InstrumentedResourceLimitingPool(ObjectFactory factory, int max, boolean maxStrict, boolean blocking, long blockTimeout, long trimInterval)Creates a new InstrumentedResourceLimitingPool |
|
| Method Summary | |
void |
dispose()The dispose operation is called at the end of a components lifecycle. |
Poolable |
get()Gets a Poolable from the pool. |
Instrumentable[] |
getChildInstrumentables()Any Object which implements Instrumentable can also make use of other Instrumentable child objects. |
java.lang.String |
getInstrumentableName()Gets the name of the Instrumentable. |
Instrument[] |
getInstruments()Obtain a reference to all the Instruments that the Instrumentable object wishes to expose. |
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. |
void |
setInstrumentableName(java.lang.String name)Sets the name for the Instrumentable. |
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 |
public static final java.lang.String DEFAULT_INSTRUMENTABLE_NAME
public static final java.lang.String INSTRUMENT_SIZE_NAME
public static final java.lang.String INSTRUMENT_READY_SIZE_NAME
public static final java.lang.String INSTRUMENT_GETS_NAME
public static final java.lang.String INSTRUMENT_PUTS_NAME
public static final java.lang.String INSTRUMENT_BLOCKS_NAME
public static final java.lang.String INSTRUMENT_CREATES_NAME
public static final java.lang.String INSTRUMENT_DECOMMISSIONS_NAME
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
private java.lang.String m_instrumentableName
private ValueInstrument m_sizeInstrument
private ValueInstrument m_readySizeInstrument
private CounterInstrument m_getsInstrument
private CounterInstrument m_putsInstrument
private CounterInstrument m_blocksInstrument
private CounterInstrument m_createsInstrument
private CounterInstrument m_decommissionsInstrument
| Constructor Detail |
public InstrumentedResourceLimitingPool(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 Disposablepublic void setInstrumentableName(java.lang.String name)
This value may be set by a parent Instrumentable, or by the InstrumentManager using the value of the 'instrumentable' attribute in the configuration of the component.
setInstrumentableName in interface Instrumentablename - The name used to identify a Instrumentable.public java.lang.String getInstrumentableName()
getInstrumentableName in interface Instrumentablepublic Instrument[] getInstruments()
getInstruments in interface Instrumentablepublic Instrumentable[] getChildInstrumentables()
getChildInstrumentables in interface Instrumentableprotected 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 | ||||||||||