You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@apache.org on 2001/05/16 20:30:10 UTC
cvs commit: xml-xalan/java/xdocs/sources/xalan extensionslib.xml
dleslie 01/05/16 11:30:09
Modified: java/xdocs/sources/xalan extensionslib.xml
Log:
Attempted to clarify situation with respect to streaming vs. caching.
Revision Changes Path
1.13 +6 -8 xml-xalan/java/xdocs/sources/xalan/extensionslib.xml
Index: extensionslib.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/extensionslib.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- extensionslib.xml 2001/05/02 21:38:07 1.12
+++ extensionslib.xml 2001/05/16 18:30:04 1.13
@@ -220,13 +220,12 @@
<li><link idref="samples" anchor="sql">SQL library sample applications</link></li>
</ul>
<p><em>**Experimental**</em> Provides extension functions for connecting to a JDBC data source, executing a query,
-and working incrementally through "streamable" result set.</p>
-<note>Many features of the SQL library, including support for connection pools, parameterized queries, caching streamable
-result sets, and added support for extracting connection information and query parameters from XML source documents exist
+and optionally working incrementally through a "streamable" result set. <ref>Due to a bug, caching, not streaming, is currently
+the default mode of operation.</ref> </p>
+<note>Many features of the SQL library, including support for connection pools, parameterized queries, caching,
+and added support for extracting connection information and query parameters from XML source documents exist
thanks to John Gentilin (johnglinux@eyecatching.com), who has also added a number of SQL library samples.</note>
-<p><em>The SQL extension use of a single row-set node to incrementally return a query result set is experimental. Keep in mind that you
-can only access row elements one at a time moving forward through the result set. The use of XPath expressions in your stylesheet, for
-example, that attempt to return nodes from the result set in any other manner may produce unpredictable results.</em></p>
+<p><em>The SQL extension use in streaming mode of a single row-set node to incrementally return a query result set is experimental. If you use streaming mode, you can only access row elements one at a time moving forward through the result set. The use of XPath expressions in your stylesheet, for example, that attempt to return nodes from the result set in any other manner may produce unpredictable results.</em></p>
<p><jump href="apidocs/org/apache/xalan/lib/sql/XConnection.html">org.apache.xalan.lib.sql.XConnection</jump> provides a number
of extension functions that you can use in your stylesheet.</p>
<ol>
@@ -239,8 +238,7 @@
begin "transforming" the row-set before the entire result set has been returned.<br/><br/></li>
<li>pquery(), addParameter(), addParameterFromElement(), clearParameters() -- Use the XConnection pquery() method in
conjunction with these other methods to set up and execute parameterized queries.<br/><br/></li>
- <li>enableCacheNodes(), disableCacheNodes() -- Use these XConnection methods to manage the caching of the streamable
- nodes returned by queries.<br/><br/></li>
+ <li>Use disableCacheNodes() to use streaming node, and enableCacheNodes() to cache the query result set. <br/><br/></li>
<li>close() -- Use the XConnection object close() method to terminate the connection.</li>
</ol>
<p>The query() and pquery() extension functions return a Document node that contains (as needed) an array of column-header elements,
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org