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 [31/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.impl.PooledSoftReference.html
==============================================================================
--- websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.impl.PooledSoftReference.html (original)
+++ websites/production/commons/content/proper/commons-pool/cobertura/org.apache.commons.pool2.impl.PooledSoftReference.html Tue Feb 25 19:23:44 2014
@@ -12,197 +12,197 @@
<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.impl.PooledSoftReference.html">PooledSoftReference</a></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40">100%</td><td class="percentgraph"><div class="percentgraph"><div class="greenbar" style="width:100px"><span class="text">15/15</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.impl.PooledSoftReference.html">PooledSoftReference</a></td><td><table cellpadding="0px" cellspacing="0px" class="percentgraph"><tr class="percentgraph"><td align="right" class="percentgraph" width="40">100%</td><td class="percentgraph"><div class="percentgraph"><div class="greenbar" style="width:100px"><span class="text">15/15</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"> </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.impl;</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="keyword">import</span> java.lang.ref.SoftReference;</pre></td></tr
-<tr> <td class="numLine"> 20</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 21</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 22</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Extension of {@link DefaultPooledObject} to wrap pooled soft references.</span></pre></td></tr
-<tr> <td class="numLine"> 23</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 24</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p>This class is intended to be thread-safe.</p></span></pre></td></tr
-<tr> <td class="numLine"> 25</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 26</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param <T> the type of the underlying object that the wrapped SoftReference</span></pre></td></tr
-<tr> <td class="numLine"> 27</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * refers to.</span></pre></td></tr
-<tr> <td class="numLine"> 28</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 29</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @version $Revision: $</span></pre></td></tr
-<tr> <td class="numLine"> 30</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 31</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"> 32</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 33</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">class</span> PooledSoftReference<T> <span class="keyword">extends</span> DefaultPooledObject<T> {</pre></td></tr
-<tr> <td class="numLine"> 34</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 35</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/** SoftReference wrapped by this object */</span></pre></td></tr
-<tr> <td class="numLine"> 36</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">private</span> <span class="keyword">volatile</span> SoftReference<T> reference;</pre></td></tr
-<tr> <td class="numLine"> 37</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 38</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 39</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Creates a new PooledSoftReference wrapping the provided reference.</span></pre></td></tr
-<tr> <td class="numLine"> 40</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 41</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param reference SoftReference to be managed by the pool</span></pre></td></tr
-<tr> <td class="numLine"> 42</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 43</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> PooledSoftReference(SoftReference<T> reference) {</pre></td></tr
-<tr> <td class="numLineCover"> 44</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> <span class="keyword">super</span>(<span class="keyword">null</span>); <span class="comment">// Null the hard reference in the parent</span></pre></td></tr
-<tr> <td class="numLineCover"> 45</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> <span class="keyword">this</span>.reference = reference;</pre></td></tr
-<tr> <td class="numLineCover"> 46</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 47</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 48</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 49</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Returns the object that the wrapped SoftReference refers to.</span></pre></td></tr
-<tr> <td class="numLine"> 50</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr
-<tr> <td class="numLine"> 51</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Note that if the reference has been cleared, this method will return</span></pre></td></tr
-<tr> <td class="numLine"> 52</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * null.</span></pre></td></tr
-<tr> <td class="numLine"> 53</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 54</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @return Object referred to by the SoftReference</span></pre></td></tr
-<tr> <td class="numLine"> 55</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 56</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> @Override</pre></td></tr
-<tr> <td class="numLine"> 57</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> T getObject() {</pre></td></tr
-<tr> <td class="numLineCover"> 58</td> <td class="nbHitsCovered"> 221</td> <td class="src"><pre class="src"> <span class="keyword">return</span> reference.get();</pre></td></tr
-<tr> <td class="numLine"> 59</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 60</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 61</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 62</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * {@inheritDoc}</span></pre></td></tr
-<tr> <td class="numLine"> 63</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 64</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> @Override</pre></td></tr
-<tr> <td class="numLine"> 65</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> String toString() {</pre></td></tr
-<tr> <td class="numLineCover"> 66</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> StringBuilder result = <span class="keyword">new</span> StringBuilder();</pre></td></tr
-<tr> <td class="numLineCover"> 67</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(<span class="string">"Referenced Object: "</span>);</pre></td></tr
-<tr> <td class="numLineCover"> 68</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(getObject().toString());</pre></td></tr
-<tr> <td class="numLineCover"> 69</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(<span class="string">", State: "</span>);</pre></td></tr
-<tr> <td class="numLineCover"> 70</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> <span class="keyword">synchronized</span> (<span class="keyword">this</span>) {</pre></td></tr
-<tr> <td class="numLineCover"> 71</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(getState().toString());</pre></td></tr
-<tr> <td class="numLineCover"> 72</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLineCover"> 73</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> <span class="keyword">return</span> result.toString();</pre></td></tr
-<tr> <td class="numLine"> 74</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">// TODO add other attributes</span></pre></td></tr
-<tr> <td class="numLine"> 75</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">// TODO encapsulate state and other attribute display in parent</span></pre></td></tr
-<tr> <td class="numLine"> 76</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 77</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </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"> * Returns the SoftReference wrapped by this object.</span></pre></td></tr
-<tr> <td class="numLine"> 80</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 81</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @return underlying SoftReference</span></pre></td></tr
-<tr> <td class="numLine"> 82</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 83</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">synchronized</span> SoftReference<T> getReference() {</pre></td></tr
-<tr> <td class="numLineCover"> 84</td> <td class="nbHitsCovered"> 266</td> <td class="src"><pre class="src"> <span class="keyword">return</span> reference;</pre></td></tr
-<tr> <td class="numLine"> 85</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 86</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> </pre></td></tr
-<tr> <td class="numLine"> 87</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr
-<tr> <td class="numLine"> 88</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * Sets the wrapped reference.</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"> <span class="comment"> * <p>This method exists to allow a new, non-registered reference to be</span></pre></td></tr
-<tr> <td class="numLine"> 91</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * held by the pool to track objects that have been checked out of the pool.</span></pre></td></tr
-<tr> <td class="numLine"> 92</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * The actual parameter <strong>should</strong> be a reference to the same</span></pre></td></tr
-<tr> <td class="numLine"> 93</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * object that {@link #getObject()} returns before calling this method.</p></span></pre></td></tr
-<tr> <td class="numLine"> 94</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr
-<tr> <td class="numLine"> 95</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> * @param reference new reference</span></pre></td></tr
-<tr> <td class="numLine"> 96</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr
-<tr> <td class="numLine"> 97</td> <td class="nbHits"> </td
- <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">synchronized</span> <span class="keyword">void</span> setReference(SoftReference<T> reference) {</pre></td></tr
-<tr> <td class="numLineCover"> 98</td> <td class="nbHitsCovered"> 11</td> <td class="src"><pre class="src"> <span class="keyword">this</span>.reference = reference;</pre></td></tr
-<tr> <td class="numLineCover"> 99</td> <td class="nbHitsCovered"> 11</td> <td class="src"><pre class="src"> }</pre></td></tr
-<tr> <td class="numLine"> 100</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.impl;</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="keyword">import</span> java.lang.ref.SoftReference;</pre></td></tr>
+<tr> <td class="numLine"> 20</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 21</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 22</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Extension of {@link DefaultPooledObject} to wrap pooled soft references.</span></pre></td></tr>
+<tr> <td class="numLine"> 23</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 24</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p>This class is intended to be thread-safe.</p></span></pre></td></tr>
+<tr> <td class="numLine"> 25</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 26</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param <T> the type of the underlying object that the wrapped SoftReference</span></pre></td></tr>
+<tr> <td class="numLine"> 27</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * refers to.</span></pre></td></tr>
+<tr> <td class="numLine"> 28</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 29</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @version $Revision: $</span></pre></td></tr>
+<tr> <td class="numLine"> 30</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 31</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"> 32</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 33</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">class</span> PooledSoftReference<T> <span class="keyword">extends</span> DefaultPooledObject<T> {</pre></td></tr>
+<tr> <td class="numLine"> 34</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 35</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/** SoftReference wrapped by this object */</span></pre></td></tr>
+<tr> <td class="numLine"> 36</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">private</span> <span class="keyword">volatile</span> SoftReference<T> reference;</pre></td></tr>
+<tr> <td class="numLine"> 37</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 38</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 39</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Creates a new PooledSoftReference wrapping the provided reference.</span></pre></td></tr>
+<tr> <td class="numLine"> 40</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 41</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param reference SoftReference to be managed by the pool</span></pre></td></tr>
+<tr> <td class="numLine"> 42</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 43</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> PooledSoftReference(SoftReference<T> reference) {</pre></td></tr>
+<tr> <td class="numLineCover"> 44</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> <span class="keyword">super</span>(<span class="keyword">null</span>); <span class="comment">// Null the hard reference in the parent</span></pre></td></tr>
+<tr> <td class="numLineCover"> 45</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> <span class="keyword">this</span>.reference = reference;</pre></td></tr>
+<tr> <td class="numLineCover"> 46</td> <td class="nbHitsCovered"> 53</td> <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 47</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 48</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 49</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Returns the object that the wrapped SoftReference refers to.</span></pre></td></tr>
+<tr> <td class="numLine"> 50</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * <p></span></pre></td></tr>
+<tr> <td class="numLine"> 51</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Note that if the reference has been cleared, this method will return</span></pre></td></tr>
+<tr> <td class="numLine"> 52</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * null.</span></pre></td></tr>
+<tr> <td class="numLine"> 53</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 54</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @return Object referred to by the SoftReference</span></pre></td></tr>
+<tr> <td class="numLine"> 55</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 56</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> @Override</pre></td></tr>
+<tr> <td class="numLine"> 57</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> T getObject() {</pre></td></tr>
+<tr> <td class="numLineCover"> 58</td> <td class="nbHitsCovered"> 221</td> <td class="src"><pre class="src"> <span class="keyword">return</span> reference.get();</pre></td></tr>
+<tr> <td class="numLine"> 59</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 60</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 61</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 62</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * {@inheritDoc}</span></pre></td></tr>
+<tr> <td class="numLine"> 63</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 64</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> @Override</pre></td></tr>
+<tr> <td class="numLine"> 65</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> String toString() {</pre></td></tr>
+<tr> <td class="numLineCover"> 66</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> StringBuilder result = <span class="keyword">new</span> StringBuilder();</pre></td></tr>
+<tr> <td class="numLineCover"> 67</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(<span class="string">"Referenced Object: "</span>);</pre></td></tr>
+<tr> <td class="numLineCover"> 68</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(getObject().toString());</pre></td></tr>
+<tr> <td class="numLineCover"> 69</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(<span class="string">", State: "</span>);</pre></td></tr>
+<tr> <td class="numLineCover"> 70</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> <span class="keyword">synchronized</span> (<span class="keyword">this</span>) {</pre></td></tr>
+<tr> <td class="numLineCover"> 71</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> result.append(getState().toString());</pre></td></tr>
+<tr> <td class="numLineCover"> 72</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLineCover"> 73</td> <td class="nbHitsCovered"> 1</td> <td class="src"><pre class="src"> <span class="keyword">return</span> result.toString();</pre></td></tr>
+<tr> <td class="numLine"> 74</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">// TODO add other attributes</span></pre></td></tr>
+<tr> <td class="numLine"> 75</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">// TODO encapsulate state and other attribute display in parent</span></pre></td></tr>
+<tr> <td class="numLine"> 76</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 77</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </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"> * Returns the SoftReference wrapped by this object.</span></pre></td></tr>
+<tr> <td class="numLine"> 80</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 81</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @return underlying SoftReference</span></pre></td></tr>
+<tr> <td class="numLine"> 82</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 83</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">synchronized</span> SoftReference<T> getReference() {</pre></td></tr>
+<tr> <td class="numLineCover"> 84</td> <td class="nbHitsCovered"> 266</td> <td class="src"><pre class="src"> <span class="keyword">return</span> reference;</pre></td></tr>
+<tr> <td class="numLine"> 85</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 86</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> </pre></td></tr>
+<tr> <td class="numLine"> 87</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment">/**</span></pre></td></tr>
+<tr> <td class="numLine"> 88</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * Sets the wrapped reference.</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"> <span class="comment"> * <p>This method exists to allow a new, non-registered reference to be</span></pre></td></tr>
+<tr> <td class="numLine"> 91</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * held by the pool to track objects that have been checked out of the pool.</span></pre></td></tr>
+<tr> <td class="numLine"> 92</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * The actual parameter <strong>should</strong> be a reference to the same</span></pre></td></tr>
+<tr> <td class="numLine"> 93</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * object that {@link #getObject()} returns before calling this method.</p></span></pre></td></tr>
+<tr> <td class="numLine"> 94</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> *</span></pre></td></tr>
+<tr> <td class="numLine"> 95</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> * @param reference new reference</span></pre></td></tr>
+<tr> <td class="numLine"> 96</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="comment"> */</span></pre></td></tr>
+<tr> <td class="numLine"> 97</td> <td class="nbHits"> </td>
+ <td class="src"><pre class="src"> <span class="keyword">public</span> <span class="keyword">synchronized</span> <span class="keyword">void</span> setReference(SoftReference<T> reference) {</pre></td></tr>
+<tr> <td class="numLineCover"> 98</td> <td class="nbHitsCovered"> 11</td> <td class="src"><pre class="src"> <span class="keyword">this</span>.reference = reference;</pre></td></tr>
+<tr> <td class="numLineCover"> 99</td> <td class="nbHitsCovered"> 11</td> <td class="src"><pre class="src"> }</pre></td></tr>
+<tr> <td class="numLine"> 100</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>