Modified: websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedObjectPool.html ============================================================================== --- websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedObjectPool.html (original) +++ websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedObjectPool.html Sat Feb 8 20:08:04 2025 @@ -2,7 +2,7 @@ <html lang> <head> <!-- Generated by javadoc (17) --> -<title>KeyedObjectPool (Apache Commons Pool 2.12.1 API)</title> +<title>KeyedObjectPool (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, interface: KeyedObjectPool"> @@ -80,7 +80,7 @@ loadScripts(document, 'script');</script </dl> <dl class="notes"> <dt>All Superinterfaces:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> </dl> <dl class="notes"> <dt>All Known Implementing Classes:</dt> @@ -88,7 +88,7 @@ loadScripts(document, 'script');</script </dl> <hr> <div class="type-signature"><span class="modifiers">public interface </span><span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-71">KeyedObjectPool</a><K,<wbr>V></span><span class="extends-implements"> -extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></span></div> +extends <a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></span></div> <div class="block">A "keyed" pooling interface. <p> A keyed pool maintains a pool of instances for each key value. @@ -116,7 +116,7 @@ extends <a href="https://docs.oracle.com <p> <a href="KeyedObjectPool.html" title="interface in org.apache.commons.pool2"><code>KeyedObjectPool</code></a> implementations <em>may</em> choose to store at most one instance per key value, or may choose to maintain a pool of instances - for each key (essentially creating 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 + for each key (essentially creating 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 <a href="ObjectPool.html" title="interface in org.apache.commons.pool2"><code>pools</code></a>). </p> <p> @@ -156,7 +156,7 @@ extends <a href="https://docs.oracle.com in the idle object pool.</div> </div> <div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default void</code></div> -<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#addObjects(java.util.Collection,int)" class="member-name-link">addObjects</a><wbr>(<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><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>> keys, +<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#addObjects(java.util.Collection,int)" class="member-name-link">addObjects</a><wbr>(<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><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>> keys, int count)</code></div> <div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"> <div class="block">Calls <a href="#addObject(K)"><code>addObject(Object)</code></a> with each @@ -190,7 +190,7 @@ extends <a href="https://docs.oracle.com <div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"> <div class="block">Closes this pool, and free any resources associated with it.</div> </div> -<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/List.html"; title="class or interface in java.util" class="external-link">List</a><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>></code></div> +<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html"; title="class or interface in java.util" class="external-link">List</a><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>></code></div> <div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#getKeys()" class="member-name-link">getKeys</a>()</code></div> <div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"> <div class="block">Gets a copy of the pool key list.</div> @@ -256,7 +256,7 @@ extends <a href="https://docs.oracle.com <section class="detail" id="addObject(K)"> <h3 id="addObject(java.lang.Object)">addObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-87">addObject</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key)</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="block">Creates an object using the <a href="KeyedPooledObjectFactory.html" title="interface in org.apache.commons.pool2"><code>factory</code></a> or other implementation dependent mechanism, passivate it, and then place it in the idle object pool. <code>addObject</code> is useful for @@ -265,29 +265,29 @@ extends <a href="https://docs.oracle.com <dt>Parameters:</dt> <dd><code>key</code> - the key a new instance should be added to</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="KeyedPooledObjectFactory.html#makeObject(K)"><code>KeyedPooledObjectFactory.makeObject(K)</code></a> fails.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close()</code></a> has been called on this pool.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this pool cannot add new idle objects.</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="KeyedPooledObjectFactory.html#makeObject(K)"><code>KeyedPooledObjectFactory.makeObject(K)</code></a> fails.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close()</code></a> has been called on this pool.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this pool cannot add new idle objects.</dd> </dl> </section> </li> <li> <section class="detail" id="addObjects(java.util.Collection,int)"> <h3>addObjects</h3> -<div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-106">addObjects</a></span><wbr><span class="parameters">(<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><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>> keys, +<div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-106">addObjects</a></span><wbr><span class="parameters">(<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><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>> 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></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="block">Calls <a href="#addObject(K)"><code>addObject(Object)</code></a> with each key in <code>keys</code> for <code>count</code> number of times. This has the same effect as calling <a href="#addObjects(K,int)"><code>addObjects(Object, int)</code></a> for each key in the <code>keys</code> collection.</div> <dl class="notes"> <dt>Parameters:</dt> -<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="#addObject(K)"><code>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 +<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="#addObject(K)"><code>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> @@ -303,7 +303,7 @@ extends <a href="https://docs.oracle.com <h3 id="addObjects(java.lang.Object,int)">addObjects</h3> <div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-129">addObjects</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> 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></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="block">Calls <a href="#addObject(K)"><code>addObject(Object)</code></a> <code>key</code> <code>count</code> number of times.</div> <dl class="notes"> @@ -311,8 +311,8 @@ extends <a href="https://docs.oracle.com <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="#addObject(K)"><code>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>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="#addObject(K)"><code>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>key</code> is <code>null</code>.</dd> <dt>Since:</dt> <dd>2.8.0</dd> </dl> @@ -322,7 +322,7 @@ extends <a href="https://docs.oracle.com <section class="detail" id="borrowObject(K)"> <h3 id="borrowObject(java.lang.Object)">borrowObject</h3> <div class="member-signature"><span class="return-type"><a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">V</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-172">borrowObject</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key)</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="block">Borrows an instance from this pool for the specified <code>key</code>. <p> Instances returned from this method will have been either newly created @@ -337,7 +337,7 @@ extends <a href="https://docs.oracle.com using <a href="#returnObject(K,V)"><code>returnObject</code></a>, <a href="#invalidateObject(K,V)"><code>invalidateObject</code></a>, or a related method as defined in an implementation or sub-interface, using a <code>key</code> - that is <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"><code>equivalent</code></a> to the one used to borrow the + that is <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"><code>equivalent</code></a> to the one used to borrow the instance in the first place. </p> <p> @@ -350,9 +350,9 @@ extends <a href="https://docs.oracle.com <dt>Returns:</dt> <dd>an instance from this pool.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close</code></a> has been called on this pool</dd> -<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="KeyedPooledObjectFactory.html#makeObject(K)"><code>makeObject</code></a> throws an exception</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/NoSuchElementException.html"; title="class or interface in java.util" class="external-link">NoSuchElementException</a></code> - when the pool is exhausted and cannot or will not return +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close</code></a> has been called on this pool</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="KeyedPooledObjectFactory.html#makeObject(K)"><code>makeObject</code></a> throws an exception</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/NoSuchElementException.html"; title="class or interface in java.util" class="external-link">NoSuchElementException</a></code> - when the pool is exhausted and cannot or will not return another instance</dd> </dl> </section> @@ -361,13 +361,13 @@ extends <a href="https://docs.oracle.com <section class="detail" id="clear()"> <h3>clear</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-182">clear</a></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="block">Clears the pool, removing all pooled instances (optional operation).</div> <dl class="notes"> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this implementation doesn't +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this implementation doesn't support the operation</dd> -<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> - if the pool cannot be cleared</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> - if the pool cannot be cleared</dd> </dl> </section> </li> @@ -375,16 +375,16 @@ extends <a href="https://docs.oracle.com <section class="detail" id="clear(K)"> <h3 id="clear(java.lang.Object)">clear</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-194">clear</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key)</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="block">Clears the specified pool, removing all pooled instances corresponding to the given <code>key</code> (optional operation).</div> <dl class="notes"> <dt>Parameters:</dt> <dd><code>key</code> - the key to clear</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this implementation doesn't +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this implementation doesn't support the operation</dd> -<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> - if the key cannot be cleared</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> - if the key cannot be cleared</dd> </dl> </section> </li> @@ -396,23 +396,23 @@ extends <a href="https://docs.oracle.com <p> Calling <a href="#addObject(K)"><code>addObject</code></a> or <a href="#borrowObject(K)"><code>borrowObject</code></a> after invoking this method on a pool - will cause them to throw an <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link"><code>IllegalStateException</code></a>. + will cause them to throw an <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link"><code>IllegalStateException</code></a>. </p> <p> Implementations should silently fail if not all resources can be freed. </p></div> <dl class="notes"> <dt>Specified by:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html#close()" title="class or interface in java.lang" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html#close--"; title="class or interface in java.lang" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd> <dt>Specified by:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html#close()" title="class or interface in java.io" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html#close--"; title="class or interface in java.io" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> </dl> </section> </li> <li> <section class="detail" id="getKeys()"> <h3>getKeys</h3> -<div class="member-signature"><span class="modifiers">default</span> <span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/List.html"; title="class or interface in java.util" class="external-link">List</a><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-220">getKeys</a></span>()</div> +<div class="member-signature"><span class="modifiers">default</span> <span class="return-type"><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html"; title="class or interface in java.util" class="external-link">List</a><<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a>></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-220">getKeys</a></span>()</div> <div class="block">Gets a copy of the pool key list. <p> Note: The default implementation returns an empty list. @@ -489,7 +489,7 @@ extends <a href="https://docs.oracle.com <h3 id="invalidateObject(java.lang.Object,java.lang.Object)">invalidateObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-280">invalidateObject</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key, <a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">V</a> obj)</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="block">Invalidates an object from the pool. <p> By contract, <code>obj</code> <strong>must</strong> have been obtained @@ -507,7 +507,7 @@ extends <a href="https://docs.oracle.com <dd><code>key</code> - the key used to obtain the object</dd> <dd><code>obj</code> - a <a href="#borrowObject(K)"><code>borrowed</code></a> instance to be returned.</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> - if the instance cannot be invalidated</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> - if the instance cannot be invalidated</dd> </dl> </section> </li> @@ -517,7 +517,7 @@ extends <a href="https://docs.oracle.com <div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-303">invalidateObject</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key, <a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">V</a> obj, <a href="DestroyMode.html" title="enum in org.apache.commons.pool2">DestroyMode</a> destroyMode)</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="block">Invalidates an object from the pool, using the provided <a href="DestroyMode.html" title="enum in org.apache.commons.pool2"><code>DestroyMode</code></a>. <p> @@ -537,7 +537,7 @@ extends <a href="https://docs.oracle.com <dd><code>obj</code> - a <a href="#borrowObject(K)"><code>borrowed</code></a> instance to be returned.</dd> <dd><code>destroyMode</code> - destroy activation context provided to the factory</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> - if the instance cannot be invalidated</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> - if the instance cannot be invalidated</dd> <dt>Since:</dt> <dd>2.9.0</dd> </dl> @@ -548,7 +548,7 @@ extends <a href="https://docs.oracle.com <h3 id="returnObject(java.lang.Object,java.lang.Object)">returnObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedObjectPool.html#line-325">returnObject</a></span><wbr><span class="parameters">(<a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">K</a> key, <a href="KeyedObjectPool.html" title="type parameter in KeyedObjectPool">V</a> obj)</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="block">Return an instance to the pool. By contract, <code>obj</code> <strong>must</strong> have been obtained using <a href="#borrowObject(K)"><code>borrowObject</code></a> or a related method as defined in an @@ -559,12 +559,12 @@ extends <a href="https://docs.oracle.com <dd><code>key</code> - the key used to obtain the object</dd> <dd><code>obj</code> - a <a href="#borrowObject(K)"><code>borrowed</code></a> instance to be returned.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if an attempt is made to return an object to the pool that +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if an attempt is made to return an object to the pool that is in any state other than allocated (i.e. borrowed). Attempting to return an object more than once or attempting to return an object that was never borrowed from the pool will trigger this exception.</dd> -<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> - if an instance cannot be returned to the pool</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> - if an instance cannot be returned to the pool</dd> </dl> </section> </li>
Modified: websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedPooledObjectFactory.html ============================================================================== --- websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedPooledObjectFactory.html (original) +++ websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/KeyedPooledObjectFactory.html Sat Feb 8 20:08:04 2025 @@ -2,7 +2,7 @@ <html lang> <head> <!-- Generated by javadoc (17) --> -<title>KeyedPooledObjectFactory (Apache Commons Pool 2.12.1 API)</title> +<title>KeyedPooledObjectFactory (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, interface: KeyedPooledObjectFactory"> @@ -213,14 +213,14 @@ loadScripts(document, 'script');</script <h3 id="activateObject(java.lang.Object,org.apache.commons.pool2.PooledObject)">activateObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedPooledObjectFactory.html#line-87">activateObject</a></span><wbr><span class="parameters">(<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">K</a> key, <a href="PooledObject.html" title="interface in org.apache.commons.pool2">PooledObject</a><<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">V</a>> p)</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="block">Reinitializes an instance to be returned by the pool.</div> <dl class="notes"> <dt>Parameters:</dt> <dd><code>key</code> - the key used when selecting the object</dd> <dd><code>p</code> - a <code>PooledObject</code> wrapping the instance to be activated</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> - if there is a problem activating <code>obj</code>, +<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> - if there is a problem activating <code>obj</code>, this exception may be swallowed by the pool.</dd> <dt>See Also:</dt> <dd> @@ -236,7 +236,7 @@ loadScripts(document, 'script');</script <h3 id="destroyObject(java.lang.Object,org.apache.commons.pool2.PooledObject)">destroyObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedPooledObjectFactory.html#line-109">destroyObject</a></span><wbr><span class="parameters">(<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">K</a> key, <a href="PooledObject.html" title="interface in org.apache.commons.pool2">PooledObject</a><<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">V</a>> p)</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="block">Destroys an instance no longer needed by the pool. <p> It is important for implementations of this method to be aware that there @@ -252,7 +252,7 @@ loadScripts(document, 'script');</script <dd><code>key</code> - the key used when selecting the instance</dd> <dd><code>p</code> - a <code>PooledObject</code> wrapping the instance to be destroyed</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> - should be avoided as it may be swallowed by +<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> - should be avoided as it may be swallowed by the pool implementation.</dd> <dt>See Also:</dt> <dd> @@ -270,7 +270,7 @@ loadScripts(document, 'script');</script <div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedPooledObjectFactory.html#line-126">destroyObject</a></span><wbr><span class="parameters">(<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">K</a> key, <a href="PooledObject.html" title="interface in org.apache.commons.pool2">PooledObject</a><<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">V</a>> p, <a href="DestroyMode.html" title="enum in org.apache.commons.pool2">DestroyMode</a> destroyMode)</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="block">Destroys an instance no longer needed by the pool, using the provided <a href="DestroyMode.html" title="enum in org.apache.commons.pool2"><code>DestroyMode</code></a>.</div> <dl class="notes"> <dt>Parameters:</dt> @@ -278,7 +278,7 @@ loadScripts(document, 'script');</script <dd><code>p</code> - a <code>PooledObject</code> wrapping the instance to be destroyed</dd> <dd><code>destroyMode</code> - DestroyMode providing context to the factory</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> - should be avoided as it may be swallowed by +<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> - should be avoided as it may be swallowed by the pool implementation.</dd> <dt>Since:</dt> <dd>2.9.0</dd> @@ -298,7 +298,7 @@ loadScripts(document, 'script');</script <section class="detail" id="makeObject(K)"> <h3 id="makeObject(java.lang.Object)">makeObject</h3> <div class="member-signature"><span class="return-type"><a href="PooledObject.html" title="interface in org.apache.commons.pool2">PooledObject</a><<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">V</a>></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedPooledObjectFactory.html#line-141">makeObject</a></span><wbr><span class="parameters">(<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">K</a> key)</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="block">Creates an instance that can be served by the pool and wrap it in a <a href="PooledObject.html" title="interface in org.apache.commons.pool2"><code>PooledObject</code></a> to be managed by the pool.</div> <dl class="notes"> @@ -308,7 +308,7 @@ loadScripts(document, 'script');</script <dd>a <code>PooledObject</code> wrapping an instance that can be served by the pool.</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> - if there is a problem creating a new instance, +<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> - if there is a problem creating a new instance, this will be propagated to the code requesting an object.</dd> </dl> </section> @@ -318,14 +318,14 @@ loadScripts(document, 'script');</script <h3 id="passivateObject(java.lang.Object,org.apache.commons.pool2.PooledObject)">passivateObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/KeyedPooledObjectFactory.html#line-153">passivateObject</a></span><wbr><span class="parameters">(<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">K</a> key, <a href="PooledObject.html" title="interface in org.apache.commons.pool2">PooledObject</a><<a href="KeyedPooledObjectFactory.html" title="type parameter in KeyedPooledObjectFactory">V</a>> p)</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="block">Uninitializes an instance to be returned to the idle object pool.</div> <dl class="notes"> <dt>Parameters:</dt> <dd><code>key</code> - the key used when selecting the object</dd> <dd><code>p</code> - a <code>PooledObject</code> wrapping the instance to be passivated</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> - if there is a problem passivating <code>obj</code>, +<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> - if there is a problem passivating <code>obj</code>, this exception may be swallowed by the pool.</dd> <dt>See Also:</dt> <dd> Modified: websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/ObjectPool.html ============================================================================== --- websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/ObjectPool.html (original) +++ websites/production/commons/content/proper/commons-pool/apidocs/org/apache/commons/pool2/ObjectPool.html Sat Feb 8 20:08:04 2025 @@ -2,7 +2,7 @@ <html lang> <head> <!-- Generated by javadoc (17) --> -<title>ObjectPool (Apache Commons Pool 2.12.1 API)</title> +<title>ObjectPool (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, interface: ObjectPool"> @@ -79,7 +79,7 @@ loadScripts(document, 'script');</script </dl> <dl class="notes"> <dt>All Superinterfaces:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> </dl> <dl class="notes"> <dt>All Known Implementing Classes:</dt> @@ -87,7 +87,7 @@ loadScripts(document, 'script');</script </dl> <hr> <div class="type-signature"><span class="modifiers">public interface </span><span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-60">ObjectPool</a><T></span><span class="extends-implements"> -extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></span></div> +extends <a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></span></div> <div class="block">A pooling simple interface. <p> Example of use: @@ -215,16 +215,16 @@ extends <a href="https://docs.oracle.com <section class="detail" id="addObject()"> <h3>addObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-75">addObject</a></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="block">Creates an object using the <a href="PooledObjectFactory.html" title="interface in org.apache.commons.pool2"><code>factory</code></a> or other implementation dependent mechanism, passivate it, and then place it in the idle object pool. <code>addObject</code> is useful for "pre-loading" a pool with idle objects. (Optional operation).</div> <dl class="notes"> <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="PooledObjectFactory.html#makeObject()"><code>PooledObjectFactory.makeObject()</code></a> fails.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close()</code></a> has been called on this pool.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this pool cannot add new idle objects.</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="PooledObjectFactory.html#makeObject()"><code>PooledObjectFactory.makeObject()</code></a> fails.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close()</code></a> has been called on this pool.</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - when this pool cannot add new idle objects.</dd> </dl> </section> </li> @@ -232,14 +232,14 @@ extends <a href="https://docs.oracle.com <section class="detail" id="addObjects(int)"> <h3>addObjects</h3> <div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-86">addObjects</a></span><wbr><span class="parameters">(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="block">Calls <a href="#addObject()"><code>addObject()</code></a> <code>count</code> number of times.</div> <dl class="notes"> <dt>Parameters:</dt> <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> - See <a href="#addObject()"><code>addObject()</code></a>.</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> - See <a href="#addObject()"><code>addObject()</code></a>.</dd> <dt>Since:</dt> <dd>2.8.0</dd> </dl> @@ -249,7 +249,7 @@ extends <a href="https://docs.oracle.com <section class="detail" id="borrowObject()"> <h3>borrowObject</h3> <div class="member-signature"><span class="return-type"><a href="ObjectPool.html" title="type parameter in ObjectPool">T</a></span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-122">borrowObject</a></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="block">Borrows an instance from this pool. <p> Instances returned from this method will have been either newly created @@ -272,10 +272,10 @@ extends <a href="https://docs.oracle.com <dt>Returns:</dt> <dd>an instance from this pool.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close</code></a> has been called on this pool.</dd> -<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="PooledObjectFactory.html#makeObject()"><code>PooledObjectFactory.makeObject()</code></a> throws an +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - after <a href="#close()"><code>close</code></a> has been called on this pool.</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="PooledObjectFactory.html#makeObject()"><code>PooledObjectFactory.makeObject()</code></a> throws an exception.</dd> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/NoSuchElementException.html"; title="class or interface in java.util" class="external-link">NoSuchElementException</a></code> - when the pool is exhausted and cannot or will not return +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/NoSuchElementException.html"; title="class or interface in java.util" class="external-link">NoSuchElementException</a></code> - when the pool is exhausted and cannot or will not return another instance.</dd> </dl> </section> @@ -284,14 +284,14 @@ extends <a href="https://docs.oracle.com <section class="detail" id="clear()"> <h3>clear</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-134">clear</a></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="block">Clears any objects sitting idle in the pool, releasing any associated resources (optional operation). Idle objects cleared must be <a href="PooledObjectFactory.html#destroyObject(org.apache.commons.pool2.PooledObject)"><code>PooledObjectFactory.destroyObject(PooledObject)</code></a>.</div> <dl class="notes"> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - if this implementation does not support the operation</dd> -<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> - if the pool cannot be cleared</dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/UnsupportedOperationException.html"; title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - if this implementation does not support the operation</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> - if the pool cannot be cleared</dd> </dl> </section> </li> @@ -302,16 +302,16 @@ extends <a href="https://docs.oracle.com <div class="block">Closes this pool, and free any resources associated with it. <p> Calling <a href="#addObject()"><code>addObject()</code></a> or <a href="#borrowObject()"><code>borrowObject()</code></a> after invoking this - method on a pool will cause them to throw an <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link"><code>IllegalStateException</code></a>. + method on a pool will cause them to throw an <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link"><code>IllegalStateException</code></a>. </p> <p> Implementations should silently fail if not all resources can be freed. </p></div> <dl class="notes"> <dt>Specified by:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html#close()" title="class or interface in java.lang" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html#close--"; title="class or interface in java.lang" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"; title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd> <dt>Specified by:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html#close()" title="class or interface in java.io" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html#close--"; title="class or interface in java.io" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; title="class or interface in java.io" class="external-link">Closeable</a></code></dd> </dl> </section> </li> @@ -345,7 +345,7 @@ extends <a href="https://docs.oracle.com <section class="detail" id="invalidateObject(T)"> <h3 id="invalidateObject(java.lang.Object)">invalidateObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-180">invalidateObject</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="type parameter in ObjectPool">T</a> obj)</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="block">Invalidates an object from the pool. <p> By contract, <code>obj</code> <strong>must</strong> have been obtained @@ -360,7 +360,7 @@ extends <a href="https://docs.oracle.com <dt>Parameters:</dt> <dd><code>obj</code> - a <a href="#borrowObject()"><code>borrowed</code></a> instance to be disposed.</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> - if the instance cannot be invalidated</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> - if the instance cannot be invalidated</dd> </dl> </section> </li> @@ -369,7 +369,7 @@ extends <a href="https://docs.oracle.com <h3 id="invalidateObject(java.lang.Object,org.apache.commons.pool2.DestroyMode)">invalidateObject</h3> <div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-200">invalidateObject</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="type parameter in ObjectPool">T</a> obj, <a href="DestroyMode.html" title="enum in org.apache.commons.pool2">DestroyMode</a> destroyMode)</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="block">Invalidates an object from the pool, using the provided <a href="DestroyMode.html" title="enum in org.apache.commons.pool2"><code>DestroyMode</code></a> <p> @@ -386,7 +386,7 @@ extends <a href="https://docs.oracle.com <dd><code>obj</code> - a <a href="#borrowObject()"><code>borrowed</code></a> instance to be disposed.</dd> <dd><code>destroyMode</code> - destroy activation context provided to the factory</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> - if the instance cannot be invalidated</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> - if the instance cannot be invalidated</dd> <dt>Since:</dt> <dd>2.9.0</dd> </dl> @@ -396,7 +396,7 @@ extends <a href="https://docs.oracle.com <section class="detail" id="returnObject(T)"> <h3 id="returnObject(java.lang.Object)">returnObject</h3> <div class="member-signature"><span class="return-type">void</span> <span class="element-name"><a href="../../../../src-html/org/apache/commons/pool2/ObjectPool.html#line-219">returnObject</a></span><wbr><span class="parameters">(<a href="ObjectPool.html" title="type parameter in ObjectPool">T</a> obj)</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="block">Returns an instance to the pool. By contract, <code>obj</code> <strong>must</strong> have been obtained using <a href="#borrowObject()"><code>borrowObject()</code></a> or a related method as defined in an implementation or sub-interface.</div> @@ -404,12 +404,12 @@ extends <a href="https://docs.oracle.com <dt>Parameters:</dt> <dd><code>obj</code> - a <a href="#borrowObject()"><code>borrowed</code></a> instance to be returned.</dd> <dt>Throws:</dt> -<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if an attempt is made to return an object to the pool that +<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalStateException.html"; title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if an attempt is made to return an object to the pool that is in any state other than allocated (i.e. borrowed). Attempting to return an object more than once or attempting to return an object that was never borrowed from the pool will trigger this exception.</dd> -<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> - if an instance cannot be returned to the pool</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> - if an instance cannot be returned to the pool</dd> </dl> </section> </li>
