commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ma...@apache.org
Subject svn commit: r899186 [6/43] - in /websites/production/commons/content/proper/commons-pool: cobertura/ cobertura/js/ css/ guide/ js/ testapidocs/ testapidocs/org/apache/commons/pool2/ testapidocs/org/apache/commons/pool2/impl/
Date Tue, 25 Feb 2014 19:23:45 GMT
Modified: websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedObjectPool.html
==============================================================================
--- websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedObjectPool.html (original)
+++ websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedObjectPool.html Tue Feb 25 19:23:44 2014
@@ -12,472 +12,472 @@
 <div class="separator">&nbsp;</div>
 <table class="report">
 <thead><tr>  <td class="heading">Classes in this File</td>  <td class="heading"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">Line Coverage</a></td>  <td class="heading"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">Branch Coverage</a></td>  <td class="heading"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">Complexity</a></td></tr></thead>
-  <tr><td><a href="org.apache.commons.pool2.KeyedObjectPool.html">KeyedObjectPool</a></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></td><td class="percentgraph"><div class="percentgraph"><div class="na" style="width:100px"><span class="text"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></span></div></div></td></tr></table></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></td><td class="percentgraph"><div class="percentgraph"><div class="na" style="width:100px"><span class="text"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a><
 /span></div></div></td></tr></table></td><td class="value"><span class="hidden">1.0;</span>1</td></tr
+  <tr><td><a href="org.apache.commons.pool2.KeyedObjectPool.html">KeyedObjectPool</a></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></td><td class="percentgraph"><div class="percentgraph"><div class="na" style="width:100px"><span class="text"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></span></div></div></td></tr></table></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a></td><td class="percentgraph"><div class="percentgraph"><div class="na" style="width:100px"><span class="text"><a class="dfn" href="help.html" onclick="popupwindow('help.html'); return false;">N/A</a><
 /span></div></div></td></tr></table></td><td class="value"><span class="hidden">1.0;</span>1</td></tr>
 
 </table>
 <div class="separator">&nbsp;</div>
-<table cellspacing="0" cellpadding="0" class="src"
-<tr>  <td class="numLine">&nbsp;1</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">/*</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;2</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one or more</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;3</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * contributor license agreements.  See the NOTICE file distributed with</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;4</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * this work for additional information regarding copyright ownership.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;5</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * The ASF licenses this file to You under the Apache License, Version 2.0</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;6</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * (the "License"); you may not use this file except in compliance with</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;7</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * the License.  You may obtain a copy of the License at</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;8</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;9</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *      http://www.apache.org/licenses/LICENSE-2.0</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;10</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;11</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Unless required by applicable law or agreed to in writing, software</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;12</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;13</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;14</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * See the License for the specific language governing permissions and</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;15</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * limitations under the License.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;16</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;17</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="keyword">package</span> org.apache.commons.pool2;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;18</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;19</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="keyword">import</span> java.util.NoSuchElementException;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;20</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;21</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;22</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * A "keyed" pooling interface.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;23</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;24</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * A keyed pool maintains a pool of instances for each key value.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;25</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;26</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Example of use:</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;27</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;pre style="border:solid thin; padding: 1ex;"</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;28</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &gt; Object obj = &lt;code style="color:#00C"&gt;null&lt;/code&gt;;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;29</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Object key = &lt;code style="color:#C00"&gt;"Key"&lt;/code&gt;;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;30</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;31</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;code style="color:#00C"&gt;try&lt;/code&gt; {</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;32</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     obj = pool.borrowObject(key);</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;33</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;//...use the object...&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;34</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * } &lt;code style="color:#00C"&gt;catch&lt;/code&gt;(Exception e) {</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;35</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// invalidate the object&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;36</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     pool.invalidateObject(key, obj);</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;37</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// do not return the object to the pool twice&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;38</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     obj = &lt;code style="color:#00C"&gt;null&lt;/code&gt;;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;39</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * } &lt;code style="color:#00C"&gt;finally&lt;/code&gt; {</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;40</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// make sure the object is returned to the pool&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;41</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#00C"&gt;if&lt;/code&gt;(&lt;code style="color:#00C"&gt;null&lt;/code&gt; != obj) {</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;42</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *         pool.returnObject(key, obj);</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;43</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     }</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;44</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * }&lt;/pre&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;45</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;46</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * {@link KeyedObjectPool} implementations &lt;i&gt;may&lt;/i&gt; choose to store at most</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;47</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * one instance per key value, or may choose to maintain a pool of instances</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;48</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * for each key (essentially creating a {@link java.util.Map Map} of</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;49</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * {@link ObjectPool pools}).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;50</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;51</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * See {@link org.apache.commons.pool2.impl.GenericKeyedObjectPool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;52</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * GenericKeyedObjectPool} for an implementation.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;53</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;54</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @param &lt;K&gt; The type of keys maintained by this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;55</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @param &lt;V&gt; Type of element pooled in this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;56</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;57</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see KeyedPooledObjectFactory</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;58</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see ObjectPool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;59</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see org.apache.commons.pool2.impl.GenericKeyedObjectPool GenericKeyedObjectPool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;60</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;61</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @version $Revision: 1566605 $</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;62</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;63</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @since 2.0</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;64</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;65</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="keyword">public</span> <span class="keyword">interface</span> KeyedObjectPool&lt;K,V&gt; {</pre></td></tr
-<tr>  <td class="numLine">&nbsp;66</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;67</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Obtains an instance from this pool for the specified &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;68</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;69</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Instances returned from this method will have been either newly created</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;70</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * with {@link KeyedPooledObjectFactory#makeObject makeObject} or will be</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;71</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * a previously idle object and have been activated with</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;72</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link KeyedPooledObjectFactory#activateObject activateObject} and then</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;73</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * (optionally) validated with</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;74</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link KeyedPooledObjectFactory#validateObject validateObject}.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;75</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;76</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * By contract, clients &lt;strong&gt;must&lt;/strong&gt; return the borrowed object</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;77</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * using {@link #returnObject returnObject},</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;78</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link #invalidateObject invalidateObject}, or a related method as</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;79</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * defined in an implementation or sub-interface, using a &lt;code&gt;key&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;80</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * that is {@link Object#equals equivalent} to the one used to borrow the</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;81</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * instance in the first place.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;82</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;83</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * The behaviour of this method when the pool has been exhausted is not</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;84</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * strictly specified (although it may be specified by implementations).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;85</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;86</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;87</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;88</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return an instance from this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;89</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;90</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;91</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              after {@link #close close} has been called on this pool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;92</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;93</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when {@link KeyedPooledObjectFactory#makeObject</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;94</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              makeObject} throws an exception</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;95</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws NoSuchElementException</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;96</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when the pool is exhausted and cannot or will not return</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;97</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              another instance</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;98</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;99</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    V borrowObject(K key) <span class="keyword">throws</span> Exception, NoSuchElementException, IllegalStateException;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;100</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;101</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;102</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Return an instance to the pool. By contract, &lt;code&gt;obj&lt;/code&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;103</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;strong&gt;must&lt;/strong&gt; have been obtained using</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;104</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link #borrowObject borrowObject} or a related method as defined in an</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;105</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * implementation or sub-interface using a &lt;code&gt;key&lt;/code&gt; that is</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;106</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * equivalent to the one used to borrow the instance in the first place.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;107</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;108</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;109</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param obj a {@link #borrowObject borrowed} instance to be returned.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;110</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;111</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;112</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              if an attempt is made to return an object to the pool that</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;113</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              is in any state other than allocated (i.e. borrowed).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;114</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              Attempting to return an object more than once or attempting</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;115</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              to return an object that was never borrowed from the pool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;116</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              will trigger this exception.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;117</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;118</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if an instance cannot be returned to the pool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;119</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;120</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> returnObject(K key, V obj) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;121</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;122</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;123</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Invalidates an object from the pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;124</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;125</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * By contract, &lt;code&gt;obj&lt;/code&gt; &lt;strong&gt;must&lt;/strong&gt; have been obtained</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;126</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * using {@link #borrowObject borrowObject} or a related method as defined</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;127</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * in an implementation or sub-interface using a &lt;code&gt;key&lt;/code&gt; that is</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;128</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * equivalent to the one used to borrow the &lt;code&gt;Object&lt;/code&gt; in the first</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;129</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * place.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;130</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;131</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * This method should be used when an object that has been borrowed is</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;132</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * determined (due to an exception or other problem) to be invalid.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;133</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;134</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;135</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param obj a {@link #borrowObject borrowed} instance to be returned.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;136</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;137</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if the instance cannot be invalidated</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;138</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;139</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> invalidateObject(K key, V obj) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;140</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;141</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;142</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Create an object using the {@link KeyedPooledObjectFactory factory} or</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;143</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * other implementation dependent mechanism, passivate it, and then place it</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;144</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * in the idle object pool. &lt;code&gt;addObject&lt;/code&gt; is useful for</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;145</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * "pre-loading" a pool with idle objects (Optional operation).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;146</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;147</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key a new instance should be added to</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;148</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;149</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;150</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when {@link KeyedPooledObjectFactory#makeObject} fails.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;151</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;152</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              after {@link #close} has been called on this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;153</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws UnsupportedOperationException</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;154</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when this pool cannot add new idle objects.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;155</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;156</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> addObject(K key) <span class="keyword">throws</span> Exception, IllegalStateException,</pre></td></tr
-<tr>  <td class="numLine">&nbsp;157</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;            UnsupportedOperationException;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;158</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;159</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;160</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the number of instances corresponding to the given</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;161</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;code&gt;key&lt;/code&gt; currently idle in this pool. Returns a negative value if</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;162</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * this information is not available.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;163</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;164</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key to query</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;165</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the number of instances corresponding to the given</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;166</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;code&gt;key&lt;/code&gt; currently idle in this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;167</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;168</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumIdle(K key);</pre></td></tr
-<tr>  <td class="numLine">&nbsp;169</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;170</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;171</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the number of instances currently borrowed from but not yet</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;172</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * returned to the pool corresponding to the given &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;173</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns a negative value if this information is not available.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;174</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;175</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key to query</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;176</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the number of instances currently borrowed from but not yet</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;177</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * returned to the pool corresponding to the given &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;178</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">=     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;179</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumActive(K key);</pre></td></tr
-<tr>  <td class="numLine">&nbsp;180</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;181</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;182</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the total number of instances currently idle in this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;183</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns a negative value if this information is not available.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;184</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the total number of instances currently idle in this pool.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;185</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment"> =    */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;186</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumIdle();</pre></td></tr
-<tr>  <td class="numLine">&nbsp;187</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;188</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;189</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the total number of instances current borrowed from this pool but</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;190</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * not yet returned. Returns a negative value if this information is not</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;191</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * available.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;192</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the total number of instances current borrowed from this pool but</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;193</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * not yet returned.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;194</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;195</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumActive();</pre></td></tr
-<tr>  <td class="numLine">&nbsp;196</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;197</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;198</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Clears the pool, removing all pooled instances (optional operation).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;199</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;200</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws UnsupportedOperationException when this implementation doesn't</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;201</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *                                       support the operation</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;202</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;203</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if the pool cannot be cleared</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;204</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;205</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> clear() <span class="keyword">throws</span> Exception, UnsupportedOperationException;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;206</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;207</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;208</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Clears the specified pool, removing all pooled instances corresponding to</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;209</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * the given &lt;code&gt;key&lt;/code&gt; (optional operation).</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;210</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;211</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key to clear</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;212</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;213</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws UnsupportedOperationException when this implementation doesn't</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;214</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *                                       support the operation</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;215</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;216</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if the key cannot be cleared</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;217</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;218</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> clear(K key) <span class="keyword">throws</span> Exception, UnsupportedOperationException;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;219</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;</pre></td></tr
-<tr>  <td class="numLine">&nbsp;220</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;221</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Close this pool, and free any resources associated with it.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;222</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;223</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Calling {@link #addObject addObject} or</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;224</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link #borrowObject borrowObject} after invoking this method on a pool</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;225</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * will cause them to throw an {@link IllegalStateException}.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;226</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;227</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Implementations should silently fail if not all resources can be freed.</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;228</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr
-<tr>  <td class="numLine">&nbsp;229</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> close();</pre></td></tr
-<tr>  <td class="numLine">&nbsp;230</td>  <td class="nbHits">&nbsp;</td
-  <td class="src"><pre class="src">&nbsp;}</pre></td></tr
-</table
+<table cellspacing="0" cellpadding="0" class="src">
+<tr>  <td class="numLine">&nbsp;1</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">/*</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;2</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one or more</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;3</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * contributor license agreements.  See the NOTICE file distributed with</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;4</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * this work for additional information regarding copyright ownership.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;5</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * The ASF licenses this file to You under the Apache License, Version 2.0</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;6</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * (the "License"); you may not use this file except in compliance with</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;7</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * the License.  You may obtain a copy of the License at</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;8</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;9</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *      http://www.apache.org/licenses/LICENSE-2.0</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;10</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;11</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Unless required by applicable law or agreed to in writing, software</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;12</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;13</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;14</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * See the License for the specific language governing permissions and</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;15</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * limitations under the License.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;16</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;17</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="keyword">package</span> org.apache.commons.pool2;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;18</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;19</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="keyword">import</span> java.util.NoSuchElementException;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;20</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;21</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;22</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * A "keyed" pooling interface.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;23</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;24</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * A keyed pool maintains a pool of instances for each key value.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;25</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;26</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Example of use:</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;27</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;pre style="border:solid thin; padding: 1ex;"</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;28</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &gt; Object obj = &lt;code style="color:#00C"&gt;null&lt;/code&gt;;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;29</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * Object key = &lt;code style="color:#C00"&gt;"Key"&lt;/code&gt;;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;30</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;31</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;code style="color:#00C"&gt;try&lt;/code&gt; {</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;32</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     obj = pool.borrowObject(key);</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;33</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;//...use the object...&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;34</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * } &lt;code style="color:#00C"&gt;catch&lt;/code&gt;(Exception e) {</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;35</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// invalidate the object&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;36</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     pool.invalidateObject(key, obj);</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;37</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// do not return the object to the pool twice&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;38</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     obj = &lt;code style="color:#00C"&gt;null&lt;/code&gt;;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;39</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * } &lt;code style="color:#00C"&gt;finally&lt;/code&gt; {</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;40</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#0C0"&gt;// make sure the object is returned to the pool&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;41</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     &lt;code style="color:#00C"&gt;if&lt;/code&gt;(&lt;code style="color:#00C"&gt;null&lt;/code&gt; != obj) {</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;42</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *         pool.returnObject(key, obj);</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;43</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *     }</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;44</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * }&lt;/pre&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;45</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;46</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * {@link KeyedObjectPool} implementations &lt;i&gt;may&lt;/i&gt; choose to store at most</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;47</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * one instance per key value, or may choose to maintain a pool of instances</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;48</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * for each key (essentially creating a {@link java.util.Map Map} of</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;49</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * {@link ObjectPool pools}).</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;50</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;51</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * See {@link org.apache.commons.pool2.impl.GenericKeyedObjectPool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;52</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * GenericKeyedObjectPool} for an implementation.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;53</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;54</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @param &lt;K&gt; The type of keys maintained by this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;55</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @param &lt;V&gt; Type of element pooled in this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;56</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;57</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see KeyedPooledObjectFactory</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;58</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see ObjectPool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;59</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @see org.apache.commons.pool2.impl.GenericKeyedObjectPool GenericKeyedObjectPool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;60</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;61</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @version $Revision: 1566605 $</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;62</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;63</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> * @since 2.0</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;64</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;65</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="keyword">public</span> <span class="keyword">interface</span> KeyedObjectPool&lt;K,V&gt; {</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;66</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;67</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Obtains an instance from this pool for the specified &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;68</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;69</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Instances returned from this method will have been either newly created</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;70</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * with {@link KeyedPooledObjectFactory#makeObject makeObject} or will be</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;71</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * a previously idle object and have been activated with</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;72</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link KeyedPooledObjectFactory#activateObject activateObject} and then</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;73</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * (optionally) validated with</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;74</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link KeyedPooledObjectFactory#validateObject validateObject}.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;75</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;76</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * By contract, clients &lt;strong&gt;must&lt;/strong&gt; return the borrowed object</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;77</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * using {@link #returnObject returnObject},</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;78</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link #invalidateObject invalidateObject}, or a related method as</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;79</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * defined in an implementation or sub-interface, using a &lt;code&gt;key&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;80</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * that is {@link Object#equals equivalent} to the one used to borrow the</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;81</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * instance in the first place.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;82</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;83</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * The behaviour of this method when the pool has been exhausted is not</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;84</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * strictly specified (although it may be specified by implementations).</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;85</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;86</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;87</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;88</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return an instance from this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;89</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;90</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;91</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              after {@link #close close} has been called on this pool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;92</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;93</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when {@link KeyedPooledObjectFactory#makeObject</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;94</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              makeObject} throws an exception</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;95</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws NoSuchElementException</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;96</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when the pool is exhausted and cannot or will not return</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;97</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              another instance</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;98</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;99</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    V borrowObject(K key) <span class="keyword">throws</span> Exception, NoSuchElementException, IllegalStateException;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;100</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;101</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;102</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Return an instance to the pool. By contract, &lt;code&gt;obj&lt;/code&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;103</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;strong&gt;must&lt;/strong&gt; have been obtained using</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;104</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * {@link #borrowObject borrowObject} or a related method as defined in an</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;105</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * implementation or sub-interface using a &lt;code&gt;key&lt;/code&gt; that is</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;106</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * equivalent to the one used to borrow the instance in the first place.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;107</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;108</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;109</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param obj a {@link #borrowObject borrowed} instance to be returned.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;110</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;111</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;112</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              if an attempt is made to return an object to the pool that</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;113</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              is in any state other than allocated (i.e. borrowed).</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;114</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              Attempting to return an object more than once or attempting</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;115</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              to return an object that was never borrowed from the pool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;116</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              will trigger this exception.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;117</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;118</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if an instance cannot be returned to the pool</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;119</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;120</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> returnObject(K key, V obj) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;121</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;122</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;123</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Invalidates an object from the pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;124</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;125</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * By contract, &lt;code&gt;obj&lt;/code&gt; &lt;strong&gt;must&lt;/strong&gt; have been obtained</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;126</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * using {@link #borrowObject borrowObject} or a related method as defined</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;127</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * in an implementation or sub-interface using a &lt;code&gt;key&lt;/code&gt; that is</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;128</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * equivalent to the one used to borrow the &lt;code&gt;Object&lt;/code&gt; in the first</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;129</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * place.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;130</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;p&gt;</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;131</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * This method should be used when an object that has been borrowed is</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;132</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * determined (due to an exception or other problem) to be invalid.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;133</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;134</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key used to obtain the object</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;135</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param obj a {@link #borrowObject borrowed} instance to be returned.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;136</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;137</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception if the instance cannot be invalidated</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;138</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;139</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> invalidateObject(K key, V obj) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;140</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;141</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;142</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Create an object using the {@link KeyedPooledObjectFactory factory} or</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;143</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * other implementation dependent mechanism, passivate it, and then place it</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;144</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * in the idle object pool. &lt;code&gt;addObject&lt;/code&gt; is useful for</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;145</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * "pre-loading" a pool with idle objects (Optional operation).</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;146</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;147</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key a new instance should be added to</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;148</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;149</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws Exception</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;150</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when {@link KeyedPooledObjectFactory#makeObject} fails.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;151</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws IllegalStateException</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;152</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              after {@link #close} has been called on this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;153</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @throws UnsupportedOperationException</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;154</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *              when this pool cannot add new idle objects.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;155</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;156</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">void</span> addObject(K key) <span class="keyword">throws</span> Exception, IllegalStateException,</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;157</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;            UnsupportedOperationException;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;158</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;159</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;160</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the number of instances corresponding to the given</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;161</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;code&gt;key&lt;/code&gt; currently idle in this pool. Returns a negative value if</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;162</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * this information is not available.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;163</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;164</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key to query</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;165</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the number of instances corresponding to the given</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;166</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * &lt;code&gt;key&lt;/code&gt; currently idle in this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;167</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;168</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumIdle(K key);</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;169</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;170</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;171</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the number of instances currently borrowed from but not yet</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;172</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * returned to the pool corresponding to the given &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;173</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns a negative value if this information is not available.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;174</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     *</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;175</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @param key the key to query</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;176</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the number of instances currently borrowed from but not yet</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;177</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * returned to the pool corresponding to the given &lt;code&gt;key&lt;/code&gt;.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;178</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">=     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;179</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumActive(K key);</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;180</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;181</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;182</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the total number of instances currently idle in this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;183</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns a negative value if this information is not available.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;184</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the total number of instances currently idle in this pool.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;185</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment"> =    */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;186</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumIdle();</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;187</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;188</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;189</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * Returns the total number of instances current borrowed from this pool but</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;190</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * not yet returned. Returns a negative value if this information is not</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;191</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * available.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;192</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * @return the total number of instances current borrowed from this pool but</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;193</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     * not yet returned.</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;194</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;<span class="comment">     */</span></pre></td></tr>
+<tr>  <td class="numLine">&nbsp;195</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="keyword">int</span> getNumActive();</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;196</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;</pre></td></tr>
+<tr>  <td class="numLine">&nbsp;197</td>  <td class="nbHits">&nbsp;</td>
+  <td class="src"><pre class="src">&nbsp;    <span class="comment">/**</span></pre></td></tr>

[... 71 lines stripped ...]


Mime
View raw message