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/02/21 15:05:42 UTC
cvs commit: xml-xalan/java/src/org/apache/xalan/lib/sql Column.java ColumnAttribute.java ColumnData.java ColumnHeader.java Row.java RowSet.java StreamableNode.java XConnection.java XStatement.java package.html
dleslie 01/02/21 06:05:42
Modified: java/src/org/apache/xalan/lib/sql Column.java
ColumnAttribute.java ColumnData.java
ColumnHeader.java Row.java RowSet.java
StreamableNode.java XConnection.java
XStatement.java package.html
Log:
Added experimental usage metatag to all classes in this package,
and an explanatory note to package.html.
Revision Changes Path
1.5 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/Column.java
Index: Column.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/Column.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- Column.java 2000/12/14 19:06:05 1.4
+++ Column.java 2001/02/21 14:05:41 1.5
@@ -65,6 +65,7 @@
import java.sql.ResultSetMetaData;
/**
+ * <meta name="usage" content="experimental"/>
* Represents a col node from a row node.
*/
public class Column extends StreamableNode
1.8 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnAttribute.java
Index: ColumnAttribute.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnAttribute.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- ColumnAttribute.java 2001/01/04 17:10:38 1.7
+++ ColumnAttribute.java 2001/02/21 14:05:41 1.8
@@ -70,6 +70,7 @@
import org.apache.xalan.res.XSLTErrorResources;
/**
+ * <meta name="usage" content="experimental"/>
* Represents a column attribute on a column-header element.
* Each column-header element can contain any of the following
* attributes, depending on the ResultSetMetadata object returned with
1.6 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnData.java
Index: ColumnData.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnData.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ColumnData.java 2001/02/14 03:13:14 1.5
+++ ColumnData.java 2001/02/21 14:05:41 1.6
@@ -68,6 +68,7 @@
import org.apache.xalan.res.XSLTErrorResources;
/**
+ * <meta name="usage" content="experimental"/>
* Represents the col element text node, i.e., the column value.
*/
public class ColumnData extends StreamableNode implements Text
1.6 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnHeader.java
Index: ColumnHeader.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/ColumnHeader.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ColumnHeader.java 2001/02/20 03:06:57 1.5
+++ ColumnHeader.java 2001/02/21 14:05:41 1.6
@@ -67,6 +67,7 @@
import org.apache.xalan.res.XSLTErrorResources;
/**
+ * <meta name="usage" content="experimental"/>
* This class represents a column-header Node, which contains the metadata
* for a column.
*/
1.8 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/Row.java
Index: Row.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/Row.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Row.java 2000/12/18 00:10:12 1.7
+++ Row.java 2001/02/21 14:05:41 1.8
@@ -68,6 +68,7 @@
import java.sql.ResultSet;
/**
+ * <meta name="usage" content="experimental"/>
* This class represents a row from a query result set. It is used
* over and over, and so is certainly not fully DOM complient,
* and will result in strange results in the stylesheet if the
1.6 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/RowSet.java
Index: RowSet.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/RowSet.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- RowSet.java 2001/02/20 03:06:58 1.5
+++ RowSet.java 2001/02/21 14:05:41 1.6
@@ -65,6 +65,7 @@
import java.sql.ResultSetMetaData;
/**
+ * <meta name="usage" content="experimental"/>
* This class represents the row-set StreamableNode, a "streamable" holder
* for the JDBC query result set.
*/
1.10 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/StreamableNode.java
Index: StreamableNode.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/StreamableNode.java,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- StreamableNode.java 2000/12/14 19:06:07 1.9
+++ StreamableNode.java 2001/02/21 14:05:41 1.10
@@ -69,6 +69,7 @@
import org.apache.xpath.axes.AxesWalker;
/**
+ * <meta name="usage" content="experimental"/>
* This is the superclass for all nodes in the org.apache.xalan.lib.sql package.
*/
public class StreamableNode extends UnImplNode
1.8 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/XConnection.java
Index: XConnection.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/XConnection.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- XConnection.java 2001/01/04 17:10:44 1.7
+++ XConnection.java 2001/02/21 14:05:41 1.8
@@ -70,6 +70,7 @@
import org.w3c.dom.traversal.NodeIterator;
/**
+ * <meta name="usage" content="experimental"/>
* An XSLT extension that allows a stylesheet to
* access JDBC data. From the stylesheet perspective,
* XConnection provides 3 extension functions: new(),
1.10 +1 -0 xml-xalan/java/src/org/apache/xalan/lib/sql/XStatement.java
Index: XStatement.java
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/XStatement.java,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- XStatement.java 2001/02/20 03:06:58 1.9
+++ XStatement.java 2001/02/21 14:05:41 1.10
@@ -70,6 +70,7 @@
import org.apache.xalan.res.XSLTErrorResources;
/**
+ * <meta name="usage" content="experimental"/>
* Represents a JDBC query statement. Also acts as both a
* NodeIterator and the Document node for the row-set representation
* of the query result set.
1.5 +5 -2 xml-xalan/java/src/org/apache/xalan/lib/sql/package.html
Index: package.html
===================================================================
RCS file: /home/cvs/xml-xalan/java/src/org/apache/xalan/lib/sql/package.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- package.html 2001/01/04 17:10:48 1.4
+++ package.html 2001/02/21 14:05:41 1.5
@@ -1,8 +1,11 @@
<html>
- <title>Xalan SQL Extension.</title>
+ <title>Xalan SQL Extension</title>
<body>
- <p>Provides extension functions for connecting to a JDBC data source, executing a query,
+ <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>
+ <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>XConnection provides three extension functions that you can use in your stylesheet.</p>
<ol>
<li><p>new() -- Use one of the XConnection constructors to connect to a data source, and return an XConnection