User: mulder
Date: 00/09/01 05:59:23
Modified: minerva/org/jboss/minerva/factories
JDBCConnectionFactory.html XAConnectionFactory.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 +30 -5
jbossweb/minerva/org/jboss/minerva/factories/JDBCConnectionFactory.html
Index: JDBCConnectionFactory.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/factories/JDBCConnectionFactory.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- JDBCConnectionFactory.html 2000/08/29 23:14:07 1.1
+++ JDBCConnectionFactory.html 2000/09/01 12:59:22 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:15 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Class JDBCConnectionFactory
+Minerva Object/Database Pools v0.98: Class JDBCConnectionFactory
</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>
@@ -160,6 +160,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/factories/JDBCConnectionFactory.html#poolClosing(org.jboss.minerva.pools.ObjectPool)">poolClosing</A></B>(<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html">ObjectPool</A> pool)</CODE>
+
+<BR>
+ Cleans up.</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/factories/JDBCConnectionFactory.html#poolStarted(org.jboss.minerva.pools.ObjectPool,
java.io.PrintWriter)">poolStarted</A></B>(<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html">ObjectPool</A> pool,
<A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/PrintWriter.html">PrintWriter</A> log)</CODE>
@@ -230,7 +238,7 @@
<TD><B>Methods inherited from class org.jboss.minerva.pools.<A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html">PoolObjectFactory</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
-<TD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#poolClosing(org.jboss.minerva.pools.ObjectPool)">poolClosing</A></CODE></TD>
+<TD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#isUniqueRequest()">isUniqueRequest</A></CODE></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
@@ -362,6 +370,23 @@
</DL>
<HR>
+<A NAME="poolClosing(org.jboss.minerva.pools.ObjectPool)"><!-- --></A><H3>
+poolClosing</H3>
+<PRE>
+public void <B>poolClosing</B>(<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html">ObjectPool</A> pool)</PRE>
+<DL>
+<DD>Cleans up.<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#poolClosing(org.jboss.minerva.pools.ObjectPool)">poolClosing</A></CODE>
in class <CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html">PoolObjectFactory</A></CODE></DL>
+</DD>
+<DD>Following copied from class:
<CODE>org.jboss.minerva.pools.PoolObjectFactory</CODE></DD>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>pool</CODE> - The pool that is closing. You may
decide to allow
+ multiple pools you use your factory, or to restrict it to a one-to-one
+ relationship.<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 pool is null.</DL>
+</DD>
+</DL>
+<HR>
+
<A NAME="createObject()"><!-- --></A><H3>
createObject</H3>
<PRE>
@@ -453,7 +478,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 +44 -8
jbossweb/minerva/org/jboss/minerva/factories/XAConnectionFactory.html
Index: XAConnectionFactory.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/factories/XAConnectionFactory.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- XAConnectionFactory.html 2000/08/29 23:14:09 1.1
+++ XAConnectionFactory.html 2000/09/01 12:59:22 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:15 EDT 2000 -->
<TITLE>
-Minerva Object/Database Pools: Class XAConnectionFactory
+Minerva Object/Database Pools v0.98: Class XAConnectionFactory
</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>
@@ -75,6 +75,12 @@
and any work done isn't associated with the java.sql.Connection anyway.
<P><B>Note:</B> This implementation requires that the TransactionManager
be bound to a JNDI name.</P>
+ <P><B>Note:</B> This implementation has special handling for Minerva JDBC
+ 1/2 XA Wrappers. Namely, when a request comes in, if it is for a wrapper
+ connection and it has the same current transaction as a previous active
+ connection, the same previous connection will be returned. Otherwise,
+ you won't be able to share changes across connections like you can with
+ the native JDBC 2 Standard Extension implementations.</P>
<P>
<HR>
@@ -127,7 +133,7 @@
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
-<CODE> <A
HREF="http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/XADataSource.html">XADataSource</A></CODE></FONT></TD>
+<CODE> <A
HREF="http://java.sun.com/j2ee/j2sdkee/techdocs/api/javax/sql/XADataSource.html">XADataSource</A></CODE></FONT></TD>
<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/factories/XAConnectionFactory.html#getDataSource()">getDataSource</A></B>()</CODE>
<BR>
@@ -159,6 +165,16 @@
</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/factories/XAConnectionFactory.html#isUniqueRequest()">isUniqueRequest</A></B>()</CODE>
+
+<BR>
+ If a new object is
requested and it is a JDBC 1/2 wrapper connection
+ in the same Transaction as an existing connection, return that same
+ connection.</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/factories/XAConnectionFactory.html#poolStarted(org.jboss.minerva.pools.ObjectPool,
java.io.PrintWriter)">poolStarted</A></B>(<A
HREF="../../../../org/jboss/minerva/pools/ObjectPool.html">ObjectPool</A> pool,
<A
HREF="http://java.sun.com/j2se/1.3/docs/api/java/io/PrintWriter.html">PrintWriter</A> log)</CODE>
@@ -178,7 +194,7 @@
<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/factories/XAConnectionFactory.html#setDataSource(javax.sql.XADataSource)">setDataSource</A></B>(<A
HREF="http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/XADataSource.html">XADataSource</A> dataSource)</CODE>
+<TD><CODE><B><A
HREF="../../../../org/jboss/minerva/factories/XAConnectionFactory.html#setDataSource(javax.sql.XADataSource)">setDataSource</A></B>(<A
HREF="http://java.sun.com/j2ee/j2sdkee/techdocs/api/javax/sql/XADataSource.html">XADataSource</A> dataSource)</CODE>
<BR>
Sets the XADataSource
used to generate XAConnections.</TD>
@@ -298,7 +314,7 @@
<A NAME="setDataSource(javax.sql.XADataSource)"><!-- --></A><H3>
setDataSource</H3>
<PRE>
-public void <B>setDataSource</B>(<A
HREF="http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/XADataSource.html">XADataSource</A> dataSource)</PRE>
+public void <B>setDataSource</B>(<A
HREF="http://java.sun.com/j2ee/j2sdkee/techdocs/api/javax/sql/XADataSource.html">XADataSource</A> dataSource)</PRE>
<DL>
<DD>Sets the XADataSource used to generate XAConnections. This may be
supplied by the vendor, or it may use the wrappers for non-compliant
@@ -311,7 +327,7 @@
<A NAME="getDataSource()"><!-- --></A><H3>
getDataSource</H3>
<PRE>
-public <A
HREF="http://java.sun.com/products/jdbc/jdbc20.stdext.javadoc/javax/sql/XADataSource.html">XADataSource</A>
<B>getDataSource</B>()</PRE>
+public <A
HREF="http://java.sun.com/j2ee/j2sdkee/techdocs/api/javax/sql/XADataSource.html">XADataSource</A>
<B>getDataSource</B>()</PRE>
<DL>
<DD>Gets the XADataSource used to generate XAConnections.</DL>
<HR>
@@ -393,6 +409,26 @@
<DT><B>Overrides:</B><DD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#deleteObject(java.lang.Object)">deleteObject</A></CODE>
in class <CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html">PoolObjectFactory</A></CODE></DL>
</DD>
</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>If a new object is requested and it is a JDBC 1/2 wrapper connection
+ in the same Transaction as an existing connection, return that same
+ connection.<DD><DL>
+<DT><B>Overrides:</B><DD><CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html#isUniqueRequest()">isUniqueRequest</A></CODE>
in class <CODE><A
HREF="../../../../org/jboss/minerva/pools/PoolObjectFactory.html">PoolObjectFactory</A></CODE></DL>
+</DD>
+<DD>Following copied from class:
<CODE>org.jboss.minerva.pools.PoolObjectFactory</CODE></DD>
+<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>
@@ -415,7 +451,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/factories/package-frame.html
Index: package-frame.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/factories/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:09 1.1
+++ package-frame.html 2000/09/01 12:59:22 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.factories
+Minerva Object/Database Pools v0.98: Package org.jboss.minerva.factories
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css"
TITLE="Style">
</HEAD>
1.2 +4 -4
jbossweb/minerva/org/jboss/minerva/factories/package-summary.html
Index: package-summary.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/factories/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:09 1.1
+++ package-summary.html 2000/09/01 12:59:22 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.factories
+Minerva Object/Database Pools v0.98: Package org.jboss.minerva.factories
</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>
@@ -104,7 +104,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/factories/package-tree.html
Index: package-tree.html
===================================================================
RCS file:
/products/cvs/ejboss/jbossweb/minerva/org/jboss/minerva/factories/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:09 1.1
+++ package-tree.html 2000/09/01 12:59:22 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.factories Class Hierarchy
+Minerva Object/Database Pools v0.98: org.jboss.minerva.factories 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>
@@ -83,7 +83,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>
