Modified: websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/PoolUtils.html ============================================================================== --- websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/PoolUtils.html (original) +++ websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/PoolUtils.html Sat Feb 8 20:08:04 2025 @@ -2,7 +2,7 @@ <html lang> <head> <!-- Generated by javadoc (17) --> -<title>PoolUtils (Apache Commons Pool 2.12.1 API)</title> +<title>PoolUtils (Apache Commons Pool 2.12.2-SNAPSHOT API)</title> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="description" content="declaration: package: org.apache.commons.pool2, class: PoolUtils"> @@ -72,13 +72,13 @@ loadScripts(document, 'script');</script <div class="sub-title"><span class="package-label-in-type">Package</span> <a href="package-summary.html">org.apache.commons.pool2</a></div> <h1 title="Class PoolUtils" class="title">Class PoolUtils</h1> </div> -<div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">java.lang.Object</a> +<div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">java.lang.Object</a> <div class="inheritance">org.apache.commons.pool2.PoolUtils</div> </div> <section class="class-description" id="class-description"> <hr> <div class="type-signature"><span class="modifiers">public final class </span><span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-36">PoolUtils</a></span> -<span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">Object</a></span></div> +<span class="extends-implements">extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">Object</a></span></div> <div class="block">This class consists exclusively of static methods that operate on or return ObjectPool or KeyedObjectPool related interfaces.</div> <dl class="notes"> @@ -115,9 +115,9 @@ loadScripts(document, 'script');</script <div class="table-header col-second">Method</div> <div class="table-header col-last">Description</div> <div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <K,<wbr> -V> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Map.html"; title="class or interface in java.util" class="external-link">Map</a><K,<wbr><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a>></code></div> +V> <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html"; title="class or interface in java.util" class="external-link">Map</a><K,<wbr><a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a>></code></div> <div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#checkMinIdle(org.apache.commons.pool2.KeyedObjectPool,java.util.Collection,int,long)" class="member-name-link">checkMinIdle</a><wbr>(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, int minIdle, long periodMillis)</code></div> <div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"> @@ -125,7 +125,7 @@ V> <a href="https://docs.oracle. <code>Collection keys</code> in the keyedPool.</div> </div> <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <K,<wbr> -V> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></code></div> +V> <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></code></div> <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#checkMinIdle(org.apache.commons.pool2.KeyedObjectPool,K,int,long)" class="member-name-link">checkMinIdle</a><wbr>(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, K key, int minIdle, @@ -133,7 +133,7 @@ V> <a href="https://docs.oracle. <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"> <div class="block">Periodically check the idle object count for the key in the keyedPool.</div> </div> -<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <T> <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></code></div> +<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static <T> <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></code></div> <div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#checkMinIdle(org.apache.commons.pool2.ObjectPool,int,long)" class="member-name-link">checkMinIdle</a><wbr>(<a href="ObjectPool.html" title="interface in org.apache.commons.pool2">ObjectPool</a><T> pool, int minIdle, long periodMillis)</code></div> @@ -141,7 +141,7 @@ V> <a href="https://docs.oracle. <div class="block">Periodically check the idle object count for the pool.</div> </div> <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static void</code></div> -<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#checkRethrow(java.lang.Throwable)" class="member-name-link">checkRethrow</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html"; title="class or interface in java.lang" class="external-link">Throwable</a> t)</code></div> +<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#checkRethrow(java.lang.Throwable)" class="member-name-link">checkRethrow</a><wbr>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"; title="class or interface in java.lang" class="external-link">Throwable</a> t)</code></div> <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"> <div class="block">Should the supplied Throwable be re-thrown (eg if it is an instance of one of the Throwables that should never be swallowed).</div> @@ -186,7 +186,7 @@ V> <a href="KeyedObjectPool.html <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4 method-summary-table-tab6"><code>static <K,<wbr> V> void</code></div> <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4 method-summary-table-tab6"><code><a href="#prefill(org.apache.commons.pool2.KeyedObjectPool,java.util.Collection,int)" class="member-name-link">prefill</a><wbr>(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, int count)</code></div> <div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4 method-summary-table-tab6"> <div class="block"><span class="deprecated-label">Deprecated.</span> @@ -241,8 +241,8 @@ V> <a href="KeyedObjectPool.html </div> </div> <div class="inherited-list"> -<h3 id="methods-inherited-from-class-java.lang.Object">Methods inherited from class java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">Object</a></h3> -<code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#clone()" title="class or interface in java.lang" class="external-link">clone</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#finalize()" title="class or interface in java.lang" class="external-link">finalize</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#hashCode()" title="class or interface in java.lang" class="external-link">hashCode</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Objec t.html#notify()" title="class or interface in java.lang" class="external-link">notify</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#notifyAll()" title="class or interface in java.lang" class="external-link">notifyAll</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#toString()" title="class or interface in java.lang" class="external-link">toString</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#wait(long)" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#wait(long,int)" title="class or interface in java.lang" class="external-link">wait</a></code></div> +<h3 id="methods-inherited-from-class-java.lang.Object">Methods inherited from class java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html"; title="class or interface in java.lang" class="external-link">Object</a></h3> +<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--"; title="class or interface in java.lang" class="external-link">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-"; title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--"; title="class or interface in java.lang" class="external-link">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--"; title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--"; title="class or interface in java.lang" class="external-link">hashCode</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--"; title="class or interface in java.lang" class="external-link">notify</a>, <a href="https://docs.o racle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--" title="class or interface in java.lang" class="external-link">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--"; title="class or interface in java.lang" class="external-link">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--"; title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-"; title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-"; title="class or interface in java.lang" class="external-link">wait</a></code></div> </section> </li> </ul> @@ -276,11 +276,11 @@ V> <a href="KeyedObjectPool.html <section class="detail" id="checkMinIdle(org.apache.commons.pool2.KeyedObjectPool,java.util.Collection,int,long)"> <h3>checkMinIdle</h3> <div class="member-signature"><span class="modifiers">public static</span> <span class="type-parameters"><K,<wbr> -V></span> <span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Map.html"; title="class or interface in java.util" class="external-link">Map</a><K,<wbr><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a>></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1345">checkMinIdle</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, +V></span> <span class="return-type"><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html"; title="class or interface in java.util" class="external-link">Map</a><K,<wbr><a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a>></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1345">checkMinIdle</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, int minIdle, long periodMillis)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> <div class="block">Periodically check the idle object count for each key in the <code>Collection keys</code> in the keyedPool. At most one idle object will be added per period.</div> @@ -294,15 +294,15 @@ V></span> <span class="return-ty <dd><code>minIdle</code> - if the <a href="KeyedObjectPool.html#getNumIdle(K)"><code>KeyedObjectPool.getNumIdle(Object)</code></a> is less than this then add an idle object.</dd> <dd><code>periodMillis</code> - the frequency in milliseconds to check the number of idle objects in a - keyedPool, see <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> + keyedPool, see <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> <dt>Returns:</dt> -<dd>a <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Map.html"; title="class or interface in java.util" class="external-link"><code>Map</code></a> of key and <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> pairs that will +<dd>a <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html"; title="class or interface in java.util" class="external-link"><code>Map</code></a> of key and <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> pairs that will periodically check the pools idle object count.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>keys</code>, or any of the values in +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>keys</code>, or any of the values in the collection is <code>null</code> or when <code>minIdle</code> is negative or when <code>period</code> isn't valid for - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> <dt>See Also:</dt> <dd> <ul class="see-list-long"> @@ -316,11 +316,11 @@ V></span> <span class="return-ty <section class="detail" id="checkMinIdle(org.apache.commons.pool2.KeyedObjectPool,K,int,long)"> <h3 id="checkMinIdle(org.apache.commons.pool2.KeyedObjectPool,java.lang.Object,int,long)">checkMinIdle</h3> <div class="member-signature"><span class="modifiers">public static</span> <span class="type-parameters"><K,<wbr> -V></span> <span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1382">checkMinIdle</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, +V></span> <span class="return-type"><a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1382">checkMinIdle</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, K key, int minIdle, long periodMillis)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> <div class="block">Periodically check the idle object count for the key in the keyedPool. At most one idle object will be added per period. If there is an exception when calling <a href="KeyedObjectPool.html#addObject(K)"><code>KeyedObjectPool.addObject(Object)</code></a> then no more @@ -335,24 +335,24 @@ V></span> <span class="return-ty <dd><code>minIdle</code> - if the <a href="KeyedObjectPool.html#getNumIdle(K)"><code>KeyedObjectPool.getNumIdle(Object)</code></a> is less than this then add an idle object.</dd> <dd><code>periodMillis</code> - the frequency in milliseconds to check the number of idle objects in a - keyedPool, see <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> + keyedPool, see <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> <dt>Returns:</dt> -<dd>the <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> that will periodically check the pools idle +<dd>the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> that will periodically check the pools idle object count.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>key</code> is <code>null</code> or +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>key</code> is <code>null</code> or when <code>minIdle</code> is negative or when <code>period</code> isn't - valid for <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> + valid for <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> </dl> </section> </li> <li> <section class="detail" id="checkMinIdle(org.apache.commons.pool2.ObjectPool,int,long)"> <h3>checkMinIdle</h3> -<div class="member-signature"><span class="modifiers">public static</span> <span class="type-parameters"><T></span> <span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1422">checkMinIdle</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="interface in org.apache.commons.pool2">ObjectPool</a><T> pool, +<div class="member-signature"><span class="modifiers">public static</span> <span class="type-parameters"><T></span> <span class="return-type"><a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link">TimerTask</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1422">checkMinIdle</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="interface in org.apache.commons.pool2">ObjectPool</a><T> pool, int minIdle, long periodMillis)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> <div class="block">Periodically check the idle object count for the pool. At most one idle object will be added per period. If there is an exception when calling <a href="ObjectPool.html#addObject()"><code>ObjectPool.addObject()</code></a> then no more checks will be performed.</div> @@ -364,21 +364,21 @@ V></span> <span class="return-ty <dd><code>minIdle</code> - if the <a href="ObjectPool.html#getNumIdle()"><code>ObjectPool.getNumIdle()</code></a> is less than this then add an idle object.</dd> <dd><code>periodMillis</code> - the frequency in milliseconds to check the number of idle objects in a pool, - see <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> + see <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a>.</dd> <dt>Returns:</dt> -<dd>the <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> that will periodically check the pools idle +<dd>the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimerTask.html"; title="class or interface in java.util" class="external-link"><code>TimerTask</code></a> that will periodically check the pools idle object count.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code> or when <code>minIdle</code> is +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code> or when <code>minIdle</code> is negative or when <code>period</code> isn't valid for - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Timer.html#schedule(java.util.TimerTask,long,long)" title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a></dd> + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Timer.html#schedule-java.util.TimerTask-long-long-"; title="class or interface in java.util" class="external-link"><code>Timer.schedule(TimerTask, long, long)</code></a></dd> </dl> </section> </li> <li> <section class="detail" id="checkRethrow(java.lang.Throwable)"> <h3>checkRethrow</h3> -<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1449">checkRethrow</a></span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html"; title="class or interface in java.lang" class="external-link">Throwable</a> t)</span></div> +<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1449">checkRethrow</a></span><wbr><span class="parameters">(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html"; title="class or interface in java.lang" class="external-link">Throwable</a> t)</span></div> <div class="block">Should the supplied Throwable be re-thrown (eg if it is an instance of one of the Throwables that should never be swallowed). Used by the pool error handling for operations that throw exceptions that normally need to @@ -387,8 +387,8 @@ V></span> <span class="return-ty <dt>Parameters:</dt> <dd><code>t</code> - The Throwable to check</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/ThreadDeath.html"; title="class or interface in java.lang" class="external-link">ThreadDeath</a></code> - if that is passed in</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/VirtualMachineError.html"; title="class or interface in java.lang" class="external-link">VirtualMachineError</a></code> - if that is passed in</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/ThreadDeath.html"; title="class or interface in java.lang" class="external-link">ThreadDeath</a></code> - if that is passed in</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/VirtualMachineError.html"; title="class or interface in java.lang" class="external-link">VirtualMachineError</a></code> - if that is passed in</dd> </dl> </section> </li> @@ -413,7 +413,7 @@ V></span> <span class="return-ty <dd>a pool that adaptively decreases its size when idle objects are no longer needed.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code>.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code>.</dd> <dt>See Also:</dt> <dd> <ul class="see-list-long"> @@ -456,7 +456,7 @@ V></span> <span class="return-ty <dd>a pool that adaptively decreases its size when idle objects are no longer needed.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code> or when <code>factor</code> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code> or when <code>factor</code> is not positive.</dd> <dt>See Also:</dt> <dd> @@ -507,7 +507,7 @@ V></span> <span class="return-ty <dd>a pool that adaptively decreases its size when idle objects are no longer needed.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code> or when <code>factor</code> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> is <code>null</code> or when <code>factor</code> is not positive.</dd> <dt>See Also:</dt> <dd> @@ -538,7 +538,7 @@ V></span> <span class="return-ty <dd>a pool that adaptively decreases its size when idle objects are no longer needed.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> <dt>See Also:</dt> <dd> <ul class="see-list-long"> @@ -578,7 +578,7 @@ V></span> <span class="return-ty <dd>a pool that adaptively decreases its size when idle objects are no longer needed.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code> or when <code>factor</code> is +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code> or when <code>factor</code> is not positive.</dd> <dt>See Also:</dt> <dd> @@ -592,13 +592,13 @@ V></span> <span class="return-ty <li> <section class="detail" id="prefill(org.apache.commons.pool2.KeyedObjectPool,java.util.Collection,int)"> <h3>prefill</h3> -<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> +<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> </span><span class="modifiers">public static</span> <span class="type-parameters"><K,<wbr> V></span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1661">prefill</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, + <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html"; title="class or interface in java.util" class="external-link">Collection</a><K> keys, int count)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a>, -<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a>, +<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> <div class="deprecation-block"><span class="deprecated-label">Deprecated.</span> <div class="deprecation-comment">Use <a href="KeyedObjectPool.html#addObjects(java.util.Collection,int)"><code>KeyedObjectPool.addObjects(Collection, int)</code></a>.</div> </div> @@ -612,11 +612,11 @@ V></span> <span class="return-ty <dd><code>V</code> - the type of pool entries</dd> <dt>Parameters:</dt> <dd><code>keyedPool</code> - the keyedPool to prefill.</dd> -<dd><code>keys</code> - <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Collection.html"; title="class or interface in java.util" class="external-link"><code>Collection</code></a> of keys to add objects for.</dd> +<dd><code>keys</code> - <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html"; title="class or interface in java.util" class="external-link"><code>Collection</code></a> of keys to add objects for.</dd> <dd><code>count</code> - the number of idle objects to add for each <code>key</code>.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="KeyedObjectPool.html#addObject(K)"><code>KeyedObjectPool.addObject(Object)</code></a> fails.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>keys</code>, or any value in +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="KeyedObjectPool.html#addObject(K)"><code>KeyedObjectPool.addObject(Object)</code></a> fails.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code>, <code>keys</code>, or any value in <code>keys</code> is <code>null</code>.</dd> <dt>See Also:</dt> <dd> @@ -630,13 +630,13 @@ V></span> <span class="return-ty <li> <section class="detail" id="prefill(org.apache.commons.pool2.KeyedObjectPool,K,int)"> <h3 id="prefill(org.apache.commons.pool2.KeyedObjectPool,java.lang.Object,int)">prefill</h3> -<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> +<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> </span><span class="modifiers">public static</span> <span class="type-parameters"><K,<wbr> V></span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1689">prefill</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2">KeyedObjectPool</a><K,<wbr>V> keyedPool, K key, int count)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a>, -<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a>, +<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></span></div> <div class="deprecation-block"><span class="deprecated-label">Deprecated.</span> <div class="deprecation-comment">Use <a href="KeyedObjectPool.html#addObjects(K,int)"><code>KeyedObjectPool.addObjects(Object, int)</code></a>.</div> </div> @@ -651,18 +651,18 @@ V></span> <span class="return-ty <dd><code>key</code> - the key to add objects for.</dd> <dd><code>count</code> - the number of idle objects to add for <code>key</code>.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="KeyedObjectPool.html#addObject(K)"><code>KeyedObjectPool.addObject(Object)</code></a> fails.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> or <code>key</code> is <code>null</code>.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="KeyedObjectPool.html#addObject(K)"><code>KeyedObjectPool.addObject(Object)</code></a> fails.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>keyedPool</code> or <code>key</code> is <code>null</code>.</dd> </dl> </section> </li> <li> <section class="detail" id="prefill(org.apache.commons.pool2.ObjectPool,int)"> <h3>prefill</h3> -<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> +<div class="member-signature"><span class="annotations"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html"; title="class or interface in java.lang" class="external-link">@Deprecated</a> </span><span class="modifiers">public static</span> <span class="type-parameters"><T></span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/PoolUtils.html#line-1714">prefill</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="interface in org.apache.commons.pool2">ObjectPool</a><T> pool, int count)</span> - throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></span></div> + throws <span class="exceptions"><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></span></div> <div class="deprecation-block"><span class="deprecated-label">Deprecated.</span> <div class="deprecation-comment">Use <a href="ObjectPool.html#addObjects(int)"><code>ObjectPool.addObjects(int)</code></a>.</div> </div> @@ -675,8 +675,8 @@ V></span> <span class="return-ty <dd><code>pool</code> - the pool to prefill.</dd> <dd><code>count</code> - the number of idle objects to add.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="ObjectPool.html#addObject()"><code>ObjectPool.addObject()</code></a> fails.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Exception.html"; title="class or interface in java.lang" class="external-link">Exception</a></code> - when <a href="ObjectPool.html#addObject()"><code>ObjectPool.addObject()</code></a> fails.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> </dl> </section> </li> @@ -709,7 +709,7 @@ V></span> <span class="return-ty <p> <strong>Note:</strong> This should not be used on pool implementations that already provide proper synchronization such as the pools provided in the Commons - Pool library. Wrapping a pool that <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link"><code>waits</code></a> for poolable + Pool library. Wrapping a pool that <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--"; title="class or interface in java.lang" class="external-link"><code>waits</code></a> for poolable objects to be returned before allowing another one to be borrowed with another layer of synchronization will cause liveliness issues or a deadlock. @@ -735,7 +735,7 @@ V></span> <span class="return-ty <p> <strong>Note:</strong> This should not be used on pool implementations that already provide proper synchronization such as the pools provided in the Commons - Pool library. Wrapping a pool that <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link"><code>waits</code></a> for poolable + Pool library. Wrapping a pool that <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--"; title="class or interface in java.lang" class="external-link"><code>waits</code></a> for poolable objects to be returned before allowing another one to be borrowed with another layer of synchronization will cause liveliness issues or a deadlock. @@ -748,7 +748,7 @@ V></span> <span class="return-ty <dt>Returns:</dt> <dd>a synchronized view of the specified ObjectPool.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html"; title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - when <code>pool</code> is <code>null</code>.</dd> </dl> </section> </li>
