Added:
websites/production/commons/content/proper/commons-pool/api-2.3/org/apache/commons/pool2/impl/BaseGenericObjectPool.html
==============================================================================
---
websites/production/commons/content/proper/commons-pool/api-2.3/org/apache/commons/pool2/impl/BaseGenericObjectPool.html
(added)
+++
websites/production/commons/content/proper/commons-pool/api-2.3/org/apache/commons/pool2/impl/BaseGenericObjectPool.html
Wed Dec 31 14:00:19 2014
@@ -0,0 +1,1304 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
+<!-- NewPage -->
+<html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html" charset="iso-8859-1">
+<title>BaseGenericObjectPool (Apache Commons Pool 2.3 API)</title>
+<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css"
title="Style">
+</head>
+<body>
+<script type="text/javascript"><!--
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="BaseGenericObjectPool (Apache Commons Pool 2.3
API)";
+ }
+//-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+<!-- ========= START OF TOP NAVBAR ======= -->
+<div class="topNav"><a name="navbar_top">
+<!-- -->
+</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a
name="navbar_top_firstrow">
+<!-- -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="class-use/BaseGenericObjectPool.html">Use</a></li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../../../index-all.html">Index</a></li>
+<li><a href="../../../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a
href="../../../../../org/apache/commons/pool2/impl/AbandonedConfig.html"
title="class in org.apache.commons.pool2.impl"><span class="strong">Prev
Class</span></a></li>
+<li><a
href="../../../../../org/apache/commons/pool2/impl/BaseObjectPoolConfig.html"
title="class in org.apache.commons.pool2.impl"><span class="strong">Next
Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a
href="../../../../../index.html?org/apache/commons/pool2/impl/BaseGenericObjectPool.html"
target="_top">Frames</a></li>
+<li><a href="BaseGenericObjectPool.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_top">
+<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+ allClassesLink = document.getElementById("allclasses_navbar_top");
+ if(window==top) {
+ allClassesLink.style.display = "block";
+ }
+ else {
+ allClassesLink.style.display = "none";
+ }
+ //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary: </li>
+<li>Nested | </li>
+<li><a href="#field_summary">Field</a> | </li>
+<li><a href="#constructor_summary">Constr</a> | </li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail: </li>
+<li><a href="#field_detail">Field</a> | </li>
+<li><a href="#constructor_detail">Constr</a> | </li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_top">
+<!-- -->
+</a></div>
+<!-- ========= END OF TOP NAVBAR ========= -->
+<!-- ======== START OF CLASS DATA ======== -->
+<div class="header">
+<div class="subTitle">org.apache.commons.pool2.impl</div>
+<h2 title="Class BaseGenericObjectPool" class="title">Class
BaseGenericObjectPool<T></h2>
+</div>
+<div class="contentContainer">
+<ul class="inheritance">
+<li><a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">java.lang.Object</a></li>
+<li>
+<ul class="inheritance">
+<li>org.apache.commons.pool2.impl.BaseGenericObjectPool<T></li>
+</ul>
+</li>
+</ul>
+<div class="description">
+<ul class="blockList">
+<li class="blockList">
+<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> -
Type of element pooled in this pool.
+
+ This class is intended to be thread-safe.</dd></dl>
+<dl>
+<dt>Direct Known Subclasses:</dt>
+<dd><a
href="../../../../../org/apache/commons/pool2/impl/GenericKeyedObjectPool.html"
title="class in org.apache.commons.pool2.impl">GenericKeyedObjectPool</a>, <a
href="../../../../../org/apache/commons/pool2/impl/GenericObjectPool.html"
title="class in org.apache.commons.pool2.impl">GenericObjectPool</a></dd>
+</dl>
+<hr>
+<br>
+<pre>public abstract class <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.52">BaseGenericObjectPool</a><T>
+extends <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</a></pre>
+<div class="block">Base class that provides common functionality for <a
href="../../../../../org/apache/commons/pool2/impl/GenericObjectPool.html"
title="class in
org.apache.commons.pool2.impl"><code>GenericObjectPool</code></a>
+ and <a
href="../../../../../org/apache/commons/pool2/impl/GenericKeyedObjectPool.html"
title="class in
org.apache.commons.pool2.impl"><code>GenericKeyedObjectPool</code></a>. The
primary reason this class exists is
+ reduce code duplication between the two pool implementations.</div>
+<dl><dt><span class="strong">Since:</span></dt>
+ <dd>2.0</dd>
+<dt><span class="strong">Version:</span></dt>
+ <dd>$Revision: $</dd></dl>
+</li>
+</ul>
+</div>
+<div class="summary">
+<ul class="blockList">
+<li class="blockList">
+<!-- =========== FIELD SUMMARY =========== -->
+<ul class="blockList">
+<li class="blockList"><a name="field_summary">
+<!-- -->
+</a>
+<h3>Field Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0"
summary="Field Summary table, listing fields, and an explanation">
+<caption><span>Fields</span><span class="tabEnd"> </span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th class="colLast" scope="col">Field and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>static int</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE">MEAN_TIMING_STATS_CACHE_SIZE</a></strong></code>
+<div class="block">The size of the caches used to store historical data for
some attributes
+ so that rolling means may be calculated.</div>
+</td>
+</tr>
+</table>
+</li>
+</ul>
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+<ul class="blockList">
+<li class="blockList"><a name="constructor_summary">
+<!-- -->
+</a>
+<h3>Constructor Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0"
summary="Constructor Summary table, listing constructors, and an explanation">
+<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
+<tr>
+<th class="colOne" scope="col">Constructor and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colOne"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#BaseGenericObjectPool(org.apache.commons.pool2.impl.BaseObjectPoolConfig,%20java.lang.String,%20java.lang.String)">BaseGenericObjectPool</a></strong>(<a
href="../../../../../org/apache/commons/pool2/impl/BaseObjectPoolConfig.html"
title="class in
org.apache.commons.pool2.impl">BaseObjectPoolConfig</a> config,
+ <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> jmxNameBase,
+ <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> jmxNamePrefix)</code>
+<div class="block">Handles JMX registration (if required) and the
initialization required for
+ monitoring.</div>
+</td>
+</tr>
+</table>
+</li>
+</ul>
+<!-- ========== METHOD SUMMARY =========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_summary">
+<!-- -->
+</a>
+<h3>Method Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0"
summary="Method Summary table, listing methods, and an explanation">
+<caption><span>Methods</span><span class="tabEnd"> </span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th class="colLast" scope="col">Method and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>abstract void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#close()">close</a></strong>()</code>
+<div class="block">Closes the pool, destroys the remaining idle objects and,
if registered
+ in JMX, deregisters it.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>abstract void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#evict()">evict</a></strong>()</code>
+<div class="block">Perform <code>numTests</code> idle object eviction tests,
evicting
+ examined objects that meet the criteria for eviction.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()">getBlockWhenExhausted</a></strong>()</code>
+<div class="block">Returns whether to block when the
<code>borrowObject()</code> method is
+ invoked when the pool is exhausted (the maximum number of "active"
+ objects has been reached).</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBorrowedCount()">getBorrowedCount</a></strong>()</code>
+<div class="block">The total number of objects successfully borrowed from this
pool over the
+ lifetime of the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getCreatedCount()">getCreatedCount</a></strong>()</code>
+<div class="block">The total number of objects created for this pool over the
lifetime of
+ the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getCreationStackTrace()">getCreationStackTrace</a></strong>()</code>
+<div class="block">Provides the stack trace for the call that created this
pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getDestroyedByBorrowValidationCount()">getDestroyedByBorrowValidationCount</a></strong>()</code>
+<div class="block">The total number of objects destroyed by this pool as a
result of failing
+ validation during <code>borrowObject()</code> over the lifetime of the
+ pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getDestroyedByEvictorCount()">getDestroyedByEvictorCount</a></strong>()</code>
+<div class="block">The total number of objects destroyed by the evictor
associated with this
+ pool over the lifetime of the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getDestroyedCount()">getDestroyedCount</a></strong>()</code>
+<div class="block">The total number of objects destroyed by this pool over the
lifetime of
+ the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getEvictionPolicyClassName()">getEvictionPolicyClassName</a></strong>()</code>
+<div class="block">Returns the name of the <a
href="../../../../../org/apache/commons/pool2/impl/EvictionPolicy.html"
title="interface in
org.apache.commons.pool2.impl"><code>EvictionPolicy</code></a> implementation
that is
+ used by this pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getFairness()">getFairness</a></strong>()</code>
+<div class="block">Returns whether or not the pool serves threads waiting to
borrow objects fairly.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a
href="http://docs.oracle.com/javase/6/docs/api/javax/management/ObjectName.html?is-external=true"
title="class or interface in javax.management">ObjectName</a></code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getJmxName()">getJmxName</a></strong>()</code>
+<div class="block">Provides the name under which the pool has been registered
with the
+ platform MBean server or <code>null</code> if the pool has not been
+ registered.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getLifo()">getLifo</a></strong>()</code>
+<div class="block">Returns whether the pool has LIFO (last in, first out)
behaviour with
+ respect to idle objects - always returning the most recently used object
+ from the pool, or as a FIFO (first in, first out) queue, where the pool
+ always returns the oldest object in the idle object pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMaxBorrowWaitTimeMillis()">getMaxBorrowWaitTimeMillis</a></strong>()</code>
+<div class="block">The maximum time a thread has waited to borrow objects from
the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMaxTotal()">getMaxTotal</a></strong>()</code>
+<div class="block">Returns the maximum number of objects that can be allocated
by the pool
+ (checked out to clients, or idle awaiting checkout) at a given time.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMaxWaitMillis()">getMaxWaitMillis</a></strong>()</code>
+<div class="block">Returns the maximum amount of time (in milliseconds) the
+ <code>borrowObject()</code> method should block before throwing an
+ exception when the pool is exhausted and
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()"><code>getBlockWhenExhausted()</code></a>
is true.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMeanActiveTimeMillis()">getMeanActiveTimeMillis</a></strong>()</code>
+<div class="block">The mean time objects are active for based on the last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects returned to the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMeanBorrowWaitTimeMillis()">getMeanBorrowWaitTimeMillis</a></strong>()</code>
+<div class="block">The mean time threads wait to borrow an object based on the
last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects borrowed from the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMeanIdleTimeMillis()">getMeanIdleTimeMillis</a></strong>()</code>
+<div class="block">The mean time objects are idle for based on the last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects borrowed from the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()">getMinEvictableIdleTimeMillis</a></strong>()</code>
+<div class="block">Returns the minimum amount of time an object may sit idle
in the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>abstract int</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumIdle()">getNumIdle</a></strong>()</code>
+<div class="block">The number of instances currently idle in this pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumTestsPerEvictionRun()">getNumTestsPerEvictionRun</a></strong>()</code>
+<div class="block">Returns the maximum number of objects to examine during
each run (if any)
+ of the idle object evictor thread.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getReturnedCount()">getReturnedCount</a></strong>()</code>
+<div class="block">The total number of objects returned to this pool over the
lifetime of
+ the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getSoftMinEvictableIdleTimeMillis()">getSoftMinEvictableIdleTimeMillis</a></strong>()</code>
+<div class="block">Returns the minimum amount of time an object may sit idle
in the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>),
+ with the extra condition that at least <code>minIdle</code> object
+ instances remain in the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a
href="../../../../../org/apache/commons/pool2/SwallowedExceptionListener.html"
title="interface in
org.apache.commons.pool2">SwallowedExceptionListener</a></code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getSwallowedExceptionListener()">getSwallowedExceptionListener</a></strong>()</code>
+<div class="block">The listener used (if any) to receive notifications of
exceptions
+ unavoidably swallowed by the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnBorrow()">getTestOnBorrow</a></strong>()</code>
+<div class="block">Returns whether objects borrowed from the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnCreate()">getTestOnCreate</a></strong>()</code>
+<div class="block">Returns whether objects created for the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnReturn()">getTestOnReturn</a></strong>()</code>
+<div class="block">Returns whether objects borrowed from the pool will be
validated when
+ they are returned to the pool via the <code>returnObject()</code>
method.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestWhileIdle()">getTestWhileIdle</a></strong>()</code>
+<div class="block">Returns whether objects sitting idle in the pool will be
validated by the
+ idle object evictor (if any - see
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTimeBetweenEvictionRunsMillis()">getTimeBetweenEvictionRunsMillis</a></strong>()</code>
+<div class="block">Returns the number of milliseconds to sleep between runs of
the idle
+ object evictor thread.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#isClosed()">isClosed</a></strong>()</code>
+<div class="block">Has this pool instance been closed.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setBlockWhenExhausted(boolean)">setBlockWhenExhausted</a></strong>(boolean blockWhenExhausted)</code>
+<div class="block">Sets whether to block when the <code>borrowObject()</code>
method is
+ invoked when the pool is exhausted (the maximum number of "active"
+ objects has been reached).</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setEvictionPolicyClassName(java.lang.String)">setEvictionPolicyClassName</a></strong>(<a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</a> evictionPolicyClassName)</code>
+<div class="block">Sets the name of the <a
href="../../../../../org/apache/commons/pool2/impl/EvictionPolicy.html"
title="interface in
org.apache.commons.pool2.impl"><code>EvictionPolicy</code></a> implementation
that is
+ used by this pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setLifo(boolean)">setLifo</a></strong>(boolean lifo)</code>
+<div class="block">Sets whether the pool has LIFO (last in, first out)
behaviour with
+ respect to idle objects - always returning the most recently used object
+ from the pool, or as a FIFO (first in, first out) queue, where the pool
+ always returns the oldest object in the idle object pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMaxTotal(int)">setMaxTotal</a></strong>(int maxTotal)</code>
+<div class="block">Sets the cap on the number of objects that can be allocated
by the pool
+ (checked out to clients, or idle awaiting checkout) at a given time.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMaxWaitMillis(long)">setMaxWaitMillis</a></strong>(long maxWaitMillis)</code>
+<div class="block">Sets the maximum amount of time (in milliseconds) the
+ <code>borrowObject()</code> method should block before throwing an
+ exception when the pool is exhausted and
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()"><code>getBlockWhenExhausted()</code></a>
is true.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMinEvictableIdleTimeMillis(long)">setMinEvictableIdleTimeMillis</a></strong>(long minEvictableIdleTimeMillis)</code>
+<div class="block">Sets the minimum amount of time an object may sit idle in
the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setNumTestsPerEvictionRun(int)">setNumTestsPerEvictionRun</a></strong>(int numTestsPerEvictionRun)</code>
+<div class="block">Sets the maximum number of objects to examine during each
run (if any)
+ of the idle object evictor thread.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setSoftMinEvictableIdleTimeMillis(long)">setSoftMinEvictableIdleTimeMillis</a></strong>(long softMinEvictableIdleTimeMillis)</code>
+<div class="block">Sets the minimum amount of time an object may sit idle in
the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>),
+ with the extra condition that at least <code>minIdle</code> object
+ instances remain in the pool.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setSwallowedExceptionListener(org.apache.commons.pool2.SwallowedExceptionListener)">setSwallowedExceptionListener</a></strong>(<a
href="../../../../../org/apache/commons/pool2/SwallowedExceptionListener.html"
title="interface in
org.apache.commons.pool2">SwallowedExceptionListener</a> swallowedExceptionListener)</code>
+<div class="block">The listener used (if any) to receive notifications of
exceptions
+ unavoidably swallowed by the pool.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnBorrow(boolean)">setTestOnBorrow</a></strong>(boolean testOnBorrow)</code>
+<div class="block">Sets whether objects borrowed from the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnCreate(boolean)">setTestOnCreate</a></strong>(boolean testOnCreate)</code>
+<div class="block">Sets whether objects created for the pool will be validated
before
+ being returned from the <code>borrowObject()</code> method.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnReturn(boolean)">setTestOnReturn</a></strong>(boolean testOnReturn)</code>
+<div class="block">Sets whether objects borrowed from the pool will be
validated when
+ they are returned to the pool via the <code>returnObject()</code>
method.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestWhileIdle(boolean)">setTestWhileIdle</a></strong>(boolean testWhileIdle)</code>
+<div class="block">Returns whether objects sitting idle in the pool will be
validated by the
+ idle object evictor (if any - see
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)">setTimeBetweenEvictionRunsMillis</a></strong>(long timeBetweenEvictionRunsMillis)</code>
+<div class="block">Sets the number of milliseconds to sleep between runs of
the idle
+ object evictor thread.</div>
+</td>
+</tr>
+</table>
+<ul class="blockList">
+<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
+<!-- -->
+</a>
+<h3>Methods inherited from class java.lang.<a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true"
title="class or interface in java.lang">Object</a></h3>
+<code><a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()"
title="class or interface in java.lang">clone</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
title="class or interface in java.lang">equals</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()"
title="class or interface in java.lang">finalize</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()"
title="class or interface in java.lang">getClass</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()"
title="class or interface in java.lang">hashCode</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()"
title="class or interface in java.lang">notify</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang
/Object.html?is-external=true#notifyAll()" title="class or interface in
java.lang">notifyAll</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()"
title="class or interface in java.lang">toString</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()"
title="class or interface in java.lang">wait</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)"
title="class or interface in java.lang">wait</a>, <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long,%20int)"
title="class or interface in java.lang">wait</a></code></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="details">
+<ul class="blockList">
+<li class="blockList">
+<!-- ============ FIELD DETAIL =========== -->
+<ul class="blockList">
+<li class="blockList"><a name="field_detail">
+<!-- -->
+</a>
+<h3>Field Detail</h3>
+<a name="MEAN_TIMING_STATS_CACHE_SIZE">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>MEAN_TIMING_STATS_CACHE_SIZE</h4>
+<pre>public static final int <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.59">MEAN_TIMING_STATS_CACHE_SIZE</a></pre>
+<div class="block">The size of the caches used to store historical data for
some attributes
+ so that rolling means may be calculated.</div>
+<dl><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../constant-values.html#org.apache.commons.pool2.impl.BaseGenericObjectPool.MEAN_TIMING_STATS_CACHE_SIZE">Constant
Field Values</a></dd></dl>
+</li>
+</ul>
+</li>
+</ul>
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+<ul class="blockList">
+<li class="blockList"><a name="constructor_detail">
+<!-- -->
+</a>
+<h3>Constructor Detail</h3>
+<a
name="BaseGenericObjectPool(org.apache.commons.pool2.impl.BaseObjectPoolConfig,
java.lang.String, java.lang.String)">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>BaseGenericObjectPool</h4>
+<pre>public <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.129">BaseGenericObjectPool</a>(<a
href="../../../../../org/apache/commons/pool2/impl/BaseObjectPoolConfig.html"
title="class in
org.apache.commons.pool2.impl">BaseObjectPoolConfig</a> config,
+ <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> jmxNameBase,
+ <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> jmxNamePrefix)</pre>
+<div class="block">Handles JMX registration (if required) and the
initialization required for
+ monitoring.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>config</code> -
Pool configuration</dd><dd><code>jmxNameBase</code> - The default base JMX name
for the new pool unless
+ overridden by the
config</dd><dd><code>jmxNamePrefix</code> - Prefix to be used for JMX name for
the new pool</dd></dl>
+</li>
+</ul>
+</li>
+</ul>
+<!-- ============ METHOD DETAIL ========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_detail">
+<!-- -->
+</a>
+<h3>Method Detail</h3>
+<a name="getMaxTotal()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMaxTotal</h4>
+<pre>public final int <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.163">getMaxTotal</a>()</pre>
+<div class="block">Returns the maximum number of objects that can be allocated
by the pool
+ (checked out to clients, or idle awaiting checkout) at a given time. When
+ negative, there is no limit to the number of objects that can be
+ managed by the pool at one time.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the cap on the total
number of object instances managed by the
+ pool.</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMaxTotal(int)"><code>setMaxTotal(int)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setMaxTotal(int)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setMaxTotal</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.178">setMaxTotal</a>(int maxTotal)</pre>
+<div class="block">Sets the cap on the number of objects that can be allocated
by the pool
+ (checked out to clients, or idle awaiting checkout) at a given time. Use
+ a negative value for no limit.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>maxTotal</code>
- The cap on the total number of object instances managed
+ by the pool. Negative values mean that there is no limit
+ to the number of objects allocated by the
pool.</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMaxTotal()"><code>getMaxTotal()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getBlockWhenExhausted()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getBlockWhenExhausted</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.192">getBlockWhenExhausted</a>()</pre>
+<div class="block">Returns whether to block when the
<code>borrowObject()</code> method is
+ invoked when the pool is exhausted (the maximum number of "active"
+ objects has been reached).</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
<code>borrowObject()</code> should block
+ when the pool is exhausted</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setBlockWhenExhausted(boolean)"><code>setBlockWhenExhausted(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setBlockWhenExhausted(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setBlockWhenExhausted</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.207">setBlockWhenExhausted</a>(boolean blockWhenExhausted)</pre>
+<div class="block">Sets whether to block when the <code>borrowObject()</code>
method is
+ invoked when the pool is exhausted (the maximum number of "active"
+ objects has been reached).</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>blockWhenExhausted</code> -
<code>true</code> if
+ <code>borrowObject()</code> should block
+ when the pool is exhausted</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()"><code>getBlockWhenExhausted()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getMaxWaitMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMaxWaitMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.224">getMaxWaitMillis</a>()</pre>
+<div class="block">Returns the maximum amount of time (in milliseconds) the
+ <code>borrowObject()</code> method should block before throwing an
+ exception when the pool is exhausted and
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()"><code>getBlockWhenExhausted()</code></a>
is true. When less than 0, the
+ <code>borrowObject()</code> method may block indefinitely.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the maximum number of
milliseconds <code>borrowObject()</code>
+ will block.</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMaxWaitMillis(long)"><code>setMaxWaitMillis(long)</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setBlockWhenExhausted(boolean)"><code>setBlockWhenExhausted(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setMaxWaitMillis(long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setMaxWaitMillis</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.242">setMaxWaitMillis</a>(long maxWaitMillis)</pre>
+<div class="block">Sets the maximum amount of time (in milliseconds) the
+ <code>borrowObject()</code> method should block before throwing an
+ exception when the pool is exhausted and
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getBlockWhenExhausted()"><code>getBlockWhenExhausted()</code></a>
is true. When less than 0, the
+ <code>borrowObject()</code> method may block indefinitely.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>maxWaitMillis</code> - the
maximum number of milliseconds
+ <code>borrowObject()</code> will block or negative
+ for indefinitely.</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMaxWaitMillis()"><code>getMaxWaitMillis()</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setBlockWhenExhausted(boolean)"><code>setBlockWhenExhausted(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="getLifo()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getLifo</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.258">getLifo</a>()</pre>
+<div class="block">Returns whether the pool has LIFO (last in, first out)
behaviour with
+ respect to idle objects - always returning the most recently used object
+ from the pool, or as a FIFO (first in, first out) queue, where the pool
+ always returns the oldest object in the idle object pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if the
pool is configured with LIFO behaviour
+ or <code>false</code> if the pool is configured with FIFO
+ behaviour</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setLifo(boolean)"><code>setLifo(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="getFairness()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getFairness</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.269">getFairness</a>()</pre>
+<div class="block">Returns whether or not the pool serves threads waiting to
borrow objects fairly.
+ True means that waiting threads are served as if waiting in a FIFO
queue.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
waiting threads are to be served
+ by the pool in arrival order</dd></dl>
+</li>
+</ul>
+<a name="setLifo(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setLifo</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.285">setLifo</a>(boolean lifo)</pre>
+<div class="block">Sets whether the pool has LIFO (last in, first out)
behaviour with
+ respect to idle objects - always returning the most recently used object
+ from the pool, or as a FIFO (first in, first out) queue, where the pool
+ always returns the oldest object in the idle object pool.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>lifo</code> -
<code>true</code> if the pool is to be configured with LIFO
+ behaviour or <code>false</code> if the pool is to be
+ configured with FIFO behaviour</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getLifo()"><code>getLifo()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getTestOnCreate()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getTestOnCreate</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.303">getTestOnCreate</a>()</pre>
+<div class="block">Returns whether objects created for the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method. Validation is
+ performed by the <code>validateObject()</code> method of the factory
+ associated with the pool. If the object fails to validate, then
+ <code>borrowObject()</code> will fail.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
newly created objects are validated before
+ being returned from the <code>borrowObject()</code>
method</dd><dt><span class="strong">Since:</span></dt>
+ <dd>2.2</dd>
+<dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnCreate(boolean)"><code>setTestOnCreate(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setTestOnCreate(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setTestOnCreate</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.322">setTestOnCreate</a>(boolean testOnCreate)</pre>
+<div class="block">Sets whether objects created for the pool will be validated
before
+ being returned from the <code>borrowObject()</code> method. Validation is
+ performed by the <code>validateObject()</code> method of the factory
+ associated with the pool. If the object fails to validate, then
+ <code>borrowObject()</code> will fail.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>testOnCreate</code> -
<code>true</code> if newly created objects should be
+ validated before being returned from the
+ <code>borrowObject()</code> method</dd><dt><span
class="strong">Since:</span></dt>
+ <dd>2.2</dd>
+<dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnCreate()"><code>getTestOnCreate()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getTestOnBorrow()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getTestOnBorrow</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.339">getTestOnBorrow</a>()</pre>
+<div class="block">Returns whether objects borrowed from the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method. Validation is
+ performed by the <code>validateObject()</code> method of the factory
+ associated with the pool. If the object fails to validate, it will be
+ removed from the pool and destroyed, and a new attempt will be made to
+ borrow an object from the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
objects are validated before being returned
+ from the <code>borrowObject()</code> method</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnBorrow(boolean)"><code>setTestOnBorrow(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setTestOnBorrow(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setTestOnBorrow</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.357">setTestOnBorrow</a>(boolean testOnBorrow)</pre>
+<div class="block">Sets whether objects borrowed from the pool will be
validated before
+ being returned from the <code>borrowObject()</code> method. Validation is
+ performed by the <code>validateObject()</code> method of the factory
+ associated with the pool. If the object fails to validate, it will be
+ removed from the pool and destroyed, and a new attempt will be made to
+ borrow an object from the pool.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>testOnBorrow</code> -
<code>true</code> if objects should be validated
+ before being returned from the
+ <code>borrowObject()</code> method</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnBorrow()"><code>getTestOnBorrow()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getTestOnReturn()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getTestOnReturn</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.373">getTestOnReturn</a>()</pre>
+<div class="block">Returns whether objects borrowed from the pool will be
validated when
+ they are returned to the pool via the <code>returnObject()</code> method.
+ Validation is performed by the <code>validateObject()</code> method of
+ the factory associated with the pool. Returning objects that fail validation
+ are destroyed rather then being returned the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
objects are validated on return to
+ the pool via the <code>returnObject()</code> method</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestOnReturn(boolean)"><code>setTestOnReturn(boolean)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setTestOnReturn(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setTestOnReturn</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.390">setTestOnReturn</a>(boolean testOnReturn)</pre>
+<div class="block">Sets whether objects borrowed from the pool will be
validated when
+ they are returned to the pool via the <code>returnObject()</code> method.
+ Validation is performed by the <code>validateObject()</code> method of
+ the factory associated with the pool. Returning objects that fail validation
+ are destroyed rather then being returned the pool.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>testOnReturn</code> -
<code>true</code> if objects are validated on
+ return to the pool via the
+ <code>returnObject()</code> method</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestOnReturn()"><code>getTestOnReturn()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getTestWhileIdle()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getTestWhileIdle</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.407">getTestWhileIdle</a>()</pre>
+<div class="block">Returns whether objects sitting idle in the pool will be
validated by the
+ idle object evictor (if any - see
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).
Validation is performed
+ by the <code>validateObject()</code> method of the factory associated
+ with the pool. If the object fails to validate, it will be removed from
+ the pool and destroyed.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> if
objects will be validated by the evictor</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTestWhileIdle(boolean)"><code>setTestWhileIdle(boolean)</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setTestWhileIdle(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setTestWhileIdle</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.427">setTestWhileIdle</a>(boolean testWhileIdle)</pre>
+<div class="block">Returns whether objects sitting idle in the pool will be
validated by the
+ idle object evictor (if any - see
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).
Validation is performed
+ by the <code>validateObject()</code> method of the factory associated
+ with the pool. If the object fails to validate, it will be removed from
+ the pool and destroyed. Note that setting this property has no effect
+ unless the idle object evictor is enabled by setting
+ <code>timeBetweenEvictionRunsMillis</code> to a positive value.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>testWhileIdle</code> -
<code>true</code> so objects will be validated by the evictor</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTestWhileIdle()"><code>getTestWhileIdle()</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="getTimeBetweenEvictionRunsMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getTimeBetweenEvictionRunsMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.440">getTimeBetweenEvictionRunsMillis</a>()</pre>
+<div class="block">Returns the number of milliseconds to sleep between runs of
the idle
+ object evictor thread. When non-positive, no idle object evictor thread
+ will be run.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>number of milliseconds to
sleep between evictor runs</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setTimeBetweenEvictionRunsMillis(long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setTimeBetweenEvictionRunsMillis</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.454">setTimeBetweenEvictionRunsMillis</a>(long timeBetweenEvictionRunsMillis)</pre>
+<div class="block">Sets the number of milliseconds to sleep between runs of
the idle
+ object evictor thread. When non-positive, no idle object evictor thread
+ will be run.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>timeBetweenEvictionRunsMillis</code>
- number of milliseconds to sleep between evictor runs</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getTimeBetweenEvictionRunsMillis()"><code>getTimeBetweenEvictionRunsMillis()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getNumTestsPerEvictionRun()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getNumTestsPerEvictionRun</h4>
+<pre>public final int <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.475">getNumTestsPerEvictionRun</a>()</pre>
+<div class="block">Returns the maximum number of objects to examine during
each run (if any)
+ of the idle object evictor thread. When positive, the number of tests
+ performed for a run will be the minimum of the configured value and the
+ number of idle instances in the pool. When negative, the number of tests
+ performed will be <code>ceil(<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumIdle()"><code>getNumIdle()</code></a>/
+ abs(<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumTestsPerEvictionRun()"><code>getNumTestsPerEvictionRun()</code></a>))</code>
which means that when the
+ value is <code>-n</code> roughly one nth of the idle objects will be
+ tested per run.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>max number of objects to
examine during each evictor run</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setNumTestsPerEvictionRun(int)"><code>setNumTestsPerEvictionRun(int)</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setNumTestsPerEvictionRun(int)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setNumTestsPerEvictionRun</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.495">setNumTestsPerEvictionRun</a>(int numTestsPerEvictionRun)</pre>
+<div class="block">Sets the maximum number of objects to examine during each
run (if any)
+ of the idle object evictor thread. When positive, the number of tests
+ performed for a run will be the minimum of the configured value and the
+ number of idle instances in the pool. When negative, the number of tests
+ performed will be <code>ceil(<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumIdle()"><code>getNumIdle()</code></a>/
+ abs(<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumTestsPerEvictionRun()"><code>getNumTestsPerEvictionRun()</code></a>))</code>
which means that when the
+ value is <code>-n</code> roughly one nth of the idle objects will be
+ tested per run.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>numTestsPerEvictionRun</code> -
max number of objects to examine during each evictor run</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getNumTestsPerEvictionRun()"><code>getNumTestsPerEvictionRun()</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="getMinEvictableIdleTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMinEvictableIdleTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.511">getMinEvictableIdleTimeMillis</a>()</pre>
+<div class="block">Returns the minimum amount of time an object may sit idle
in the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).
When non-positive,
+ no objects will be evicted from the pool due to idle time alone.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>minimum amount of time an
object may sit idle in the pool before
+ it is eligible for eviction</dd><dt><span class="strong">See
Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setMinEvictableIdleTimeMillis(long)"><code>setMinEvictableIdleTimeMillis(long)</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setMinEvictableIdleTimeMillis(long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setMinEvictableIdleTimeMillis</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.528">setMinEvictableIdleTimeMillis</a>(long minEvictableIdleTimeMillis)</pre>
+<div class="block">Sets the minimum amount of time an object may sit idle in
the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>).
When non-positive,
+ no objects will be evicted from the pool due to idle time alone.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>minEvictableIdleTimeMillis</code>
- minimum amount of time an object may sit idle in the pool
+ before it is eligible for eviction</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()"><code>getMinEvictableIdleTimeMillis()</code></a>,
+<a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="getSoftMinEvictableIdleTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getSoftMinEvictableIdleTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.548">getSoftMinEvictableIdleTimeMillis</a>()</pre>
+<div class="block">Returns the minimum amount of time an object may sit idle
in the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>),
+ with the extra condition that at least <code>minIdle</code> object
+ instances remain in the pool. This setting is overridden by
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()"><code>getMinEvictableIdleTimeMillis()</code></a>
(that is, if
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()"><code>getMinEvictableIdleTimeMillis()</code></a>
is positive, then
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getSoftMinEvictableIdleTimeMillis()"><code>getSoftMinEvictableIdleTimeMillis()</code></a>
is ignored).</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>minimum amount of time an
object may sit idle in the pool before
+ it is eligible for eviction if minIdle instances are
available</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setSoftMinEvictableIdleTimeMillis(long)"><code>setSoftMinEvictableIdleTimeMillis(long)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setSoftMinEvictableIdleTimeMillis(long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setSoftMinEvictableIdleTimeMillis</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.569">setSoftMinEvictableIdleTimeMillis</a>(long softMinEvictableIdleTimeMillis)</pre>
+<div class="block">Sets the minimum amount of time an object may sit idle in
the pool
+ before it is eligible for eviction by the idle object evictor (if any -
+ see <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setTimeBetweenEvictionRunsMillis(long)"><code>setTimeBetweenEvictionRunsMillis(long)</code></a>),
+ with the extra condition that at least <code>minIdle</code> object
+ instances remain in the pool. This setting is overridden by
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()"><code>getMinEvictableIdleTimeMillis()</code></a>
(that is, if
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getMinEvictableIdleTimeMillis()"><code>getMinEvictableIdleTimeMillis()</code></a>
is positive, then
+ <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getSoftMinEvictableIdleTimeMillis()"><code>getSoftMinEvictableIdleTimeMillis()</code></a>
is ignored).</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>softMinEvictableIdleTimeMillis</code>
- minimum amount of time an object may sit idle in the pool
+ before it is eligible for eviction if minIdle instances are
+ available</dd><dt><span class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getSoftMinEvictableIdleTimeMillis()"><code>getSoftMinEvictableIdleTimeMillis()</code></a></dd></dl>
+</li>
+</ul>
+<a name="getEvictionPolicyClassName()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getEvictionPolicyClassName</h4>
+<pre>public final <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.582">getEvictionPolicyClassName</a>()</pre>
+<div class="block">Returns the name of the <a
href="../../../../../org/apache/commons/pool2/impl/EvictionPolicy.html"
title="interface in
org.apache.commons.pool2.impl"><code>EvictionPolicy</code></a> implementation
that is
+ used by this pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>The fully qualified class
name of the <a
href="../../../../../org/apache/commons/pool2/impl/EvictionPolicy.html"
title="interface in
org.apache.commons.pool2.impl"><code>EvictionPolicy</code></a></dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#setEvictionPolicyClassName(java.lang.String)"><code>setEvictionPolicyClassName(String)</code></a></dd></dl>
+</li>
+</ul>
+<a name="setEvictionPolicyClassName(java.lang.String)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setEvictionPolicyClassName</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.595">setEvictionPolicyClassName</a>(<a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in
java.lang">String</a> evictionPolicyClassName)</pre>
+<div class="block">Sets the name of the <a
href="../../../../../org/apache/commons/pool2/impl/EvictionPolicy.html"
title="interface in
org.apache.commons.pool2.impl"><code>EvictionPolicy</code></a> implementation
that is
+ used by this pool.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>evictionPolicyClassName</code>
- the fully qualified class name of the
+ new eviction policy</dd><dt><span
class="strong">See Also:</span></dt><dd><a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#getEvictionPolicyClassName()"><code>getEvictionPolicyClassName()</code></a></dd></dl>
+</li>
+</ul>
+<a name="close()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>close</h4>
+<pre>public abstract void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.626">close</a>()</pre>
+<div class="block">Closes the pool, destroys the remaining idle objects and,
if registered
+ in JMX, deregisters it.</div>
+</li>
+</ul>
+<a name="isClosed()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>isClosed</h4>
+<pre>public final boolean <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.632">isClosed</a>()</pre>
+<div class="block">Has this pool instance been closed.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd><code>true</code> when
this pool has been closed.</dd></dl>
+</li>
+</ul>
+<a name="evict()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>evict</h4>
+<pre>public abstract void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.646">evict</a>()
+ throws <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true"
title="class or interface in java.lang">Exception</a></pre>
+<div class="block"><p>Perform <code>numTests</code> idle object eviction
tests, evicting
+ examined objects that meet the criteria for eviction. If
+ <code>testWhileIdle</code> is true, examined objects are validated
+ when visited (and removed if invalid); otherwise only objects that
+ have been idle for more than <code>minEvicableIdleTimeMillis</code>
+ are removed.</p></div>
+<dl><dt><span class="strong">Throws:</span></dt>
+<dd><code><a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true"
title="class or interface in java.lang">Exception</a></code> - when there is a
problem evicting idle objects.</dd></dl>
+</li>
+</ul>
+<a name="getJmxName()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getJmxName</h4>
+<pre>public final <a
href="http://docs.oracle.com/javase/6/docs/api/javax/management/ObjectName.html?is-external=true"
title="class or interface in javax.management">ObjectName</a> <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.706">getJmxName</a>()</pre>
+<div class="block">Provides the name under which the pool has been registered
with the
+ platform MBean server or <code>null</code> if the pool has not been
+ registered.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the JMX name</dd></dl>
+</li>
+</ul>
+<a name="getCreationStackTrace()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getCreationStackTrace</h4>
+<pre>public final <a
href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true"
title="class or interface in java.lang">String</a> <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.718">getCreationStackTrace</a>()</pre>
+<div class="block">Provides the stack trace for the call that created this
pool. JMX
+ registration may trigger a memory leak so it is important that pools are
+ deregistered when no longer used by calling the <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#close()"><code>close()</code></a>
method.
+ This method is provided to assist with identifying code that creates but
+ does not close it thereby creating a memory leak.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>pool creation stack
trace</dd></dl>
+</li>
+</ul>
+<a name="getBorrowedCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getBorrowedCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.727">getBorrowedCount</a>()</pre>
+<div class="block">The total number of objects successfully borrowed from this
pool over the
+ lifetime of the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the borrowed object
count</dd></dl>
+</li>
+</ul>
+<a name="getReturnedCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getReturnedCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.737">getReturnedCount</a>()</pre>
+<div class="block">The total number of objects returned to this pool over the
lifetime of
+ the pool. This excludes attempts to return the same object multiple
+ times.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the returned object
count</dd></dl>
+</li>
+</ul>
+<a name="getCreatedCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getCreatedCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.746">getCreatedCount</a>()</pre>
+<div class="block">The total number of objects created for this pool over the
lifetime of
+ the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the created object
count</dd></dl>
+</li>
+</ul>
+<a name="getDestroyedCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getDestroyedCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.755">getDestroyedCount</a>()</pre>
+<div class="block">The total number of objects destroyed by this pool over the
lifetime of
+ the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the destroyed object
count</dd></dl>
+</li>
+</ul>
+<a name="getDestroyedByEvictorCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getDestroyedByEvictorCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.764">getDestroyedByEvictorCount</a>()</pre>
+<div class="block">The total number of objects destroyed by the evictor
associated with this
+ pool over the lifetime of the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>the evictor destroyed
object count</dd></dl>
+</li>
+</ul>
+<a name="getDestroyedByBorrowValidationCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getDestroyedByBorrowValidationCount</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.774">getDestroyedByBorrowValidationCount</a>()</pre>
+<div class="block">The total number of objects destroyed by this pool as a
result of failing
+ validation during <code>borrowObject()</code> over the lifetime of the
+ pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>validation destroyed
object count</dd></dl>
+</li>
+</ul>
+<a name="getMeanActiveTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMeanActiveTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.784">getMeanActiveTimeMillis</a>()</pre>
+<div class="block">The mean time objects are active for based on the last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects returned to the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>mean time an object has
been checked out from the pool among
+ recently returned objects</dd></dl>
+</li>
+</ul>
+<a name="getMeanIdleTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMeanIdleTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.794">getMeanIdleTimeMillis</a>()</pre>
+<div class="block">The mean time objects are idle for based on the last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects borrowed from the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>mean time an object has
been idle in the pool among recently
+ borrowed objects</dd></dl>
+</li>
+</ul>
+<a name="getMeanBorrowWaitTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMeanBorrowWaitTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.804">getMeanBorrowWaitTimeMillis</a>()</pre>
+<div class="block">The mean time threads wait to borrow an object based on the
last <a
href="../../../../../org/apache/commons/pool2/impl/BaseGenericObjectPool.html#MEAN_TIMING_STATS_CACHE_SIZE"><code>MEAN_TIMING_STATS_CACHE_SIZE</code></a>
objects borrowed from the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>mean time in milliseconds
that a recently served thread has had
+ to wait to borrow an object from the pool</dd></dl>
+</li>
+</ul>
+<a name="getMaxBorrowWaitTimeMillis()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getMaxBorrowWaitTimeMillis</h4>
+<pre>public final long <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.812">getMaxBorrowWaitTimeMillis</a>()</pre>
+<div class="block">The maximum time a thread has waited to borrow objects from
the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>maximum wait time in
milliseconds since the pool was created</dd></dl>
+</li>
+</ul>
+<a name="getNumIdle()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getNumIdle</h4>
+<pre>public abstract int <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.820">getNumIdle</a>()</pre>
+<div class="block">The number of instances currently idle in this pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>count of instances
available for checkout from the pool</dd></dl>
+</li>
+</ul>
+<a name="getSwallowedExceptionListener()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getSwallowedExceptionListener</h4>
+<pre>public final <a
href="../../../../../org/apache/commons/pool2/SwallowedExceptionListener.html"
title="interface in
org.apache.commons.pool2">SwallowedExceptionListener</a> <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.828">getSwallowedExceptionListener</a>()</pre>
+<div class="block">The listener used (if any) to receive notifications of
exceptions
+ unavoidably swallowed by the pool.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>The listener or
<code>null</code> for no listener</dd></dl>
+</li>
+</ul>
+<a
name="setSwallowedExceptionListener(org.apache.commons.pool2.SwallowedExceptionListener)">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>setSwallowedExceptionListener</h4>
+<pre>public final void <a
href="../../../../../src-html/org/apache/commons/pool2/impl/BaseGenericObjectPool.html#line.839">setSwallowedExceptionListener</a>(<a
href="../../../../../org/apache/commons/pool2/SwallowedExceptionListener.html"
title="interface in
org.apache.commons.pool2">SwallowedExceptionListener</a> swallowedExceptionListener)</pre>
+<div class="block">The listener used (if any) to receive notifications of
exceptions
+ unavoidably swallowed by the pool.</div>
+<dl><dt><span
class="strong">Parameters:</span></dt><dd><code>swallowedExceptionListener</code>
- The listener or <code>null</code>
+ for no listener</dd></dl>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<!-- ========= END OF CLASS DATA ========= -->
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<div class="bottomNav"><a name="navbar_bottom">
+<!-- -->
+</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a
name="navbar_bottom_firstrow">
+<!-- -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="class-use/BaseGenericObjectPool.html">Use</a></li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../../../index-all.html">Index</a></li>
+<li><a href="../../../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a
href="../../../../../org/apache/commons/pool2/impl/AbandonedConfig.html"
title="class in org.apache.commons.pool2.impl"><span class="strong">Prev
Class</span></a></li>
+<li><a
href="../../../../../org/apache/commons/pool2/impl/BaseObjectPoolConfig.html"
title="class in org.apache.commons.pool2.impl"><span class="strong">Next
Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a
href="../../../../../index.html?org/apache/commons/pool2/impl/BaseGenericObjectPool.html"
target="_top">Frames</a></li>
+<li><a href="BaseGenericObjectPool.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_bottom">
+<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+ allClassesLink = document.getElementById("allclasses_navbar_bottom");
+ if(window==top) {
+ allClassesLink.style.display = "block";
+ }
+ else {
+ allClassesLink.style.display = "none";
+ }
+ //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary: </li>
+<li>Nested | </li>
+<li><a href="#field_summary">Field</a> | </li>
+<li><a href="#constructor_summary">Constr</a> | </li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail: </li>
+<li><a href="#field_detail">Field</a> | </li>
+<li><a href="#constructor_detail">Constr</a> | </li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_bottom">
+<!-- -->
+</a></div>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+<p class="legalCopy"><small>Copyright © 2001–2014 <a
href="http://www.apache.org/">The Apache Software Foundation</a>. All rights
reserved.</small></p>
+</body>
+</html>
\ No newline at end of file
Propchange:
websites/production/commons/content/proper/commons-pool/api-2.3/org/apache/commons/pool2/impl/BaseGenericObjectPool.html
------------------------------------------------------------------------------
svn:eol-style = native