User: mulder
Date: 00/09/01 05:59:28
Modified: minerva/org/jboss/minerva/pools ObjectPool.html
PoolEvent.html PoolEventListener.html
PoolObjectFactory.html PooledObject.html
package-frame.html package-summary.html
package-tree.html
Log:
Update Minerva documentation to 0.98
Add JARs for separate download
Revision Changes Path
1.2 +99 -21 jbossweb/minerva/org/jboss/minerva/pools/ObjectPool.html
Index: ObjectPool.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/ObjectPool.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ObjectPool.html 2000/08/29 23:14:33 1.1
+++ ObjectPool.html 2000/09/01 12:59:26 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:37 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:16 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Class ObjectPool
+Minerva Object/Database Pools v0.98: Class ObjectPool
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -235,6 +235,14 @@
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#isInvalidateOnError()">isInvalidateOnError</A></B>()</CODE>
+
+<BR>
+ Gets whether objects
are removed from the pool in case of errors.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#isShrinkingEnabled()">isShrinkingEnabled</A></B>()</CODE>
<BR>
@@ -251,6 +259,15 @@
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#markObjectAsInvalid(java.lang.Object)">markObjectAsInvalid</A></B>(<A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A> object)</CODE>
+
+<BR>
+ Indicates that an
object is no longer valid, and should be removed from
+ the pool entirely.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#objectClosed(org.jboss.minerva.pools.PoolEvent)">objectClosed</A></B>(<A
HREF="../../../../org/jboss/minerva/pools/PoolEvent.html">PoolEvent</A> evt)</CODE>
<BR>
@@ -319,6 +336,14 @@
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setInvalidateOnError(boolean)">setInvalidateOnError</A></B>(boolean invalidate)</CODE>
+
+<BR>
+ Sets the response for
object errors.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setLastUsed(java.lang.Object)">setLastUsed</A></B>(<A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A> object)</CODE>
<BR>
@@ -517,7 +542,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the object factory after the pool has been
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the object factory after the pool has been
initialized.</DL>
</DD>
</DL>
@@ -535,7 +560,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the object factory after the pool has been
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the object factory after the pool has been
initialized.</DL>
</DD>
</DL>
@@ -553,7 +578,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the name of the pool more than once.</DL>
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the name of the pool more than once.</DL>
</DD>
</DL>
<HR>
@@ -591,7 +616,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the log writer after the pool has been
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the log writer after the pool has been
initialized.</DL>
</DD>
</DL>
@@ -609,7 +634,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the minimum size after the pool has been
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the minimum size after the pool has been
initialized.</DL>
</DD>
</DL>
@@ -644,7 +669,7 @@
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>size</CODE> - The maximum size of the pool, or 0 if
the pool should grow
- indefinitely (not
recommended).<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> -
Occurs when you try to set the maximum size after the pool has been
+ indefinitely (not recommended).<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the maximum size after the pool has been
initialized.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setBlocking(boolean)"><CODE>setBlocking(boolean)</CODE></A></DL>
</DD>
</DL>
@@ -692,7 +717,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the shrinking state after the pool has been
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the shrinking state after the pool has been
initialized.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setGCInterval(long)"><CODE>setGCInterval(long)</CODE></A>,
<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setShrinkMinIdleTime(long)"><CODE>setShrinkMinIdleTime(long)</CODE></A>,
<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setShrinkPercent(float)"><CODE>setShrinkPercent(float)</CODE></A>,
@@ -734,7 +759,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the garbage collection state after the pool
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the garbage collection state after the pool
has been initialized.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setGCMinIdleTime(long)"><CODE>setGCMinIdleTime(long)</CODE></A>,
<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setGCInterval(long)"><CODE>setGCInterval(long)</CODE></A></DL>
</DD>
@@ -769,7 +794,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the shrinking percent after the pool
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the shrinking percent after the pool
has been initialized.<DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE>
- Occurs when the percent parameter is not between 0 and 1.<DT><B>See Also:
</B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setShrinkingEnabled(boolean)"><CODE>setShrinkingEnabled(boolean)</CODE></A></DL>
</DD>
</DL>
@@ -803,7 +828,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>millis</CODE> - The idle time, in
milliseconds.<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> -
Occurs when you try to set the shrinking idle time after the pool
+<DT><B>Parameters:</B><DD><CODE>millis</CODE> - The idle time, in
milliseconds.<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the shrinking idle time after the pool
has been initialized.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setShrinkingEnabled(boolean)"><CODE>setShrinkingEnabled(boolean)</CODE></A></DL>
</DD>
</DL>
@@ -838,7 +863,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>millis</CODE> - The idle time, in
milliseconds.<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> -
Occurs when you try to set the garbage collection idle time after the
+<DT><B>Parameters:</B><DD><CODE>millis</CODE> - The idle time, in
milliseconds.<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the garbage collection idle time after the
pool has been initialized.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setGCEnabled(boolean)"><CODE>setGCEnabled(boolean)</CODE></A></DL>
</DD>
</DL>
@@ -877,7 +902,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the garbage collection interval after the
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the garbage collection interval after the
pool has been initialized.</DL>
</DD>
</DL>
@@ -911,7 +936,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the blocking parameter after the
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the blocking parameter after the
pool has been initialized.</DL>
</DD>
</DL>
@@ -945,7 +970,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to set the timestamp parameter after the
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to set the timestamp parameter after the
pool has been initialized.</DL>
</DD>
</DL>
@@ -962,6 +987,38 @@
</DL>
<HR>
+<A NAME="setInvalidateOnError(boolean)"><!-- --></A><H3>
+setInvalidateOnError</H3>
+<PRE>
+public void <B>setInvalidateOnError</B>(boolean invalidate)</PRE>
+<DL>
+<DD>Sets the response for object errors. If this flag is set and an error
+ event occurs, the object is removed from the pool entirely. Otherwise,
+ the object is returned to the pool of available objects. For example, a
+ SQL error may not indicate a bad database connection (flag not set),
+ while a TCP/IP error probably indicates a bad network connection (flag
+ set). If this flag is not set, you can still manually invalidate
+ objects using markObjectAsInvalid.<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#markObjectAsInvalid(java.lang.Object)"><CODE>markObjectAsInvalid(java.lang.Object)</CODE></A>,
+<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#objectError(org.jboss.minerva.pools.PoolEvent)"><CODE>objectError(org.jboss.minerva.pools.PoolEvent)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isInvalidateOnError()"><!-- --></A><H3>
+isInvalidateOnError</H3>
+<PRE>
+public boolean <B>isInvalidateOnError</B>()</PRE>
+<DL>
+<DD>Gets whether objects are removed from the pool in case of errors.<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
<A NAME="initialize()"><!-- --></A><H3>
initialize</H3>
<PRE>
@@ -973,7 +1030,7 @@
</DL>
</DD>
<DD><DL>
-<DT><B>Throws:</B><DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
you try to initialize the pool without setting the object
+<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when you try to initialize the pool without setting the object
factory or name, or you initialize the pool more than once.</DL>
</DD>
</DL>
@@ -1022,7 +1079,27 @@
</DD>
<DD><DL>
<DT><B>Throws:</B><DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE>
- Occurs when the object is not recognized by the factory or not
- in the pool.<DD><CODE>java.lang.IllegalStateException</CODE> - Occurs when
the object is not currently in use.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setTimestampUsed(boolean)"><CODE>setTimestampUsed(boolean)</CODE></A></DL>
+ in the pool.<DD><CODE><A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/IllegalStateException.html">IllegalStateException</A></CODE>
- Occurs when the object is not currently in use.<DT><B>See Also: </B><DD><A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html#setTimestampUsed(boolean)"><CODE>setTimestampUsed(boolean)</CODE></A></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="markObjectAsInvalid(java.lang.Object)"><!-- --></A><H3>
+markObjectAsInvalid</H3>
+<PRE>
+public void <B>markObjectAsInvalid</B>(<A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A> object)</PRE>
+<DL>
+<DD>Indicates that an object is no longer valid, and should be removed from
+ the pool entirely. This should be called before the object is returned
+ to the pool (specifically, before factory.returnObject returns), or else
+ the object may be given out again by the time this is called! Also, you
+ still need to actually return the object to the pool by calling
+ releaseObject, if you aren't calling this during that process already.<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>Object</CODE> - The object to invalidate, which
must be the exact object
+ returned by getObject</DL>
</DD>
</DL>
<HR>
@@ -1072,7 +1149,8 @@
public void <B>objectError</B>(<A
HREF="../../../../org/jboss/minerva/pools/PoolEvent.html">PoolEvent</A> evt)</PRE>
<DL>
<DD>If the object had an error, we assume this will propogate and preclude it
- from being closed, so we will close it.<DD><DL>
+ from being closed, so we will close it. If the invalidateOnError flag
+ is set, the object will be removed from the pool entirely.<DD><DL>
<DT><B>Specified by: </B><DD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolEventListener.html#objectError(org.jboss.minerva.pools.PoolEvent)">objectError</A></CODE>
in interface <CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolEventListener.html">PoolEventListener</A></CODE></DL>
</DD>
</DL>
@@ -1110,7 +1188,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +40 -4 jbossweb/minerva/org/jboss/minerva/pools/PoolEvent.html
Index: PoolEvent.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/PoolEvent.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PoolEvent.html 2000/08/29 23:14:34 1.1
+++ PoolEvent.html 2000/09/01 12:59:26 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:37 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:16 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Class PoolEvent
+Minerva Object/Database Pools v0.98: Class PoolEvent
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -162,6 +162,24 @@
<BR>
Gets the event
type.</TD>
</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> boolean</CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/PoolEvent.html#isCatastrophic()">isCatastrophic</A></B>()</CODE>
+
+<BR>
+ Gets whether an object
error was so bad that the object should not
+ be reused by the pool.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/PoolEvent.html#setCatastrophic()">setCatastrophic</A></B>()</CODE>
+
+<BR>
+ Marks this as an error
so severe that the object should not be reused by
+ the pool.</TD>
+</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.util.EventObject"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
@@ -269,6 +287,24 @@
<A
HREF="../../../../org/jboss/minerva/pools/PoolEvent.html#OBJECT_ERROR"><CODE>OBJECT_ERROR</CODE></A></DL>
</DD>
</DL>
+<HR>
+
+<A NAME="isCatastrophic()"><!-- --></A><H3>
+isCatastrophic</H3>
+<PRE>
+public boolean <B>isCatastrophic</B>()</PRE>
+<DL>
+<DD>Gets whether an object error was so bad that the object should not
+ be reused by the pool. This is meaningful for error events only.</DL>
+<HR>
+
+<A NAME="setCatastrophic()"><!-- --></A><H3>
+setCatastrophic</H3>
+<PRE>
+public void <B>setCatastrophic</B>()</PRE>
+<DL>
+<DD>Marks this as an error so severe that the object should not be reused by
+ the pool.</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
@@ -291,7 +327,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +4 -4 jbossweb/minerva/org/jboss/minerva/pools/PoolEventListener.html
Index: PoolEventListener.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/PoolEventListener.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PoolEventListener.html 2000/08/29 23:14:35 1.1
+++ PoolEventListener.html 2000/09/01 12:59:26 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:37 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:16 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Interface PoolEventListener
+Minerva Object/Database Pools v0.98: Interface PoolEventListener
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -175,7 +175,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +29 -4 jbossweb/minerva/org/jboss/minerva/pools/PoolObjectFactory.html
Index: PoolObjectFactory.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/PoolObjectFactory.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PoolObjectFactory.html 2000/08/29 23:14:36 1.1
+++ PoolObjectFactory.html 2000/09/01 12:59:26 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:37 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:16 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Class PoolObjectFactory
+Minerva Object/Database Pools v0.98: Class PoolObjectFactory
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -124,6 +124,15 @@
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A></CODE></FONT></TD>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#isUniqueRequest()">isUniqueRequest</A></B>()</CODE>
+
+<BR>
+ Decides whether a
request for an object should be fulfilled by an
+ object checked out of the pool previously, or a new object.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#poolClosing(org.jboss.minerva.pools.ObjectPool)">poolClosing</A></B>(<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html">ObjectPool</A> pool)</CODE>
@@ -312,6 +321,22 @@
<DD>Permanently closes an object, after it is removed from the pool. The
object will not be returned to the pool - after this, it is gone. This
is called when the pool shrinks, and when the pool is shut down.</DL>
+<HR>
+
+<A NAME="isUniqueRequest()"><!-- --></A><H3>
+isUniqueRequest</H3>
+<PRE>
+public <A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/lang/Object.html">Object</A>
<B>isUniqueRequest</B>()</PRE>
+<DL>
+<DD>Decides whether a request for an object should be fulfilled by an
+ object checked out of the pool previously, or a new object. In general,
+ every request should generate a new object, so this should return null.<DD><DL>
+<DT><B>Returns:</B><DD>An existing object, if this request is effectively the same
as
+ a previous request and the result should be shared. <B>null</B>
+ if this is a unique request and should be fulfilled by a unique
+ object.</DL>
+</DD>
+</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
@@ -334,7 +359,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +4 -4 jbossweb/minerva/org/jboss/minerva/pools/PooledObject.html
Index: PooledObject.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/PooledObject.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- PooledObject.html 2000/08/29 23:14:37 1.1
+++ PooledObject.html 2000/09/01 12:59:26 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:37 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:16 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Interface PooledObject
+Minerva Object/Database Pools v0.98: Interface PooledObject
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -163,7 +163,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +2 -2 jbossweb/minerva/org/jboss/minerva/pools/package-frame.html
Index: package-frame.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/package-frame.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package-frame.html 2000/08/29 23:14:37 1.1
+++ package-frame.html 2000/09/01 12:59:27 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:36 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:15 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Package org.jboss.minerva.pools
+Minerva Object/Database Pools v0.98: Package org.jboss.minerva.pools
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
1.2 +4 -4 jbossweb/minerva/org/jboss/minerva/pools/package-summary.html
Index: package-summary.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/package-summary.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package-summary.html 2000/08/29 23:14:38 1.1
+++ package-summary.html 2000/09/01 12:59:27 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:36 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:15 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Package org.jboss.minerva.pools
+Minerva Object/Database Pools v0.98: Package org.jboss.minerva.pools
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -127,7 +127,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
1.2 +4 -4 jbossweb/minerva/org/jboss/minerva/pools/package-tree.html
Index: package-tree.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/pools/package-tree.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package-tree.html 2000/08/29 23:14:38 1.1
+++ package-tree.html 2000/09/01 12:59:27 1.2
@@ -2,9 +2,9 @@
<!--NewPage-->
<HTML>
<HEAD>
-<!-- Generated by javadoc on Sat Jun 24 11:16:36 EDT 2000 -->
+<!-- Generated by javadoc on Thu Aug 31 15:28:15 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: org.jboss.minerva.pools Class Hierarchy
+Minerva Object/Database Pools v0.98: org.jboss.minerva.pools Class Hierarchy
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
@@ -29,7 +29,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
@@ -90,7 +90,7 @@
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
-</EM>
+Part of the <A HREF=http://www.jboss.org/ TARGET=_top>jBoss Project</A></EM>
</TD>
</TR>
