svn commit: r1088934 [16/37] - in /websites/production/commons/content/proper/commons-pool: ./ apidocs/ apidocs/org/apache/commons/pool2/ apidocs/org/apache/commons/pool2/class-use/ apidocs/org/apache/commons/pool2/impl/ apidocs/org/apache/commons/pool...

Sat, 08 Feb 2025 12:24:22 -0800 

Modified: 
websites/production/commons/content/proper/commons-pool/apidocs/overview-tree.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-pool/apidocs/overview-tree.html
 (original)
+++ 
websites/production/commons/content/proper/commons-pool/apidocs/overview-tree.html
 Sat Feb  8 20:08:04 2025
@@ -2,7 +2,7 @@
 <html lang>
 <head>
 <!-- Generated by javadoc (17) -->
-<title>Class Hierarchy (Apache Commons Pool 2.12.1 API)</title>
+<title>Class Hierarchy (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="class tree">
@@ -60,12 +60,12 @@ loadScripts(document, 'script');</script
 <section class="hierarchy">
 <h2 title="Class Hierarchy">Class Hierarchy</h2>
 <ul>
-<li class="circle">java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html";
 class="type-name-link external-link" title="class or interface in 
java.lang">Object</a>
+<li class="circle">java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html"; 
class="type-name-link external-link" title="class or interface in 
java.lang">Object</a>
 <ul>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/AbandonedConfig.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">AbandonedConfig</a></li>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/BaseObject.html" class="type-name-link" 
title="class in org.apache.commons.pool2">BaseObject</a>
 <ul>
-<li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/BaseGenericObjectPool.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">BaseGenericObjectPool</a>&lt;T&gt; (implements 
java.lang.<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>)
+<li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/BaseGenericObjectPool.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">BaseGenericObjectPool</a>&lt;T&gt; (implements 
java.lang.<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>)
 <ul>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericKeyedObjectPool.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">GenericKeyedObjectPool</a>&lt;K,<wbr>T&gt; 
(implements org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericKeyedObjectPoolMXBean.html" 
title="interface in 
org.apache.commons.pool2.impl">GenericKeyedObjectPoolMXBean</a>&lt;K&gt;, 
org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/KeyedObjectPool.html" title="interface in 
org.apache.commons.pool2">KeyedObjectPool</a>&lt;K,<wbr>V&gt;, 
org.apache.commons.pool2.<a href="org/apache/commons/pool2/UsageTracking.html" 
title="interface in org.apache.commons.pool2">UsageTracking</a>&lt;T&gt;)</li>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericObjectPool.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">GenericObjectPool</a>&lt;T&gt; (implements 
org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericObjectPoolMXBean.html" 
title="interface in org.apache.commons.pool2.impl">GenericObjectPoolMXBean</a>, 
org.apache.commons.pool2.<a href="org/apache/commons/pool2/ObjectPool.html" 
title="interface in org.apache.commons.pool2">ObjectPool</a>&lt;T&gt;, 
org.apache.commons.pool2.<a href="org/apache/commons/pool2/UsageTracking.html" 
title="interface in org.apache.commons.pool2">UsageTracking</a>&lt;T&gt;)</li>
@@ -77,7 +77,7 @@ loadScripts(document, 'script');</script
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/SoftReferenceObjectPool.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">SoftReferenceObjectPool</a>&lt;T&gt;</li>
 </ul>
 </li>
-<li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/BaseObjectPoolConfig.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">BaseObjectPoolConfig</a>&lt;T&gt; (implements 
java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Cloneable.html";
 title="class or interface in java.lang" class="external-link">Cloneable</a>)
+<li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/BaseObjectPoolConfig.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">BaseObjectPoolConfig</a>&lt;T&gt; (implements 
java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneable.html"; 
title="class or interface in java.lang" class="external-link">Cloneable</a>)
 <ul>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericKeyedObjectPoolConfig.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">GenericKeyedObjectPoolConfig</a>&lt;T&gt;</li>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/GenericObjectPoolConfig.html" 
class="type-name-link" title="class in 
org.apache.commons.pool2.impl">GenericObjectPoolConfig</a>&lt;T&gt;</li>
@@ -110,9 +110,9 @@ loadScripts(document, 'script');</script
 <section class="hierarchy">
 <h2 title="Interface Hierarchy">Interface Hierarchy</h2>
 <ul>
-<li class="circle">java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html";
 class="type-name-link external-link" title="class or interface in 
java.lang">AutoCloseable</a>
+<li class="circle">java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html"; 
class="type-name-link external-link" title="class or interface in 
java.lang">AutoCloseable</a>
 <ul>
-<li class="circle">java.io.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Closeable.html";
 class="type-name-link external-link" title="class or interface in 
java.io">Closeable</a>
+<li class="circle">java.io.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html"; 
class="type-name-link external-link" title="class or interface in 
java.io">Closeable</a>
 <ul>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/KeyedObjectPool.html" class="type-name-link" 
title="interface in 
org.apache.commons.pool2">KeyedObjectPool</a>&lt;K,<wbr>V&gt;</li>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/ObjectPool.html" class="type-name-link" 
title="interface in org.apache.commons.pool2">ObjectPool</a>&lt;T&gt;</li>
@@ -121,7 +121,7 @@ loadScripts(document, 'script');</script
 </ul>
 </li>
 <li class="circle">org.apache.commons.pool2.impl.<a 
href="org/apache/commons/pool2/impl/CallStack.html" class="type-name-link" 
title="interface in org.apache.commons.pool2.impl">CallStack</a></li>
-<li class="circle">java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Comparable.html";
 class="type-name-link external-link" title="class or interface in 
java.lang">Comparable</a>&lt;T&gt;
+<li class="circle">java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Comparable.html"; 
class="type-name-link external-link" title="class or interface in 
java.lang">Comparable</a>&lt;T&gt;
 <ul>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/PooledObject.html" class="type-name-link" 
title="interface in org.apache.commons.pool2">PooledObject</a>&lt;T&gt;</li>
 </ul>
@@ -140,9 +140,9 @@ loadScripts(document, 'script');</script
 <section class="hierarchy">
 <h2 title="Enum Hierarchy">Enum Hierarchy</h2>
 <ul>
-<li class="circle">java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html";
 class="type-name-link external-link" title="class or interface in 
java.lang">Object</a>
+<li class="circle">java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html"; 
class="type-name-link external-link" title="class or interface in 
java.lang">Object</a>
 <ul>
-<li class="circle">java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Enum.html";
 class="type-name-link external-link" title="class or interface in 
java.lang">Enum</a>&lt;E&gt; (implements java.lang.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Comparable.html";
 title="class or interface in java.lang" 
class="external-link">Comparable</a>&lt;T&gt;, java.io.<a 
href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Serializable.html";
 title="class or interface in java.io" class="external-link">Serializable</a>)
+<li class="circle">java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html"; 
class="type-name-link external-link" title="class or interface in 
java.lang">Enum</a>&lt;E&gt; (implements java.lang.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/lang/Comparable.html"; 
title="class or interface in java.lang" 
class="external-link">Comparable</a>&lt;T&gt;, java.io.<a 
href="https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html"; 
title="class or interface in java.io" class="external-link">Serializable</a>)
 <ul>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/DestroyMode.html" class="type-name-link" 
title="enum in org.apache.commons.pool2">DestroyMode</a></li>
 <li class="circle">org.apache.commons.pool2.<a 
href="org/apache/commons/pool2/PooledObjectState.html" class="type-name-link" 
title="enum in org.apache.commons.pool2">PooledObjectState</a></li>

Modified: 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseKeyedPooledObjectFactory.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseKeyedPooledObjectFactory.html
 (original)
+++ 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseKeyedPooledObjectFactory.html
 Sat Feb  8 20:08:04 2025
@@ -48,87 +48,94 @@
 <span class="source-line-no">035</span><span id="line-35">public abstract 
class BaseKeyedPooledObjectFactory&lt;K, V&gt; extends BaseObject implements 
KeyedPooledObjectFactory&lt;K, V&gt; {</span>
 <span class="source-line-no">036</span><span id="line-36"></span>
 <span class="source-line-no">037</span><span id="line-37">    /**</span>
-<span class="source-line-no">038</span><span id="line-38">     * Reinitializes 
an instance to be returned by the pool.</span>
-<span class="source-line-no">039</span><span id="line-39">     * 
&lt;p&gt;</span>
-<span class="source-line-no">040</span><span id="line-40">     * The default 
implementation is a no-op.</span>
-<span class="source-line-no">041</span><span id="line-41">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">042</span><span id="line-42">     *</span>
-<span class="source-line-no">043</span><span id="line-43">     * @param key 
the key used when selecting the object</span>
-<span class="source-line-no">044</span><span id="line-44">     * @param p a 
{@code PooledObject} wrapping the instance to be activated</span>
-<span class="source-line-no">045</span><span id="line-45">     */</span>
-<span class="source-line-no">046</span><span id="line-46">    @Override</span>
-<span class="source-line-no">047</span><span id="line-47">    public void 
activateObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
-<span class="source-line-no">048</span><span id="line-48">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">049</span><span id="line-49">    }</span>
-<span class="source-line-no">050</span><span id="line-50"></span>
-<span class="source-line-no">051</span><span id="line-51">    /**</span>
-<span class="source-line-no">052</span><span id="line-52">     * Creates an 
instance that can be served by the pool.</span>
-<span class="source-line-no">053</span><span id="line-53">     *</span>
-<span class="source-line-no">054</span><span id="line-54">     * @param key 
the key used when constructing the object</span>
-<span class="source-line-no">055</span><span id="line-55">     * @return an 
instance that can be served by the pool</span>
-<span class="source-line-no">056</span><span id="line-56">     * @throws 
Exception if there is a problem creating a new instance,</span>
-<span class="source-line-no">057</span><span id="line-57">     *    this will 
be propagated to the code requesting an object.</span>
-<span class="source-line-no">058</span><span id="line-58">     */</span>
-<span class="source-line-no">059</span><span id="line-59">    public abstract 
V create(K key) throws Exception;</span>
-<span class="source-line-no">060</span><span id="line-60"></span>
-<span class="source-line-no">061</span><span id="line-61">    /**</span>
-<span class="source-line-no">062</span><span id="line-62">     * Destroys an 
instance no longer needed by the pool.</span>
-<span class="source-line-no">063</span><span id="line-63">     * 
&lt;p&gt;</span>
-<span class="source-line-no">064</span><span id="line-64">     * The default 
implementation is a no-op.</span>
-<span class="source-line-no">065</span><span id="line-65">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">066</span><span id="line-66">     *</span>
-<span class="source-line-no">067</span><span id="line-67">     * @param key 
the key used when selecting the instance</span>
-<span class="source-line-no">068</span><span id="line-68">     * @param p a 
{@code PooledObject} wrapping the instance to be destroyed</span>
-<span class="source-line-no">069</span><span id="line-69">     */</span>
-<span class="source-line-no">070</span><span id="line-70">    @Override</span>
-<span class="source-line-no">071</span><span id="line-71">    public void 
destroyObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
-<span class="source-line-no">072</span><span id="line-72">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">073</span><span id="line-73">    }</span>
-<span class="source-line-no">074</span><span id="line-74"></span>
-<span class="source-line-no">075</span><span id="line-75">    @Override</span>
-<span class="source-line-no">076</span><span id="line-76">    public 
PooledObject&lt;V&gt; makeObject(final K key) throws Exception {</span>
-<span class="source-line-no">077</span><span id="line-77">        return 
wrap(</span>
-<span class="source-line-no">078</span><span id="line-78">                
Objects.requireNonNull(create(key), () -&gt; 
String.format("BaseKeyedPooledObjectFactory(%s).create(key=%s) = null", 
getClass().getName(), key)));</span>
-<span class="source-line-no">079</span><span id="line-79">    }</span>
-<span class="source-line-no">080</span><span id="line-80"></span>
-<span class="source-line-no">081</span><span id="line-81">    /**</span>
-<span class="source-line-no">082</span><span id="line-82">     * Uninitializes 
an instance to be returned to the idle object pool.</span>
-<span class="source-line-no">083</span><span id="line-83">     * 
&lt;p&gt;</span>
-<span class="source-line-no">084</span><span id="line-84">     * The default 
implementation is a no-op.</span>
-<span class="source-line-no">085</span><span id="line-85">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">086</span><span id="line-86">     *</span>
-<span class="source-line-no">087</span><span id="line-87">     * @param key 
the key used when selecting the object</span>
-<span class="source-line-no">088</span><span id="line-88">     * @param p a 
{@code PooledObject} wrapping the instance to be passivated</span>
-<span class="source-line-no">089</span><span id="line-89">     */</span>
-<span class="source-line-no">090</span><span id="line-90">    @Override</span>
-<span class="source-line-no">091</span><span id="line-91">    public void 
passivateObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
-<span class="source-line-no">092</span><span id="line-92">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">093</span><span id="line-93">    }</span>
-<span class="source-line-no">094</span><span id="line-94"></span>
-<span class="source-line-no">095</span><span id="line-95">    /**</span>
-<span class="source-line-no">096</span><span id="line-96">     * Ensures that 
the instance is safe to be returned by the pool.</span>
-<span class="source-line-no">097</span><span id="line-97">     * 
&lt;p&gt;</span>
-<span class="source-line-no">098</span><span id="line-98">     * The default 
implementation always returns {@code true}.</span>
-<span class="source-line-no">099</span><span id="line-99">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">100</span><span id="line-100">     *</span>
-<span class="source-line-no">101</span><span id="line-101">     * @param key 
the key used when selecting the object</span>
-<span class="source-line-no">102</span><span id="line-102">     * @param p a 
{@code PooledObject} wrapping the instance to be validated</span>
-<span class="source-line-no">103</span><span id="line-103">     * @return 
always {@code true} in this default implementation</span>
-<span class="source-line-no">104</span><span id="line-104">     */</span>
-<span class="source-line-no">105</span><span id="line-105">    @Override</span>
-<span class="source-line-no">106</span><span id="line-106">    public boolean 
validateObject(final K key, final PooledObject&lt;V&gt; p) {</span>
-<span class="source-line-no">107</span><span id="line-107">        return 
true;</span>
-<span class="source-line-no">108</span><span id="line-108">    }</span>
-<span class="source-line-no">109</span><span id="line-109"></span>
-<span class="source-line-no">110</span><span id="line-110">    /**</span>
-<span class="source-line-no">111</span><span id="line-111">     * Wraps the 
provided instance with an implementation of</span>
-<span class="source-line-no">112</span><span id="line-112">     * {@link 
PooledObject}.</span>
-<span class="source-line-no">113</span><span id="line-113">     *</span>
-<span class="source-line-no">114</span><span id="line-114">     * @param value 
the instance to wrap, should not be null.</span>
-<span class="source-line-no">115</span><span id="line-115">     * @return The 
provided instance, wrapped by a {@link PooledObject}</span>
-<span class="source-line-no">116</span><span id="line-116">     */</span>
-<span class="source-line-no">117</span><span id="line-117">    public abstract 
PooledObject&lt;V&gt; wrap(V value);</span>
-<span class="source-line-no">118</span><span id="line-118">}</span>
+<span class="source-line-no">038</span><span id="line-38">     * Constructs a 
new instance.</span>
+<span class="source-line-no">039</span><span id="line-39">     */</span>
+<span class="source-line-no">040</span><span id="line-40">    public 
BaseKeyedPooledObjectFactory() {</span>
+<span class="source-line-no">041</span><span id="line-41">        // 
empty</span>
+<span class="source-line-no">042</span><span id="line-42">    }</span>
+<span class="source-line-no">043</span><span id="line-43"></span>
+<span class="source-line-no">044</span><span id="line-44">    /**</span>
+<span class="source-line-no">045</span><span id="line-45">     * Reinitializes 
an instance to be returned by the pool.</span>
+<span class="source-line-no">046</span><span id="line-46">     * 
&lt;p&gt;</span>
+<span class="source-line-no">047</span><span id="line-47">     * The default 
implementation is a no-op.</span>
+<span class="source-line-no">048</span><span id="line-48">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">049</span><span id="line-49">     *</span>
+<span class="source-line-no">050</span><span id="line-50">     * @param key 
the key used when selecting the object</span>
+<span class="source-line-no">051</span><span id="line-51">     * @param p a 
{@code PooledObject} wrapping the instance to be activated</span>
+<span class="source-line-no">052</span><span id="line-52">     */</span>
+<span class="source-line-no">053</span><span id="line-53">    @Override</span>
+<span class="source-line-no">054</span><span id="line-54">    public void 
activateObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
+<span class="source-line-no">055</span><span id="line-55">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">056</span><span id="line-56">    }</span>
+<span class="source-line-no">057</span><span id="line-57"></span>
+<span class="source-line-no">058</span><span id="line-58">    /**</span>
+<span class="source-line-no">059</span><span id="line-59">     * Creates an 
instance that can be served by the pool.</span>
+<span class="source-line-no">060</span><span id="line-60">     *</span>
+<span class="source-line-no">061</span><span id="line-61">     * @param key 
the key used when constructing the object</span>
+<span class="source-line-no">062</span><span id="line-62">     * @return an 
instance that can be served by the pool</span>
+<span class="source-line-no">063</span><span id="line-63">     * @throws 
Exception if there is a problem creating a new instance,</span>
+<span class="source-line-no">064</span><span id="line-64">     *    this will 
be propagated to the code requesting an object.</span>
+<span class="source-line-no">065</span><span id="line-65">     */</span>
+<span class="source-line-no">066</span><span id="line-66">    public abstract 
V create(K key) throws Exception;</span>
+<span class="source-line-no">067</span><span id="line-67"></span>
+<span class="source-line-no">068</span><span id="line-68">    /**</span>
+<span class="source-line-no">069</span><span id="line-69">     * Destroys an 
instance no longer needed by the pool.</span>
+<span class="source-line-no">070</span><span id="line-70">     * 
&lt;p&gt;</span>
+<span class="source-line-no">071</span><span id="line-71">     * The default 
implementation is a no-op.</span>
+<span class="source-line-no">072</span><span id="line-72">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">073</span><span id="line-73">     *</span>
+<span class="source-line-no">074</span><span id="line-74">     * @param key 
the key used when selecting the instance</span>
+<span class="source-line-no">075</span><span id="line-75">     * @param p a 
{@code PooledObject} wrapping the instance to be destroyed</span>
+<span class="source-line-no">076</span><span id="line-76">     */</span>
+<span class="source-line-no">077</span><span id="line-77">    @Override</span>
+<span class="source-line-no">078</span><span id="line-78">    public void 
destroyObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
+<span class="source-line-no">079</span><span id="line-79">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">080</span><span id="line-80">    }</span>
+<span class="source-line-no">081</span><span id="line-81"></span>
+<span class="source-line-no">082</span><span id="line-82">    @Override</span>
+<span class="source-line-no">083</span><span id="line-83">    public 
PooledObject&lt;V&gt; makeObject(final K key) throws Exception {</span>
+<span class="source-line-no">084</span><span id="line-84">        return 
wrap(</span>
+<span class="source-line-no">085</span><span id="line-85">                
Objects.requireNonNull(create(key), () -&gt; 
String.format("BaseKeyedPooledObjectFactory(%s).create(key=%s) = null", 
getClass().getName(), key)));</span>
+<span class="source-line-no">086</span><span id="line-86">    }</span>
+<span class="source-line-no">087</span><span id="line-87"></span>
+<span class="source-line-no">088</span><span id="line-88">    /**</span>
+<span class="source-line-no">089</span><span id="line-89">     * Uninitializes 
an instance to be returned to the idle object pool.</span>
+<span class="source-line-no">090</span><span id="line-90">     * 
&lt;p&gt;</span>
+<span class="source-line-no">091</span><span id="line-91">     * The default 
implementation is a no-op.</span>
+<span class="source-line-no">092</span><span id="line-92">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">093</span><span id="line-93">     *</span>
+<span class="source-line-no">094</span><span id="line-94">     * @param key 
the key used when selecting the object</span>
+<span class="source-line-no">095</span><span id="line-95">     * @param p a 
{@code PooledObject} wrapping the instance to be passivated</span>
+<span class="source-line-no">096</span><span id="line-96">     */</span>
+<span class="source-line-no">097</span><span id="line-97">    @Override</span>
+<span class="source-line-no">098</span><span id="line-98">    public void 
passivateObject(final K key, final PooledObject&lt;V&gt; p) throws Exception 
{</span>
+<span class="source-line-no">099</span><span id="line-99">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">100</span><span id="line-100">    }</span>
+<span class="source-line-no">101</span><span id="line-101"></span>
+<span class="source-line-no">102</span><span id="line-102">    /**</span>
+<span class="source-line-no">103</span><span id="line-103">     * Ensures that 
the instance is safe to be returned by the pool.</span>
+<span class="source-line-no">104</span><span id="line-104">     * 
&lt;p&gt;</span>
+<span class="source-line-no">105</span><span id="line-105">     * The default 
implementation always returns {@code true}.</span>
+<span class="source-line-no">106</span><span id="line-106">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">107</span><span id="line-107">     *</span>
+<span class="source-line-no">108</span><span id="line-108">     * @param key 
the key used when selecting the object</span>
+<span class="source-line-no">109</span><span id="line-109">     * @param p a 
{@code PooledObject} wrapping the instance to be validated</span>
+<span class="source-line-no">110</span><span id="line-110">     * @return 
always {@code true} in this default implementation</span>
+<span class="source-line-no">111</span><span id="line-111">     */</span>
+<span class="source-line-no">112</span><span id="line-112">    @Override</span>
+<span class="source-line-no">113</span><span id="line-113">    public boolean 
validateObject(final K key, final PooledObject&lt;V&gt; p) {</span>
+<span class="source-line-no">114</span><span id="line-114">        return 
true;</span>
+<span class="source-line-no">115</span><span id="line-115">    }</span>
+<span class="source-line-no">116</span><span id="line-116"></span>
+<span class="source-line-no">117</span><span id="line-117">    /**</span>
+<span class="source-line-no">118</span><span id="line-118">     * Wraps the 
provided instance with an implementation of</span>
+<span class="source-line-no">119</span><span id="line-119">     * {@link 
PooledObject}.</span>
+<span class="source-line-no">120</span><span id="line-120">     *</span>
+<span class="source-line-no">121</span><span id="line-121">     * @param value 
the instance to wrap, should not be null.</span>
+<span class="source-line-no">122</span><span id="line-122">     * @return The 
provided instance, wrapped by a {@link PooledObject}</span>
+<span class="source-line-no">123</span><span id="line-123">     */</span>
+<span class="source-line-no">124</span><span id="line-124">    public abstract 
PooledObject&lt;V&gt; wrap(V value);</span>
+<span class="source-line-no">125</span><span id="line-125">}</span>
 
 
 

Modified: 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObject.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObject.html
 (original)
+++ 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObject.html
 Sat Feb  8 20:08:04 2025
@@ -36,26 +36,33 @@
 <span class="source-line-no">023</span><span id="line-23"> */</span>
 <span class="source-line-no">024</span><span id="line-24">public abstract 
class BaseObject {</span>
 <span class="source-line-no">025</span><span id="line-25"></span>
-<span class="source-line-no">026</span><span id="line-26">    @Override</span>
-<span class="source-line-no">027</span><span id="line-27">    public String 
toString() {</span>
-<span class="source-line-no">028</span><span id="line-28">        final 
StringBuilder builder = new StringBuilder();</span>
-<span class="source-line-no">029</span><span id="line-29">        
builder.append(getClass().getSimpleName());</span>
-<span class="source-line-no">030</span><span id="line-30">        
builder.append(" [");</span>
-<span class="source-line-no">031</span><span id="line-31">        
toStringAppendFields(builder);</span>
-<span class="source-line-no">032</span><span id="line-32">        
builder.append("]");</span>
-<span class="source-line-no">033</span><span id="line-33">        return 
builder.toString();</span>
-<span class="source-line-no">034</span><span id="line-34">    }</span>
-<span class="source-line-no">035</span><span id="line-35"></span>
-<span class="source-line-no">036</span><span id="line-36">    /**</span>
-<span class="source-line-no">037</span><span id="line-37">     * Used by 
sub-classes to include the fields defined by the sub-class in the</span>
-<span class="source-line-no">038</span><span id="line-38">     * {@link 
#toString()} output.</span>
-<span class="source-line-no">039</span><span id="line-39">     *</span>
-<span class="source-line-no">040</span><span id="line-40">     * @param 
builder Field names and values are appended to this object</span>
-<span class="source-line-no">041</span><span id="line-41">     */</span>
-<span class="source-line-no">042</span><span id="line-42">    protected void 
toStringAppendFields(final StringBuilder builder) {</span>
-<span class="source-line-no">043</span><span id="line-43">        // do 
nothing by default, needed for b/w compatibility.</span>
-<span class="source-line-no">044</span><span id="line-44">    }</span>
-<span class="source-line-no">045</span><span id="line-45">}</span>
+<span class="source-line-no">026</span><span id="line-26">    /**</span>
+<span class="source-line-no">027</span><span id="line-27">     * Constructs a 
new instance.</span>
+<span class="source-line-no">028</span><span id="line-28">     */</span>
+<span class="source-line-no">029</span><span id="line-29">    public 
BaseObject() {</span>
+<span class="source-line-no">030</span><span id="line-30">        // 
empty</span>
+<span class="source-line-no">031</span><span id="line-31">    }</span>
+<span class="source-line-no">032</span><span id="line-32"></span>
+<span class="source-line-no">033</span><span id="line-33">    @Override</span>
+<span class="source-line-no">034</span><span id="line-34">    public String 
toString() {</span>
+<span class="source-line-no">035</span><span id="line-35">        final 
StringBuilder builder = new StringBuilder();</span>
+<span class="source-line-no">036</span><span id="line-36">        
builder.append(getClass().getSimpleName());</span>
+<span class="source-line-no">037</span><span id="line-37">        
builder.append(" [");</span>
+<span class="source-line-no">038</span><span id="line-38">        
toStringAppendFields(builder);</span>
+<span class="source-line-no">039</span><span id="line-39">        
builder.append("]");</span>
+<span class="source-line-no">040</span><span id="line-40">        return 
builder.toString();</span>
+<span class="source-line-no">041</span><span id="line-41">    }</span>
+<span class="source-line-no">042</span><span id="line-42"></span>
+<span class="source-line-no">043</span><span id="line-43">    /**</span>
+<span class="source-line-no">044</span><span id="line-44">     * Used by 
sub-classes to include the fields defined by the sub-class in the</span>
+<span class="source-line-no">045</span><span id="line-45">     * {@link 
#toString()} output.</span>
+<span class="source-line-no">046</span><span id="line-46">     *</span>
+<span class="source-line-no">047</span><span id="line-47">     * @param 
builder Field names and values are appended to this object</span>
+<span class="source-line-no">048</span><span id="line-48">     */</span>
+<span class="source-line-no">049</span><span id="line-49">    protected void 
toStringAppendFields(final StringBuilder builder) {</span>
+<span class="source-line-no">050</span><span id="line-50">        // do 
nothing by default, needed for b/w compatibility.</span>
+<span class="source-line-no">051</span><span id="line-51">    }</span>
+<span class="source-line-no">052</span><span id="line-52">}</span>
 
 
 

Modified: 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObjectPool.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObjectPool.html
 (original)
+++ 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BaseObjectPool.html
 Sat Feb  8 20:08:04 2025
@@ -45,97 +45,104 @@
 <span class="source-line-no">032</span><span id="line-32">    private volatile 
boolean closed;</span>
 <span class="source-line-no">033</span><span id="line-33"></span>
 <span class="source-line-no">034</span><span id="line-34">    /**</span>
-<span class="source-line-no">035</span><span id="line-35">     * Not supported 
in this base implementation. Subclasses should override</span>
-<span class="source-line-no">036</span><span id="line-36">     * this 
behavior.</span>
-<span class="source-line-no">037</span><span id="line-37">     *</span>
-<span class="source-line-no">038</span><span id="line-38">     * @throws 
UnsupportedOperationException if the pool does not implement this</span>
-<span class="source-line-no">039</span><span id="line-39">     *          
method</span>
-<span class="source-line-no">040</span><span id="line-40">     */</span>
-<span class="source-line-no">041</span><span id="line-41">    @Override</span>
-<span class="source-line-no">042</span><span id="line-42">    public void 
addObject() throws Exception {</span>
-<span class="source-line-no">043</span><span id="line-43">        throw new 
UnsupportedOperationException();</span>
-<span class="source-line-no">044</span><span id="line-44">    }</span>
-<span class="source-line-no">045</span><span id="line-45"></span>
-<span class="source-line-no">046</span><span id="line-46">    /**</span>
-<span class="source-line-no">047</span><span id="line-47">     * Throws an 
{@code IllegalStateException} when this pool has been</span>
-<span class="source-line-no">048</span><span id="line-48">     * closed.</span>
-<span class="source-line-no">049</span><span id="line-49">     *</span>
-<span class="source-line-no">050</span><span id="line-50">     * @throws 
IllegalStateException when this pool has been closed.</span>
-<span class="source-line-no">051</span><span id="line-51">     * @see 
#isClosed()</span>
-<span class="source-line-no">052</span><span id="line-52">     */</span>
-<span class="source-line-no">053</span><span id="line-53">    protected final 
void assertOpen() throws IllegalStateException {</span>
-<span class="source-line-no">054</span><span id="line-54">        if 
(isClosed()) {</span>
-<span class="source-line-no">055</span><span id="line-55">            throw 
new IllegalStateException("Pool not open");</span>
-<span class="source-line-no">056</span><span id="line-56">        }</span>
-<span class="source-line-no">057</span><span id="line-57">    }</span>
-<span class="source-line-no">058</span><span id="line-58"></span>
-<span class="source-line-no">059</span><span id="line-59">    @Override</span>
-<span class="source-line-no">060</span><span id="line-60">    public abstract 
T borrowObject() throws Exception;</span>
-<span class="source-line-no">061</span><span id="line-61"></span>
-<span class="source-line-no">062</span><span id="line-62">    /**</span>
-<span class="source-line-no">063</span><span id="line-63">     * Not supported 
in this base implementation.</span>
-<span class="source-line-no">064</span><span id="line-64">     *</span>
-<span class="source-line-no">065</span><span id="line-65">     * @throws 
UnsupportedOperationException if the pool does not implement this</span>
-<span class="source-line-no">066</span><span id="line-66">     *          
method</span>
-<span class="source-line-no">067</span><span id="line-67">     */</span>
-<span class="source-line-no">068</span><span id="line-68">    @Override</span>
-<span class="source-line-no">069</span><span id="line-69">    public void 
clear() throws Exception {</span>
-<span class="source-line-no">070</span><span id="line-70">        throw new 
UnsupportedOperationException();</span>
-<span class="source-line-no">071</span><span id="line-71">    }</span>
-<span class="source-line-no">072</span><span id="line-72"></span>
-<span class="source-line-no">073</span><span id="line-73">    /**</span>
-<span class="source-line-no">074</span><span id="line-74">     * 
{@inheritDoc}</span>
-<span class="source-line-no">075</span><span id="line-75">     * 
&lt;p&gt;</span>
-<span class="source-line-no">076</span><span id="line-76">     * This affects 
the behavior of {@code isClosed} and</span>
-<span class="source-line-no">077</span><span id="line-77">     * {@code 
assertOpen}.</span>
-<span class="source-line-no">078</span><span id="line-78">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">079</span><span id="line-79">     */</span>
-<span class="source-line-no">080</span><span id="line-80">    @Override</span>
-<span class="source-line-no">081</span><span id="line-81">    public void 
close() {</span>
-<span class="source-line-no">082</span><span id="line-82">        closed = 
true;</span>
-<span class="source-line-no">083</span><span id="line-83">    }</span>
-<span class="source-line-no">084</span><span id="line-84"></span>
-<span class="source-line-no">085</span><span id="line-85">    /**</span>
-<span class="source-line-no">086</span><span id="line-86">     * Not supported 
in this base implementation.</span>
-<span class="source-line-no">087</span><span id="line-87">     *</span>
-<span class="source-line-no">088</span><span id="line-88">     * @return a 
negative value.</span>
-<span class="source-line-no">089</span><span id="line-89">     */</span>
-<span class="source-line-no">090</span><span id="line-90">    @Override</span>
-<span class="source-line-no">091</span><span id="line-91">    public int 
getNumActive() {</span>
-<span class="source-line-no">092</span><span id="line-92">        return 
-1;</span>
-<span class="source-line-no">093</span><span id="line-93">    }</span>
-<span class="source-line-no">094</span><span id="line-94"></span>
-<span class="source-line-no">095</span><span id="line-95">    /**</span>
-<span class="source-line-no">096</span><span id="line-96">     * Not supported 
in this base implementation.</span>
-<span class="source-line-no">097</span><span id="line-97">     *</span>
-<span class="source-line-no">098</span><span id="line-98">     * @return a 
negative value.</span>
-<span class="source-line-no">099</span><span id="line-99">     */</span>
-<span class="source-line-no">100</span><span id="line-100">    @Override</span>
-<span class="source-line-no">101</span><span id="line-101">    public int 
getNumIdle() {</span>
-<span class="source-line-no">102</span><span id="line-102">        return 
-1;</span>
-<span class="source-line-no">103</span><span id="line-103">    }</span>
-<span class="source-line-no">104</span><span id="line-104"></span>
-<span class="source-line-no">105</span><span id="line-105">    @Override</span>
-<span class="source-line-no">106</span><span id="line-106">    public abstract 
void invalidateObject(T obj) throws Exception;</span>
-<span class="source-line-no">107</span><span id="line-107"></span>
-<span class="source-line-no">108</span><span id="line-108">    /**</span>
-<span class="source-line-no">109</span><span id="line-109">     * Has this 
pool instance been closed.</span>
-<span class="source-line-no">110</span><span id="line-110">     *</span>
-<span class="source-line-no">111</span><span id="line-111">     * @return 
{@code true} when this pool has been closed.</span>
-<span class="source-line-no">112</span><span id="line-112">     */</span>
-<span class="source-line-no">113</span><span id="line-113">    public final 
boolean isClosed() {</span>
-<span class="source-line-no">114</span><span id="line-114">        return 
closed;</span>
-<span class="source-line-no">115</span><span id="line-115">    }</span>
-<span class="source-line-no">116</span><span id="line-116"></span>
-<span class="source-line-no">117</span><span id="line-117">    @Override</span>
-<span class="source-line-no">118</span><span id="line-118">    public abstract 
void returnObject(T obj) throws Exception;</span>
-<span class="source-line-no">119</span><span id="line-119"></span>
-<span class="source-line-no">120</span><span id="line-120">    @Override</span>
-<span class="source-line-no">121</span><span id="line-121">    protected void 
toStringAppendFields(final StringBuilder builder) {</span>
-<span class="source-line-no">122</span><span id="line-122">        
builder.append("closed=");</span>
-<span class="source-line-no">123</span><span id="line-123">        
builder.append(closed);</span>
-<span class="source-line-no">124</span><span id="line-124">    }</span>
-<span class="source-line-no">125</span><span id="line-125">}</span>
+<span class="source-line-no">035</span><span id="line-35">     * Constructs a 
new instance.</span>
+<span class="source-line-no">036</span><span id="line-36">     */</span>
+<span class="source-line-no">037</span><span id="line-37">    public 
BaseObjectPool() {</span>
+<span class="source-line-no">038</span><span id="line-38">        // 
empty</span>
+<span class="source-line-no">039</span><span id="line-39">    }</span>
+<span class="source-line-no">040</span><span id="line-40"></span>
+<span class="source-line-no">041</span><span id="line-41">    /**</span>
+<span class="source-line-no">042</span><span id="line-42">     * Not supported 
in this base implementation. Subclasses should override</span>
+<span class="source-line-no">043</span><span id="line-43">     * this 
behavior.</span>
+<span class="source-line-no">044</span><span id="line-44">     *</span>
+<span class="source-line-no">045</span><span id="line-45">     * @throws 
UnsupportedOperationException if the pool does not implement this</span>
+<span class="source-line-no">046</span><span id="line-46">     *          
method</span>
+<span class="source-line-no">047</span><span id="line-47">     */</span>
+<span class="source-line-no">048</span><span id="line-48">    @Override</span>
+<span class="source-line-no">049</span><span id="line-49">    public void 
addObject() throws Exception {</span>
+<span class="source-line-no">050</span><span id="line-50">        throw new 
UnsupportedOperationException();</span>
+<span class="source-line-no">051</span><span id="line-51">    }</span>
+<span class="source-line-no">052</span><span id="line-52"></span>
+<span class="source-line-no">053</span><span id="line-53">    /**</span>
+<span class="source-line-no">054</span><span id="line-54">     * Throws an 
{@code IllegalStateException} when this pool has been</span>
+<span class="source-line-no">055</span><span id="line-55">     * closed.</span>
+<span class="source-line-no">056</span><span id="line-56">     *</span>
+<span class="source-line-no">057</span><span id="line-57">     * @throws 
IllegalStateException when this pool has been closed.</span>
+<span class="source-line-no">058</span><span id="line-58">     * @see 
#isClosed()</span>
+<span class="source-line-no">059</span><span id="line-59">     */</span>
+<span class="source-line-no">060</span><span id="line-60">    protected final 
void assertOpen() throws IllegalStateException {</span>
+<span class="source-line-no">061</span><span id="line-61">        if 
(isClosed()) {</span>
+<span class="source-line-no">062</span><span id="line-62">            throw 
new IllegalStateException("Pool not open");</span>
+<span class="source-line-no">063</span><span id="line-63">        }</span>
+<span class="source-line-no">064</span><span id="line-64">    }</span>
+<span class="source-line-no">065</span><span id="line-65"></span>
+<span class="source-line-no">066</span><span id="line-66">    @Override</span>
+<span class="source-line-no">067</span><span id="line-67">    public abstract 
T borrowObject() throws Exception;</span>
+<span class="source-line-no">068</span><span id="line-68"></span>
+<span class="source-line-no">069</span><span id="line-69">    /**</span>
+<span class="source-line-no">070</span><span id="line-70">     * Not supported 
in this base implementation.</span>
+<span class="source-line-no">071</span><span id="line-71">     *</span>
+<span class="source-line-no">072</span><span id="line-72">     * @throws 
UnsupportedOperationException if the pool does not implement this</span>
+<span class="source-line-no">073</span><span id="line-73">     *          
method</span>
+<span class="source-line-no">074</span><span id="line-74">     */</span>
+<span class="source-line-no">075</span><span id="line-75">    @Override</span>
+<span class="source-line-no">076</span><span id="line-76">    public void 
clear() throws Exception {</span>
+<span class="source-line-no">077</span><span id="line-77">        throw new 
UnsupportedOperationException();</span>
+<span class="source-line-no">078</span><span id="line-78">    }</span>
+<span class="source-line-no">079</span><span id="line-79"></span>
+<span class="source-line-no">080</span><span id="line-80">    /**</span>
+<span class="source-line-no">081</span><span id="line-81">     * 
{@inheritDoc}</span>
+<span class="source-line-no">082</span><span id="line-82">     * 
&lt;p&gt;</span>
+<span class="source-line-no">083</span><span id="line-83">     * This affects 
the behavior of {@code isClosed} and</span>
+<span class="source-line-no">084</span><span id="line-84">     * {@code 
assertOpen}.</span>
+<span class="source-line-no">085</span><span id="line-85">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">086</span><span id="line-86">     */</span>
+<span class="source-line-no">087</span><span id="line-87">    @Override</span>
+<span class="source-line-no">088</span><span id="line-88">    public void 
close() {</span>
+<span class="source-line-no">089</span><span id="line-89">        closed = 
true;</span>
+<span class="source-line-no">090</span><span id="line-90">    }</span>
+<span class="source-line-no">091</span><span id="line-91"></span>
+<span class="source-line-no">092</span><span id="line-92">    /**</span>
+<span class="source-line-no">093</span><span id="line-93">     * Not supported 
in this base implementation.</span>
+<span class="source-line-no">094</span><span id="line-94">     *</span>
+<span class="source-line-no">095</span><span id="line-95">     * @return a 
negative value.</span>
+<span class="source-line-no">096</span><span id="line-96">     */</span>
+<span class="source-line-no">097</span><span id="line-97">    @Override</span>
+<span class="source-line-no">098</span><span id="line-98">    public int 
getNumActive() {</span>
+<span class="source-line-no">099</span><span id="line-99">        return 
-1;</span>
+<span class="source-line-no">100</span><span id="line-100">    }</span>
+<span class="source-line-no">101</span><span id="line-101"></span>
+<span class="source-line-no">102</span><span id="line-102">    /**</span>
+<span class="source-line-no">103</span><span id="line-103">     * Not 
supported in this base implementation.</span>
+<span class="source-line-no">104</span><span id="line-104">     *</span>
+<span class="source-line-no">105</span><span id="line-105">     * @return a 
negative value.</span>
+<span class="source-line-no">106</span><span id="line-106">     */</span>
+<span class="source-line-no">107</span><span id="line-107">    @Override</span>
+<span class="source-line-no">108</span><span id="line-108">    public int 
getNumIdle() {</span>
+<span class="source-line-no">109</span><span id="line-109">        return 
-1;</span>
+<span class="source-line-no">110</span><span id="line-110">    }</span>
+<span class="source-line-no">111</span><span id="line-111"></span>
+<span class="source-line-no">112</span><span id="line-112">    @Override</span>
+<span class="source-line-no">113</span><span id="line-113">    public abstract 
void invalidateObject(T obj) throws Exception;</span>
+<span class="source-line-no">114</span><span id="line-114"></span>
+<span class="source-line-no">115</span><span id="line-115">    /**</span>
+<span class="source-line-no">116</span><span id="line-116">     * Has this 
pool instance been closed.</span>
+<span class="source-line-no">117</span><span id="line-117">     *</span>
+<span class="source-line-no">118</span><span id="line-118">     * @return 
{@code true} when this pool has been closed.</span>
+<span class="source-line-no">119</span><span id="line-119">     */</span>
+<span class="source-line-no">120</span><span id="line-120">    public final 
boolean isClosed() {</span>
+<span class="source-line-no">121</span><span id="line-121">        return 
closed;</span>
+<span class="source-line-no">122</span><span id="line-122">    }</span>
+<span class="source-line-no">123</span><span id="line-123"></span>
+<span class="source-line-no">124</span><span id="line-124">    @Override</span>
+<span class="source-line-no">125</span><span id="line-125">    public abstract 
void returnObject(T obj) throws Exception;</span>
+<span class="source-line-no">126</span><span id="line-126"></span>
+<span class="source-line-no">127</span><span id="line-127">    @Override</span>
+<span class="source-line-no">128</span><span id="line-128">    protected void 
toStringAppendFields(final StringBuilder builder) {</span>
+<span class="source-line-no">129</span><span id="line-129">        
builder.append("closed=");</span>
+<span class="source-line-no">130</span><span id="line-130">        
builder.append(closed);</span>
+<span class="source-line-no">131</span><span id="line-131">    }</span>
+<span class="source-line-no">132</span><span id="line-132">}</span>
 
 
 

Modified: 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BasePooledObjectFactory.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BasePooledObjectFactory.html
 (original)
+++ 
websites/production/commons/content/proper/commons-pool/apidocs/src-html/org/apache/commons/pool2/BasePooledObjectFactory.html
 Sat Feb  8 20:08:04 2025
@@ -46,71 +46,78 @@
 <span class="source-line-no">033</span><span id="line-33">public abstract 
class BasePooledObjectFactory&lt;T&gt; extends BaseObject implements 
PooledObjectFactory&lt;T&gt; {</span>
 <span class="source-line-no">034</span><span id="line-34"></span>
 <span class="source-line-no">035</span><span id="line-35">    /**</span>
-<span class="source-line-no">036</span><span id="line-36">     *  No-op.</span>
-<span class="source-line-no">037</span><span id="line-37">     *</span>
-<span class="source-line-no">038</span><span id="line-38">     *  @param p 
ignored</span>
-<span class="source-line-no">039</span><span id="line-39">     */</span>
-<span class="source-line-no">040</span><span id="line-40">    @Override</span>
-<span class="source-line-no">041</span><span id="line-41">    public void 
activateObject(final PooledObject&lt;T&gt; p) throws Exception {</span>
-<span class="source-line-no">042</span><span id="line-42">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">043</span><span id="line-43">    }</span>
-<span class="source-line-no">044</span><span id="line-44"></span>
-<span class="source-line-no">045</span><span id="line-45">    /**</span>
-<span class="source-line-no">046</span><span id="line-46">     * Creates an 
object instance, to be wrapped in a {@link PooledObject}.</span>
-<span class="source-line-no">047</span><span id="line-47">     * &lt;p&gt;This 
method &lt;strong&gt;must&lt;/strong&gt; support concurrent, 
multi-threaded</span>
-<span class="source-line-no">048</span><span id="line-48">     * 
invocation.&lt;/p&gt;</span>
-<span class="source-line-no">049</span><span id="line-49">     *</span>
-<span class="source-line-no">050</span><span id="line-50">     * @return an 
instance to be served by the pool, not null.</span>
-<span class="source-line-no">051</span><span id="line-51">     * @throws 
Exception if there is a problem creating a new instance,</span>
-<span class="source-line-no">052</span><span id="line-52">     *    this will 
be propagated to the code requesting an object.</span>
-<span class="source-line-no">053</span><span id="line-53">     */</span>
-<span class="source-line-no">054</span><span id="line-54">    public abstract 
T create() throws Exception;</span>
-<span class="source-line-no">055</span><span id="line-55"></span>
-<span class="source-line-no">056</span><span id="line-56">    /**</span>
-<span class="source-line-no">057</span><span id="line-57">     *  No-op.</span>
-<span class="source-line-no">058</span><span id="line-58">     *</span>
-<span class="source-line-no">059</span><span id="line-59">     *  @param p 
ignored</span>
+<span class="source-line-no">036</span><span id="line-36">     * Constructs a 
new instance.</span>
+<span class="source-line-no">037</span><span id="line-37">     */</span>
+<span class="source-line-no">038</span><span id="line-38">    public 
BasePooledObjectFactory() {</span>
+<span class="source-line-no">039</span><span id="line-39">        // 
empty</span>
+<span class="source-line-no">040</span><span id="line-40">    }</span>
+<span class="source-line-no">041</span><span id="line-41"></span>
+<span class="source-line-no">042</span><span id="line-42">    /**</span>
+<span class="source-line-no">043</span><span id="line-43">     *  No-op.</span>
+<span class="source-line-no">044</span><span id="line-44">     *</span>
+<span class="source-line-no">045</span><span id="line-45">     *  @param p 
ignored</span>
+<span class="source-line-no">046</span><span id="line-46">     */</span>
+<span class="source-line-no">047</span><span id="line-47">    @Override</span>
+<span class="source-line-no">048</span><span id="line-48">    public void 
activateObject(final PooledObject&lt;T&gt; p) throws Exception {</span>
+<span class="source-line-no">049</span><span id="line-49">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">050</span><span id="line-50">    }</span>
+<span class="source-line-no">051</span><span id="line-51"></span>
+<span class="source-line-no">052</span><span id="line-52">    /**</span>
+<span class="source-line-no">053</span><span id="line-53">     * Creates an 
object instance, to be wrapped in a {@link PooledObject}.</span>
+<span class="source-line-no">054</span><span id="line-54">     * &lt;p&gt;This 
method &lt;strong&gt;must&lt;/strong&gt; support concurrent, 
multi-threaded</span>
+<span class="source-line-no">055</span><span id="line-55">     * 
invocation.&lt;/p&gt;</span>
+<span class="source-line-no">056</span><span id="line-56">     *</span>
+<span class="source-line-no">057</span><span id="line-57">     * @return an 
instance to be served by the pool, not null.</span>
+<span class="source-line-no">058</span><span id="line-58">     * @throws 
Exception if there is a problem creating a new instance,</span>
+<span class="source-line-no">059</span><span id="line-59">     *    this will 
be propagated to the code requesting an object.</span>
 <span class="source-line-no">060</span><span id="line-60">     */</span>
-<span class="source-line-no">061</span><span id="line-61">    @Override</span>
-<span class="source-line-no">062</span><span id="line-62">    public void 
destroyObject(final PooledObject&lt;T&gt; p) throws Exception  {</span>
-<span class="source-line-no">063</span><span id="line-63">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">064</span><span id="line-64">    }</span>
-<span class="source-line-no">065</span><span id="line-65"></span>
-<span class="source-line-no">066</span><span id="line-66">    @Override</span>
-<span class="source-line-no">067</span><span id="line-67">    public 
PooledObject&lt;T&gt; makeObject() throws Exception {</span>
-<span class="source-line-no">068</span><span id="line-68">        return 
wrap(Objects.requireNonNull(create(), () -&gt; 
String.format("BasePooledObjectFactory(%s).create() = null", 
getClass().getName())));</span>
-<span class="source-line-no">069</span><span id="line-69">    }</span>
-<span class="source-line-no">070</span><span id="line-70"></span>
-<span class="source-line-no">071</span><span id="line-71">    /**</span>
-<span class="source-line-no">072</span><span id="line-72">     *  No-op.</span>
-<span class="source-line-no">073</span><span id="line-73">     *</span>
-<span class="source-line-no">074</span><span id="line-74">     * @param p 
ignored</span>
-<span class="source-line-no">075</span><span id="line-75">     */</span>
-<span class="source-line-no">076</span><span id="line-76">    @Override</span>
-<span class="source-line-no">077</span><span id="line-77">    public void 
passivateObject(final PooledObject&lt;T&gt; p) throws Exception {</span>
-<span class="source-line-no">078</span><span id="line-78">        // The 
default implementation is a no-op.</span>
-<span class="source-line-no">079</span><span id="line-79">    }</span>
-<span class="source-line-no">080</span><span id="line-80"></span>
-<span class="source-line-no">081</span><span id="line-81">    /**</span>
-<span class="source-line-no">082</span><span id="line-82">     * Always 
returns {@code true}.</span>
-<span class="source-line-no">083</span><span id="line-83">     *</span>
-<span class="source-line-no">084</span><span id="line-84">     * @param p 
ignored</span>
-<span class="source-line-no">085</span><span id="line-85">     * @return 
{@code true}</span>
-<span class="source-line-no">086</span><span id="line-86">     */</span>
-<span class="source-line-no">087</span><span id="line-87">    @Override</span>
-<span class="source-line-no">088</span><span id="line-88">    public boolean 
validateObject(final PooledObject&lt;T&gt; p) {</span>
-<span class="source-line-no">089</span><span id="line-89">        return 
true;</span>
-<span class="source-line-no">090</span><span id="line-90">    }</span>
-<span class="source-line-no">091</span><span id="line-91"></span>
-<span class="source-line-no">092</span><span id="line-92">    /**</span>
-<span class="source-line-no">093</span><span id="line-93">     * Wraps the 
provided instance with an implementation of</span>
-<span class="source-line-no">094</span><span id="line-94">     * {@link 
PooledObject}.</span>
-<span class="source-line-no">095</span><span id="line-95">     *</span>
-<span class="source-line-no">096</span><span id="line-96">     * @param obj 
the instance to wrap, should not be null.</span>
-<span class="source-line-no">097</span><span id="line-97">     * @return The 
provided instance, wrapped by a {@link PooledObject}</span>
-<span class="source-line-no">098</span><span id="line-98">     */</span>
-<span class="source-line-no">099</span><span id="line-99">    public abstract 
PooledObject&lt;T&gt; wrap(T obj);</span>
-<span class="source-line-no">100</span><span id="line-100">}</span>
+<span class="source-line-no">061</span><span id="line-61">    public abstract 
T create() throws Exception;</span>
+<span class="source-line-no">062</span><span id="line-62"></span>
+<span class="source-line-no">063</span><span id="line-63">    /**</span>
+<span class="source-line-no">064</span><span id="line-64">     *  No-op.</span>
+<span class="source-line-no">065</span><span id="line-65">     *</span>
+<span class="source-line-no">066</span><span id="line-66">     *  @param p 
ignored</span>
+<span class="source-line-no">067</span><span id="line-67">     */</span>
+<span class="source-line-no">068</span><span id="line-68">    @Override</span>
+<span class="source-line-no">069</span><span id="line-69">    public void 
destroyObject(final PooledObject&lt;T&gt; p) throws Exception  {</span>
+<span class="source-line-no">070</span><span id="line-70">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">071</span><span id="line-71">    }</span>
+<span class="source-line-no">072</span><span id="line-72"></span>
+<span class="source-line-no">073</span><span id="line-73">    @Override</span>
+<span class="source-line-no">074</span><span id="line-74">    public 
PooledObject&lt;T&gt; makeObject() throws Exception {</span>
+<span class="source-line-no">075</span><span id="line-75">        return 
wrap(Objects.requireNonNull(create(), () -&gt; 
String.format("BasePooledObjectFactory(%s).create() = null", 
getClass().getName())));</span>
+<span class="source-line-no">076</span><span id="line-76">    }</span>
+<span class="source-line-no">077</span><span id="line-77"></span>
+<span class="source-line-no">078</span><span id="line-78">    /**</span>
+<span class="source-line-no">079</span><span id="line-79">     *  No-op.</span>
+<span class="source-line-no">080</span><span id="line-80">     *</span>
+<span class="source-line-no">081</span><span id="line-81">     * @param p 
ignored</span>
+<span class="source-line-no">082</span><span id="line-82">     */</span>
+<span class="source-line-no">083</span><span id="line-83">    @Override</span>
+<span class="source-line-no">084</span><span id="line-84">    public void 
passivateObject(final PooledObject&lt;T&gt; p) throws Exception {</span>
+<span class="source-line-no">085</span><span id="line-85">        // The 
default implementation is a no-op.</span>
+<span class="source-line-no">086</span><span id="line-86">    }</span>
+<span class="source-line-no">087</span><span id="line-87"></span>
+<span class="source-line-no">088</span><span id="line-88">    /**</span>
+<span class="source-line-no">089</span><span id="line-89">     * Always 
returns {@code true}.</span>
+<span class="source-line-no">090</span><span id="line-90">     *</span>
+<span class="source-line-no">091</span><span id="line-91">     * @param p 
ignored</span>
+<span class="source-line-no">092</span><span id="line-92">     * @return 
{@code true}</span>
+<span class="source-line-no">093</span><span id="line-93">     */</span>
+<span class="source-line-no">094</span><span id="line-94">    @Override</span>
+<span class="source-line-no">095</span><span id="line-95">    public boolean 
validateObject(final PooledObject&lt;T&gt; p) {</span>
+<span class="source-line-no">096</span><span id="line-96">        return 
true;</span>
+<span class="source-line-no">097</span><span id="line-97">    }</span>
+<span class="source-line-no">098</span><span id="line-98"></span>
+<span class="source-line-no">099</span><span id="line-99">    /**</span>
+<span class="source-line-no">100</span><span id="line-100">     * Wraps the 
provided instance with an implementation of</span>
+<span class="source-line-no">101</span><span id="line-101">     * {@link 
PooledObject}.</span>
+<span class="source-line-no">102</span><span id="line-102">     *</span>
+<span class="source-line-no">103</span><span id="line-103">     * @param obj 
the instance to wrap, should not be null.</span>
+<span class="source-line-no">104</span><span id="line-104">     * @return The 
provided instance, wrapped by a {@link PooledObject}</span>
+<span class="source-line-no">105</span><span id="line-105">     */</span>
+<span class="source-line-no">106</span><span id="line-106">    public abstract 
PooledObject&lt;T&gt; wrap(T obj);</span>
+<span class="source-line-no">107</span><span id="line-107">}</span>

Reply via email to