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 2002/01/25 20:38:50 UTC
cvs commit: xml-xalan/java/xdocs/sources/xalan readme.xml samples.xml
dleslie 02/01/25 11:38:50
Modified: java/xdocs/sources/xalan readme.xml samples.xml
Log:
Removed InstantDB and added info on how to get and use the "Developer license" copy.
Revision Changes Path
1.72 +11 -3 xml-xalan/java/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -r1.71 -r1.72
--- readme.xml 24 Jan 2002 20:46:48 -0000 1.71
+++ readme.xml 25 Jan 2002 19:38:50 -0000 1.72
@@ -77,9 +77,17 @@
</ul>
<anchor name="done"/>
<s3 title="Changes since &xslt4j; 2.2">
- <p>This release does not include support for the deprecated &xslt4j; 1 compatability API.</p>
- <p>This release is integrated with release 2 of &xml4j;.</p>
- <note>The &xslt4j; 1 compatability code does NOT compile with &xml4j2;</note>
+ <p>&xslt4j-current; includes a couple of global adjustments:</p>
+ <ul>
+ <li>This release is integrated with release 2 of &xml4j;.</li>
+ <li>This release does not include support for the deprecated &xslt4j; 1 compatability API. The &xslt4j; 1 compatability code does
+ NOT compile with &xml4j2;.</li>
+ </ul>
+ <p>Our <link idref="samples" anchor="sql">SQL extension samples</link> continue to use InstantDB, but based on our realization of changes
+ that have occurred in the licensing of InstantDB, we no longer include InstantDB and the associated sample database with our distibution.
+ We do, however, provide information on how to <link idref="samples" anchor="instantdbsetup">set up InstantDB</link> to support our SQL
+ extension samples.</p>
+
&done-j;
</s3>
<anchor name="other"/>
1.44 +35 -18 xml-xalan/java/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- samples.xml 22 Jan 2002 17:25:36 -0000 1.43
+++ samples.xml 25 Jan 2002 19:38:50 -0000 1.44
@@ -354,14 +354,30 @@
<br/> <code>-xsl 5-numlistJscript.xsl</code></p>
</s3>
</s2><anchor name="sql"/>
- <s2 title="SQL Library extensions">
- <p>The SQL Library extension samples use <link idref="extensionslib" anchor="sql">SQL library XConnection
- extension</link>to connect to an InstantDB datasource, perform queries, and return query result sets.</p>
- <note>To run these samples, you must include idb.jar on the classpath. We have placed a copy of idb.jar from
- InstantDB version 3.25 in samples/extensions/instantdb. For information about InstantDB, see
- <jump href="http://instantdb.enhydra.org/software/documentation/index.html">InstantDB</jump>
- and the <jump href="http://instantdb.enhydra.org/software/license/index.html">Enydra Public
- License</jump>.</note>
+ <s2 title="SQL library extensions">
+ <p>The <link idref="extensionslib" anchor="sql">SQL library </link> extension enables you to execute SQL queries from within a stylesheet,
+ and to incorporate query result sets in the XML output. To use the SQL library, you need
+ a JDBC driver, the underying DBMS, and a database. Our samples use Lutris® InstantDB, available "free of charge for research and
+ development use."</p><anchor name="instantdbsetup"/>
+ <s3 title="Setting up the InstantDB samples">
+ <p>To run the SQL library extension samples, do the following:</p>
+ <ol>
+ <li>Obtain a copy of InstantDB. You can download a free "Development license" copy for research and development from
+ <jump href="http://www.lutris.com/downloads/index.html">Lutris Downloads</jump>.<br/><br/></li>
+ <li>Follow the instructions Lutris provides for installing InstantDB and generating the sample database.<br/><br/></li>
+ <li>Add idb.jar and the Java Transaction API JAR (jta-spec1_0_1.jar in the InstantDB 4.0 release) to the system class path.<br/><br/></li>
+ <li>Create an instantdb directory in the samples/extensions subdirectory, and copy the sample database to instantdb. The sample database
+ is in the Examples subdirectory where you installed InstantDB. For our purposes, it includes samples.prp and three subdirectories:
+ indexes, system, and tables.<br/><br/>
+ Alternative: You can adjust the references to samples.prp in the XSL stylesheets and XML document dburl nodes to point to sample.prp in
+ its original location, in which case you do not need to copy the samples database. For example, if you have installed InstantDB in /idb,
+ you can change 'jdbc:idb:./instantdb/sample.prp' in the XConnection new() call in extensions/6-sqllib-instantdb to
+ 'jdbc:idb:/idb/Examples/sample.prp'.<br/><br/></li>
+ </ol>
+ <p>For more information about InstantDB, see the <jump href="http://www.lutris.com/products/instantDB/software/documentation/">InstantDB
+ Documentation</jump>.</p>
+ </s3>
+ <s3 title="SQL Library samples with InstantDB">
<ul>
<li><link anchor="ext6">6-sqllib-instantdb</link></li>
<li><link anchor="basic-conn">Basic Connections</link></li>
@@ -373,11 +389,11 @@
<note>Except for 6-sqllib-instantdb, all these samples have been created by John Gentilin
(johnglinux@eyecatching.com) to take illustrate the rich feature set he has contributed to the SQL Library.
To run each of these samples, be sure you are in the appropriate extensions/sql subdirectory.</note>
- <anchor name="ext6"/>
+ </s3><anchor name="ext6"/>
<s3 title="6-sqllib-instantdb">
<p>What it does: Uses the SQL library XConnection extension to connect to the InstantDB sample database,
performs a query, and returns the query result in an HTML table.</p>
- <p>Add idb.jar to the classpath, and run this sample from the extensions subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this sample from the extensions subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/> <code>-xsl 6-sqllib-instantdb.xsl -out import1.html</code></p>
</s3><anchor name="basic-conn"/>
@@ -389,7 +405,7 @@
in the form of stylesheet parameters.</p>
<p>The second strategy is to get connection information from a nodeset in an XML source document (dbInfo.xml).</p>
- <p>Add extensions/instantdb/idb.jar to the classpath, and run this sample from the extensions/sql/basic-connection
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this sample from the extensions/sql/basic-connection
directory.</p>
<p>1. To get connection information from the stylesheet:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
@@ -407,11 +423,12 @@
<p>What it does: The ExternalConnection classes uses the default implementation of the ConnectionPool interface
to create a pool of connections. A stylesheet in turn uses a connection from this pool to instantiate an
XConnection object and connect to a datasouce.</p>
- <p>The stylesheet uses this named connection pool to instantiate an XConnection object and connect to the datasource.</p>
- <p>The ExternalConnection class is in xalansamples.jar. Be sure xalansamples.jar and idb.jar are on the classpath, and
- run this sample from the extensions/sql/ext-connection directory:</p>
+ <p>The stylesheet uses this named connection pool to instantiate an XConnection object and connect to the datasource.
+ The ExternalConnection class is in xalansamples.jar.</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, be sure xalanxamples.jar is on the class path, and run this
+ sample from the extensions/sql/ext-connection directory:</p>
<p><code>java ExternalConnection</code></p>
- <p>ExternalConnection creates the ConnectionPool, and performs a transformation wiht dbtest.xsl, which draws
+ <p>ExternalConnection creates the ConnectionPool, and performs a transformation with dbtest.xsl, which draws
from the pool to instantiate an XConnection object, connect to the datasource, execute a static query, and return the
query result.</p>
</s3><anchor name="pquery"/>
@@ -421,7 +438,7 @@
provides the parameter value as well as the connection information. The parameter value is in a node in the XML source.</p>
<p>The stylesheet gets the required connection and parameter information from the XML source, sets up and executes the
parameterized query, and retuns the query result set.</p>
- <p>Be sure idb.jar is on the classpath, and run this sample from the sql/pquery subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this sample from the sql/pquery subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process -in dbInfo.xml</code>
<br/><code>-xsl dbTest.xsl -out dbTest.html</code></p>
</s3><anchor name="streamable"/>
@@ -429,7 +446,7 @@
<p><em>Contributed by John Gentilin (johnglinux@eyecatching.com).</em></p>
<p>What it does: Illustrates enabling and disabling of caching the streamable result set returned by a query.</p>
<p>The stylesheets use the XConnection enableCacheNodes() and disableCacheNodes() methods.</p>
- <p>Be sure idb.jar is on the classpath, and run these samples from the sql/streamable subdirectory.</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run these samples from the sql/streamable subdirectory.</p>
<p>1. To turn caching on:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code>-xsl cachedNodes.xsl</code></p>
@@ -445,7 +462,7 @@
<source><xsl:variable name="table" select='sql:query($db, $query)'/>
<xsl:apply-templates select="$table/row-set" />
<xsl:apply-templates select="$table/ext-error"/></source>
- <p>With idb.jar on the classpath, run this sample from the extensions/sql/show-error subdirectory:</p>
+ <p><link anchor="instantdbsetup">Set up InstantDB</link>, and run this sample from the extensions/sql/show-error subdirectory:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code> -xsl <ref>invalidSomething.xsl</ref> -out dbtestout.html</code></p>
<p>where <ref>invalidSomething.xsl</ref> is <code>invalidConn.xsl</code> (specifies a database that does not exist),
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org