You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ma...@apache.org on 2014/02/25 20:23:45 UTC
svn commit: r899186 [7/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/
Modified: websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedPooledObjectFactory.html
==============================================================================
--- websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedPooledObjectFactory.html (original)
+++ websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.KeyedPooledObjectFactory.html Tue Feb 25 19:23:44 2014
@@ -12,312 +12,312 @@
<div class="separator"> </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.KeyedPooledObjectFactory.html">KeyedPooledObjectFactory</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'); retur
n 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.KeyedPooledObjectFactory.html">KeyedPooledObjectFactory</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'); retur
n 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"> </div>
-<table cellspacing="0" cellpadding="0" class="src"
-<tr> <td class="numLine"> 1</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/*</span></pre></td></tr
-<tr> <td class="numLine"> 2</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one or more</span></pre></td></tr
-<tr> <td class="numLine"> 3</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * contributor license agreements. See the NOTICE file distributed with</span></pre></td></tr
-<tr> <td class="numLine"> 4</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * this work for additional information regarding copyright ownership.</span></pre></td></tr
-<tr> <td class="numLine"> 5</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <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"> 6</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * (the "License"); you may not use this file except in compliance with</span></pre></td></tr
-<tr> <td class="numLine"> 7</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * the License. You may obtain a copy of the License at</span></pre></td></tr
-<tr> <td class="numLine"> 8</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 9</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></pre></td></tr
-<tr> <td class="numLine"> 10</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 11</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span></pre></td></tr
-<tr> <td class="numLine"> 12</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span></pre></td></tr
-<tr> <td class="numLine"> 13</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></pre></td></tr
-<tr> <td class="numLine"> 14</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * See the License for the specific language governing permissions and</span></pre></td></tr
-<tr> <td class="numLine"> 15</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * limitations under the License.</span></pre></td></tr
-<tr> <td class="numLine"> 16</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 17</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">package</span> org.apache.commons.pool2;</pre></td></tr
-<tr> <td class="numLine"> 18</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 19</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 20</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * An interface defining life-cycle methods for</span></pre></td></tr
-<tr> <td class="numLine"> 21</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * instances to be served by a {@link KeyedObjectPool}.</span></pre></td></tr
-<tr> <td class="numLine"> 22</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr
-<tr> <td class="numLine"> 23</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * By contract, when an {@link KeyedObjectPool}</span></pre></td></tr
-<tr> <td class="numLine"> 24</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * delegates to a {@link KeyedPooledObjectFactory},</span></pre></td></tr
-<tr> <td class="numLine"> 25</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <ol></span></pre></td></tr
-<tr> <td class="numLine"> 26</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr
-<tr> <td class="numLine"> 27</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #makeObject} is called whenever a new instance is needed.</span></pre></td></tr
-<tr> <td class="numLine"> 28</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr
-<tr> <td class="numLine"> 29</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr
-<tr> <td class="numLine"> 30</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #activateObject} is invoked on every instance that has been</span></pre></td></tr
-<tr> <td class="numLine"> 31</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #passivateObject passivated} before it is</span></pre></td></tr
-<tr> <td class="numLine"> 32</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedObjectPool#borrowObject borrowed} from the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 33</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr
-<tr> <td class="numLine"> 34</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr
-<tr> <td class="numLine"> 35</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #validateObject} may be invoked on {@link #activateObject activated}</span></pre></td></tr
-<tr> <td class="numLine"> 36</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * instances to make sure they can be</span></pre></td></tr
-<tr> <td class="numLine"> 37</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedObjectPool#borrowObject borrowed} from the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 38</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <code>validateObject</code> may also be used to test an</span></pre></td></tr
-<tr> <td class="numLine"> 39</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * instance being {@link KeyedObjectPool#returnObject returned} to the pool</span></pre></td></tr
-<tr> <td class="numLine"> 40</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * before it is {@link #passivateObject passivated}. It will only be invoked</span></pre></td></tr
-<tr> <td class="numLine"> 41</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * on an activated instance.</span></pre></td></tr
-<tr> <td class="numLine"> 42</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr
-<tr> <td class="numLine"> 43</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr
-<tr> <td class="numLine"> 44</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #passivateObject passivateObject}</span></pre></td></tr
-<tr> <td class="numLine"> 45</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * is invoked on every instance when it is returned to the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 46</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr
-<tr> <td class="numLine"> 47</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr
-<tr> <td class="numLine"> 48</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link #destroyObject destroyObject}</span></pre></td></tr
-<tr> <td class="numLine"> 49</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * is invoked on every instance when it is being "dropped" from the</span></pre></td></tr
-<tr> <td class="numLine"> 50</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * pool (whether due to the response from <code>validateObject</code>,</span></pre></td></tr
-<tr> <td class="numLine"> 51</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * or for reasons specific to the pool implementation.) There is no</span></pre></td></tr
-<tr> <td class="numLine"> 52</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * guarantee that the instance being destroyed will</span></pre></td></tr
-<tr> <td class="numLine"> 53</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * be considered active, passive or in a generally consistent state.</span></pre></td></tr
-<tr> <td class="numLine"> 54</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr
-<tr> <td class="numLine"> 55</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * </ol></span></pre></td></tr
-<tr> <td class="numLine"> 56</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedPooledObjectFactory} must be thread-safe. The only promise</span></pre></td></tr
-<tr> <td class="numLine"> 57</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * an {@link KeyedObjectPool} makes is that the same instance of an object will</span></pre></td></tr
-<tr> <td class="numLine"> 58</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * not be passed to more than one method of a</span></pre></td></tr
-<tr> <td class="numLine"> 59</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <code>KeyedPoolableObjectFactory</code> at a time.</span></pre></td></tr
-<tr> <td class="numLine"> 60</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr
-<tr> <td class="numLine"> 61</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * While clients of a {@link KeyedObjectPool} borrow and return instances of</span></pre></td></tr
-<tr> <td class="numLine"> 62</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * the underlying value type V, the factory methods act on instances of</span></pre></td></tr
-<tr> <td class="numLine"> 63</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@link PooledObject PooledObject&lt;V&gt;}. These are the object wrappers that</span></pre></td></tr
-<tr> <td class="numLine"> 64</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * pools use to track and maintain state informations about the objects that</span></pre></td></tr
-<tr> <td class="numLine"> 65</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * they manage.</span></pre></td></tr
-<tr> <td class="numLine"> 66</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 67</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see KeyedObjectPool</span></pre></td></tr
-<tr> <td class="numLine"> 68</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see BaseKeyedPooledObjectFactory</span></pre></td></tr
-<tr> <td class="numLine"> 69</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 70</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param <K> The type of keys managed by this factory.</span></pre></td></tr
-<tr> <td class="numLine"> 71</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param <V> Type of element managed by this factory.</span></pre></td></tr
-<tr> <td class="numLine"> 72</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 73</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @version $Revision: 1333925 $</span></pre></td></tr
-<tr> <td class="numLine"> 74</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 75</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @since 2.0</span></pre></td></tr
-<tr> <td class="numLine"> 76</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 77</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">interface</span> KeyedPooledObjectFactory<K,V> {</pre></td></tr
-<tr> <td class="numLine"> 78</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 79</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Create an instance that can be served by the pool and</span></pre></td></tr
-<tr> <td class="numLine"> 80</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * wrap it in a {@link PooledObject} to be managed by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 81</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 82</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when constructing the object</span></pre></td></tr
-<tr> <td class="numLine"> 83</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 84</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @return a {@code PooledObject} wrapping an instance that can</span></pre></td></tr
-<tr> <td class="numLine"> 85</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * be served by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 86</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 87</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem creating a new instance,</span></pre></td></tr
-<tr> <td class="numLine"> 88</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * this will be propagated to the code requesting an object.</span></pre></td></tr
-<tr> <td class="numLine"> 89</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 90</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> PooledObject<V> makeObject(K key) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr> <td class="numLine"> 91</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 92</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 93</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Destroy an instance no longer needed by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 94</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr
-<tr> <td class="numLine"> 95</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * It is important for implementations of this method to be aware that there</span></pre></td></tr
-<tr> <td class="numLine"> 96</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * is no guarantee about what state <code>obj</code> will be in and the</span></pre></td></tr
-<tr> <td class="numLine"> 97</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * implementation should be prepared to handle unexpected errors.</span></pre></td></tr
-<tr> <td class="numLine"> 98</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr
-<tr> <td class="numLine"> 99</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Also, an implementation must take in to consideration that instances lost</span></pre></td></tr
-<tr> <td class="numLine"> 100</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * to the garbage collector may never be destroyed.</span></pre></td></tr
-<tr> <td class="numLine"> 101</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 102</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the instance</span></pre></td></tr
-<tr> <td class="numLine"> 103</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be destroyed</span></pre></td></tr
-<tr> <td class="numLine"> 104</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 105</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @throws Exception should be avoided as it may be swallowed by</span></pre></td></tr
-<tr> <td class="numLine"> 106</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * the pool implementation.</span></pre></td></tr
-<tr> <td class="numLine"> 107</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 108</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see #validateObject</span></pre></td></tr
-<tr> <td class="numLine"> 109</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see KeyedObjectPool#invalidateObject</span></pre></td></tr
-<tr> <td class="numLine"> 110</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 111</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">void</span> destroyObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr> <td class="numLine"> 112</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 113</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 114</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Ensures that the instance is safe to be returned by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 115</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 116</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr
-<tr> <td class="numLine"> 117</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be validated</span></pre></td></tr
-<tr> <td class="numLine"> 118</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 119</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @return <code>false</code> if <code>obj</code> is not valid and should</span></pre></td></tr
-<tr> <td class="numLine"> 120</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * be dropped from the pool, <code>true</code> otherwise.</span></pre></td></tr
-<tr> <td class="numLine"> 121</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 122</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">boolean</span> validateObject(K key, PooledObject<V> p);</pre></td></tr
-<tr> <td class="numLine"> 123</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 124</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 125</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Reinitialize an instance to be returned by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 126</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 127</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr
-<tr> <td class="numLine"> 128</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be activated</span></pre></td></tr
-<tr> <td class="numLine"> 129</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 130</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem activating <code>obj</code>,</span></pre></td></tr
-<tr> <td class="numLine"> 131</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * this exception may be swallowed by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 132</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 133</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see #destroyObject</span></pre></td></tr
-<tr> <td class="numLine"> 134</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 135</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">void</span> activateObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr> <td class="numLine"> 136</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 137</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 138</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Uninitialize an instance to be returned to the idle object pool.</span></pre></td></tr
-<tr> <td class="numLine"> 139</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 140</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr
-<tr> <td class="numLine"> 141</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be passivated</span></pre></td></tr
-<tr> <td class="numLine"> 142</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 143</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem passivating <code>obj</code>,</span></pre></td></tr
-<tr> <td class="numLine"> 144</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * this exception may be swallowed by the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 145</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 146</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @see #destroyObject</span></pre></td></tr
-<tr> <td class="numLine"> 147</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 148</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">void</span> passivateObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr
-<tr> <td class="numLine"> 149</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 150</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-</table
+<table cellspacing="0" cellpadding="0" class="src">
+<tr> <td class="numLine"> 1</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/*</span></pre></td></tr>
+<tr> <td class="numLine"> 2</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one or more</span></pre></td></tr>
+<tr> <td class="numLine"> 3</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * contributor license agreements. See the NOTICE file distributed with</span></pre></td></tr>
+<tr> <td class="numLine"> 4</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * this work for additional information regarding copyright ownership.</span></pre></td></tr>
+<tr> <td class="numLine"> 5</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <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"> 6</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * (the "License"); you may not use this file except in compliance with</span></pre></td></tr>
+<tr> <td class="numLine"> 7</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * the License. You may obtain a copy of the License at</span></pre></td></tr>
+<tr> <td class="numLine"> 8</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 9</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></pre></td></tr>
+<tr> <td class="numLine"> 10</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 11</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Unless required by applicable law or agreed to in writing, software</span></pre></td></tr>
+<tr> <td class="numLine"> 12</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</span></pre></td></tr>
+<tr> <td class="numLine"> 13</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span></pre></td></tr>
+<tr> <td class="numLine"> 14</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * See the License for the specific language governing permissions and</span></pre></td></tr>
+<tr> <td class="numLine"> 15</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * limitations under the License.</span></pre></td></tr>
+<tr> <td class="numLine"> 16</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 17</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">package</span> org.apache.commons.pool2;</pre></td></tr>
+<tr> <td class="numLine"> 18</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 19</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 20</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * An interface defining life-cycle methods for</span></pre></td></tr>
+<tr> <td class="numLine"> 21</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * instances to be served by a {@link KeyedObjectPool}.</span></pre></td></tr>
+<tr> <td class="numLine"> 22</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr>
+<tr> <td class="numLine"> 23</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * By contract, when an {@link KeyedObjectPool}</span></pre></td></tr>
+<tr> <td class="numLine"> 24</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * delegates to a {@link KeyedPooledObjectFactory},</span></pre></td></tr>
+<tr> <td class="numLine"> 25</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <ol></span></pre></td></tr>
+<tr> <td class="numLine"> 26</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr>
+<tr> <td class="numLine"> 27</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #makeObject} is called whenever a new instance is needed.</span></pre></td></tr>
+<tr> <td class="numLine"> 28</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr>
+<tr> <td class="numLine"> 29</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr>
+<tr> <td class="numLine"> 30</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #activateObject} is invoked on every instance that has been</span></pre></td></tr>
+<tr> <td class="numLine"> 31</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #passivateObject passivated} before it is</span></pre></td></tr>
+<tr> <td class="numLine"> 32</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedObjectPool#borrowObject borrowed} from the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 33</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr>
+<tr> <td class="numLine"> 34</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr>
+<tr> <td class="numLine"> 35</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #validateObject} may be invoked on {@link #activateObject activated}</span></pre></td></tr>
+<tr> <td class="numLine"> 36</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * instances to make sure they can be</span></pre></td></tr>
+<tr> <td class="numLine"> 37</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedObjectPool#borrowObject borrowed} from the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 38</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <code>validateObject</code> may also be used to test an</span></pre></td></tr>
+<tr> <td class="numLine"> 39</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * instance being {@link KeyedObjectPool#returnObject returned} to the pool</span></pre></td></tr>
+<tr> <td class="numLine"> 40</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * before it is {@link #passivateObject passivated}. It will only be invoked</span></pre></td></tr>
+<tr> <td class="numLine"> 41</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * on an activated instance.</span></pre></td></tr>
+<tr> <td class="numLine"> 42</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr>
+<tr> <td class="numLine"> 43</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr>
+<tr> <td class="numLine"> 44</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #passivateObject passivateObject}</span></pre></td></tr>
+<tr> <td class="numLine"> 45</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * is invoked on every instance when it is returned to the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 46</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr>
+<tr> <td class="numLine"> 47</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <li></span></pre></td></tr>
+<tr> <td class="numLine"> 48</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link #destroyObject destroyObject}</span></pre></td></tr>
+<tr> <td class="numLine"> 49</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * is invoked on every instance when it is being "dropped" from the</span></pre></td></tr>
+<tr> <td class="numLine"> 50</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * pool (whether due to the response from <code>validateObject</code>,</span></pre></td></tr>
+<tr> <td class="numLine"> 51</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * or for reasons specific to the pool implementation.) There is no</span></pre></td></tr>
+<tr> <td class="numLine"> 52</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * guarantee that the instance being destroyed will</span></pre></td></tr>
+<tr> <td class="numLine"> 53</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * be considered active, passive or in a generally consistent state.</span></pre></td></tr>
+<tr> <td class="numLine"> 54</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </li></span></pre></td></tr>
+<tr> <td class="numLine"> 55</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * </ol></span></pre></td></tr>
+<tr> <td class="numLine"> 56</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link KeyedPooledObjectFactory} must be thread-safe. The only promise</span></pre></td></tr>
+<tr> <td class="numLine"> 57</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * an {@link KeyedObjectPool} makes is that the same instance of an object will</span></pre></td></tr>
+<tr> <td class="numLine"> 58</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * not be passed to more than one method of a</span></pre></td></tr>
+<tr> <td class="numLine"> 59</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <code>KeyedPoolableObjectFactory</code> at a time.</span></pre></td></tr>
+<tr> <td class="numLine"> 60</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr>
+<tr> <td class="numLine"> 61</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * While clients of a {@link KeyedObjectPool} borrow and return instances of</span></pre></td></tr>
+<tr> <td class="numLine"> 62</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * the underlying value type V, the factory methods act on instances of</span></pre></td></tr>
+<tr> <td class="numLine"> 63</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@link PooledObject PooledObject&lt;V&gt;}. These are the object wrappers that</span></pre></td></tr>
+<tr> <td class="numLine"> 64</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * pools use to track and maintain state informations about the objects that</span></pre></td></tr>
+<tr> <td class="numLine"> 65</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * they manage.</span></pre></td></tr>
+<tr> <td class="numLine"> 66</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 67</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see KeyedObjectPool</span></pre></td></tr>
+<tr> <td class="numLine"> 68</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see BaseKeyedPooledObjectFactory</span></pre></td></tr>
+<tr> <td class="numLine"> 69</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 70</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param <K> The type of keys managed by this factory.</span></pre></td></tr>
+<tr> <td class="numLine"> 71</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param <V> Type of element managed by this factory.</span></pre></td></tr>
+<tr> <td class="numLine"> 72</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 73</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @version $Revision: 1333925 $</span></pre></td></tr>
+<tr> <td class="numLine"> 74</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 75</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @since 2.0</span></pre></td></tr>
+<tr> <td class="numLine"> 76</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 77</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">interface</span> KeyedPooledObjectFactory<K,V> {</pre></td></tr>
+<tr> <td class="numLine"> 78</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 79</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Create an instance that can be served by the pool and</span></pre></td></tr>
+<tr> <td class="numLine"> 80</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * wrap it in a {@link PooledObject} to be managed by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 81</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 82</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when constructing the object</span></pre></td></tr>
+<tr> <td class="numLine"> 83</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 84</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @return a {@code PooledObject} wrapping an instance that can</span></pre></td></tr>
+<tr> <td class="numLine"> 85</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * be served by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 86</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 87</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem creating a new instance,</span></pre></td></tr>
+<tr> <td class="numLine"> 88</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * this will be propagated to the code requesting an object.</span></pre></td></tr>
+<tr> <td class="numLine"> 89</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 90</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> PooledObject<V> makeObject(K key) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr> <td class="numLine"> 91</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 92</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 93</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Destroy an instance no longer needed by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 94</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr>
+<tr> <td class="numLine"> 95</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * It is important for implementations of this method to be aware that there</span></pre></td></tr>
+<tr> <td class="numLine"> 96</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * is no guarantee about what state <code>obj</code> will be in and the</span></pre></td></tr>
+<tr> <td class="numLine"> 97</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * implementation should be prepared to handle unexpected errors.</span></pre></td></tr>
+<tr> <td class="numLine"> 98</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr>
+<tr> <td class="numLine"> 99</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Also, an implementation must take in to consideration that instances lost</span></pre></td></tr>
+<tr> <td class="numLine"> 100</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * to the garbage collector may never be destroyed.</span></pre></td></tr>
+<tr> <td class="numLine"> 101</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 102</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the instance</span></pre></td></tr>
+<tr> <td class="numLine"> 103</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be destroyed</span></pre></td></tr>
+<tr> <td class="numLine"> 104</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 105</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @throws Exception should be avoided as it may be swallowed by</span></pre></td></tr>
+<tr> <td class="numLine"> 106</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * the pool implementation.</span></pre></td></tr>
+<tr> <td class="numLine"> 107</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 108</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see #validateObject</span></pre></td></tr>
+<tr> <td class="numLine"> 109</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see KeyedObjectPool#invalidateObject</span></pre></td></tr>
+<tr> <td class="numLine"> 110</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 111</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">void</span> destroyObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr> <td class="numLine"> 112</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 113</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 114</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Ensures that the instance is safe to be returned by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 115</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 116</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr>
+<tr> <td class="numLine"> 117</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be validated</span></pre></td></tr>
+<tr> <td class="numLine"> 118</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 119</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @return <code>false</code> if <code>obj</code> is not valid and should</span></pre></td></tr>
+<tr> <td class="numLine"> 120</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * be dropped from the pool, <code>true</code> otherwise.</span></pre></td></tr>
+<tr> <td class="numLine"> 121</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 122</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">boolean</span> validateObject(K key, PooledObject<V> p);</pre></td></tr>
+<tr> <td class="numLine"> 123</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 124</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 125</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Reinitialize an instance to be returned by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 126</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 127</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr>
+<tr> <td class="numLine"> 128</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be activated</span></pre></td></tr>
+<tr> <td class="numLine"> 129</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 130</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem activating <code>obj</code>,</span></pre></td></tr>
+<tr> <td class="numLine"> 131</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * this exception may be swallowed by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 132</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 133</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see #destroyObject</span></pre></td></tr>
+<tr> <td class="numLine"> 134</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 135</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">void</span> activateObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr> <td class="numLine"> 136</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 137</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 138</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Uninitialize an instance to be returned to the idle object pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 139</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 140</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param key the key used when selecting the object</span></pre></td></tr>
+<tr> <td class="numLine"> 141</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param p a {@code PooledObject} wrapping the instance to be passivated</span></pre></td></tr>
+<tr> <td class="numLine"> 142</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 143</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @throws Exception if there is a problem passivating <code>obj</code>,</span></pre></td></tr>
+<tr> <td class="numLine"> 144</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * this exception may be swallowed by the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 145</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 146</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @see #destroyObject</span></pre></td></tr>
+<tr> <td class="numLine"> 147</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 148</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">void</span> passivateObject(K key, PooledObject<V> p) <span class="keyword">throws</span> Exception;</pre></td></tr>
+<tr> <td class="numLine"> 149</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 150</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+</table>
<div class="footer">Report generated by <a href="http://cobertura.sourceforge.net/" target="_top">Cobertura</a> 1.9.4.1 on 25/02/14 15:23.</div>
</body>