genericobjectpool.html

用JAVA编写的,在做实验的时候留下来的,本来想删的,但是传上来,大家分享吧

<a name="516" href="#516">516</a> <em>     * an exception when the pool is exhausted and the</em>
<a name="517" href="#517">517</a> <em>     * {@link #setWhenExhaustedAction "when exhausted" action} is</em>
<a name="518" href="#518">518</a> <em>     * {@link #WHEN_EXHAUSTED_BLOCK}.</em>
<a name="519" href="#519">519</a> <em>     *</em>
<a name="520" href="#520">520</a> <em>     * When less than 0, the {@link #borrowObject} method</em>
<a name="521" href="#521">521</a> <em>     * may block indefinitely.</em>
<a name="522" href="#522">522</a> <em>     *</em>
<a name="523" href="#523">523</a> <em>     * @see #getMaxWait</em>
<a name="524" href="#524">524</a> <em>     * @see #setWhenExhaustedAction</em>
<a name="525" href="#525">525</a> <em>     * @see #WHEN_EXHAUSTED_BLOCK</em>
<a name="526" href="#526">526</a> <em>     */</em>
<a name="527" href="#527">527</a>     <strong>public</strong> <strong>synchronized</strong> <strong>void</strong> setMaxWait(<strong>long</strong> maxWait) {
<a name="528" href="#528">528</a>         _maxWait = maxWait;
<a name="529" href="#529">529</a>         notifyAll();
<a name="530" href="#530">530</a>     }
<a name="531" href="#531">531</a> 
<a name="532" href="#532">532</a>     <em>/**<em>*</em></em>
<a name="533" href="#533">533</a> <em>     * Returns the cap on the number of "idle" instances in the pool.</em>
<a name="534" href="#534">534</a> <em>     * @return the cap on the number of "idle" instances in the pool.</em>
<a name="535" href="#535">535</a> <em>     * @see #setMaxIdle</em>
<a name="536" href="#536">536</a> <em>     */</em>
<a name="537" href="#537">537</a>     <strong>public</strong> <strong>synchronized</strong> <strong>int</strong> getMaxIdle() {
<a name="538" href="#538">538</a>         <strong>return</strong> _maxIdle;
<a name="539" href="#539">539</a>     }
<a name="540" href="#540">540</a> 
<a name="541" href="#541">541</a>     <em>/**<em>*</em></em>
<a name="542" href="#542">542</a> <em>     * Sets the cap on the number of "idle" instances in the pool.</em>
<a name="543" href="#543">543</a> <em>     * @param maxIdle The cap on the number of "idle" instances in the pool.</em>
<a name="544" href="#544">544</a> <em>     *                Use a negative value to indicate an unlimited number</em>
<a name="545" href="#545">545</a> <em>     *                of idle instances.</em>
<a name="546" href="#546">546</a> <em>     * @see #getMaxIdle</em>
<a name="547" href="#547">547</a> <em>     */</em>
<a name="548" href="#548">548</a>     <strong>public</strong> <strong>synchronized</strong> <strong>void</strong> setMaxIdle(<strong>int</strong> maxIdle) {
<a name="549" href="#549">549</a>         _maxIdle = maxIdle;
<a name="550" href="#550">550</a>         notifyAll();
<a name="551" href="#551">551</a>     }
<a name="552" href="#552">552</a> 
<a name="553" href="#553">553</a>     <em>/**<em>*</em></em>
<a name="554" href="#554">554</a> <em>     * Sets the minimum number of objects allowed in the pool</em>
<a name="555" href="#555">555</a> <em>     * before the evictor thread (if active) spawns new objects.</em>
<a name="556" href="#556">556</a> <em>     * (Note no objects are created when: numActive + numIdle >= maxActive)</em>
<a name="557" href="#557">557</a> <em>     *</em>
<a name="558" href="#558">558</a> <em>     * @param minIdle The minimum number of objects.</em>
<a name="559" href="#559">559</a> <em>     * @see #getMinIdle</em>
<a name="560" href="#560">560</a> <em>     */</em>
<a name="561" href="#561">561</a>     <strong>public</strong> <strong>synchronized</strong> <strong>void</strong> setMinIdle(<strong>int</strong> minIdle) {
<a name="562" href="#562">562</a>         _minIdle = minIdle;
<a name="563" href="#563">563</a>         notifyAll();
<a name="564" href="#564">564</a>     }
<a name="565" href="#565">565</a> 
<a name="566" href="#566">566</a>     <em>/**<em>*</em></em>
<a name="567" href="#567">567</a> <em>     * Returns the minimum number of objects allowed in the pool</em>
<a name="568" href="#568">568</a> <em>     * before the evictor thread (if active) spawns new objects.</em>
<a name="569" href="#569">569</a> <em>     * (Note no objects are created when: numActive + numIdle >= maxActive)</em>
<a name="570" href="#570">570</a> <em>     *</em>
<a name="571" href="#571">571</a> <em>     * @return The minimum number of objects.</em>
<a name="572" href="#572">572</a> <em>     * @see #setMinIdle</em>
<a name="573" href="#573">573</a> <em>     */</em>
<a name="574" href="#574">574</a>     <strong>public</strong> <strong>synchronized</strong> <strong>int</strong> getMinIdle() {
<a name="575" href="#575">575</a>         <strong>return</strong> _minIdle;
<a name="576" href="#576">576</a>     }
<a name="577" href="#577">577</a> 
<a name="578" href="#578">578</a>     <em>/**<em>*</em></em>
<a name="579" href="#579">579</a> <em>     * When &lt;tt>true&lt;/tt>, objects will be</em>
<a name="580" href="#580">580</a> <em>     * {@link PoolableObjectFactory#validateObject validated}</em>
<a name="581" href="#581">581</a> <em>     * before being returned by the {@link #borrowObject}</em>
<a name="582" href="#582">582</a> <em>     * method.  If the object fails to validate,</em>
<a name="583" href="#583">583</a> <em>     * it will be dropped from the pool, and we will attempt</em>
<a name="584" href="#584">584</a> <em>     * to borrow another.</em>
<a name="585" href="#585">585</a> <em>     *</em>
<a name="586" href="#586">586</a> <em>     * @see #setTestOnBorrow</em>
<a name="587" href="#587">587</a> <em>     */</em>
<a name="588" href="#588">588</a>     <strong>public</strong> <strong>synchronized</strong> <strong>boolean</strong> getTestOnBorrow() {
<a name="589" href="#589">589</a>         <strong>return</strong> _testOnBorrow;
<a name="590" href="#590">590</a>     }
<a name="591" href="#591">591</a> 
<a name="592" href="#592">592</a>     <em>/**<em>*</em></em>
<a name="593" href="#593">593</a> <em>     * When &lt;tt>true&lt;/tt>, objects will be</em>
<a name="594" href="#594">594</a> <em>     * {@link PoolableObjectFactory#validateObject validated}</em>
<a name="595" href="#595">595</a> <em>     * before being returned by the {@link #borrowObject}</em>
<a name="596" href="#596">596</a> <em>     * method.  If the object fails to validate,</em>
<a name="597" href="#597">597</a> <em>     * it will be dropped from the pool, and we will attempt</em>
<a name="598" href="#598">598</a> <em>     * to borrow another.</em>
<a name="599" href="#599">599</a> <em>     *</em>
<a name="600" href="#600">600</a> <em>     * @see #getTestOnBorrow</em>
<a name="601" href="#601">601</a> <em>     */</em>
<a name="602" href="#602">602</a>     <strong>public</strong> <strong>synchronized</strong> <strong>void</strong> setTestOnBorrow(<strong>boolean</strong> testOnBorrow) {
<a name="603" href="#603">603</a>         _testOnBorrow = testOnBorrow;
<a name="604" href="#604">604</a>     }
<a name="605" href="#605">605</a> 
<a name="606" href="#606">606</a>     <em>/**<em>*</em></em>
<a name="607" href="#607">607</a> <em>     * When &lt;tt>true&lt;/tt>, objects will be</em>
<a name="608" href="#608">608</a> <em>     * {@link PoolableObjectFactory#validateObject validated}</em>
<a name="609" href="#609">609</a> <em>     * before being returned to the pool within the</em>
<a name="610" href="#610">610</a> <em>     * {@link #returnObject}.</em>
<a name="611" href="#611">611</a> <em>     *</em>
<a name="612" href="#612">612</a> <em>     * @see #setTestOnReturn</em>
<a name="613" href="#613">613</a> <em>     */</em>
<a name="614" href="#614">614</a>     <strong>public</strong> <strong>synchronized</strong> <strong>boolean</strong> getTestOnReturn() {
<a name="615" href="#615">615</a>         <strong>return</strong> _testOnReturn;
<a name="616" href="#616">616</a>     }
<a name="617" href="#617">617</a> 
<a name="618" href="#618">618</a>     <em>/**<em>*</em></em>
<a name="619" href="#619">619</a> <em>     * When &lt;tt>true&lt;/tt>, objects will be</em>
<a name="620" href="#620">620</a> <em>     * {@link PoolableObjectFactory#validateObject validated}</em>
<a name="621" href="#621">621</a> <em>     * before being returned to the pool within the</em>
<a name="622" href="#622">622</a> <em>     * {@link #returnObject}.</em>
<a name="623" href="#623">623</a> <em>     *</em>
<a name="624" href="#624">624</a> <em>     * @see #getTestOnReturn</em>
<a name="625" href="#625">625</a> <em>     */</em>
<a name="626" href="#626">626</a>     <strong>public</strong> <strong>synchronized</strong> <strong>void</strong> setTestOnReturn(<strong>boolean</strong> testOnReturn) {
<a name="627" href="#627">627</a>         _testOnReturn = testOnReturn;
<a name="628" href="#628">628</a>     }
<a name="629" href="#629">629</a> 
<a name="630" href="#630">630</a>     <em>/**<em>*</em></em>
<a name="631" href="#631">631</a> <em>     * Returns the number of milliseconds to sleep between runs of the</em>
<a name="632" href="#632">632</a> <em>     * idle object evictor thread.</em>
<a name="633" href="#633">633</a> <em>     * When non-positive, no idle object evictor thread will be</em>
<a name="634" href="#634">634</a> <em>     * run.</em>
<a name="635" href="#635">635</a> <em>     *</em>
<a name="636" href="#636">636</a> <em>     * @see #setTimeBetweenEvictionRunsMillis</em>
<a name="637" href="#637">637</a> <em>     */</em>
<a name="638" href="#638">638</a>     <strong>public</strong> <strong>synchronized</strong> <strong>long</strong> getTimeBetweenEvictionRunsMillis() {
<a name="639" href="#639">639</a>         <strong>return</strong> _timeBetweenEvictionRunsMillis;
<a name="640" href="#640">640</a>     }
<a name="641" href="#641">641</a> 
<a name="642" href="#642">642</a>     <em>/**<em>*</em></em>
<a name="643" href="#643">643</a> <em>     * Sets the number of milliseconds to sleep between runs of the</em>
<a name="644" href="#644">644</a> <em>     * idle object evictor thread.</