db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r793607 - in /db/derby/docs/trunk/src: devguide/ ref/
Date Mon, 13 Jul 2009 15:17:10 GMT
Author: chaase3
Date: Mon Jul 13 15:17:08 2009
New Revision: 793607

URL: http://svn.apache.org/viewvc?rev=793607&view=rev
Log:
DERBY-1923: XML operators - Xalan requirement

Corrected information in dev guide and ref manual topics.

Patch: DERBY-1923.diff

Modified:
    db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita
    db/derby/docs/trunk/src/ref/rreffuncxmlexists.dita
    db/derby/docs/trunk/src/ref/rreffuncxmlparse.dita
    db/derby/docs/trunk/src/ref/rreffuncxmlquery.dita
    db/derby/docs/trunk/src/ref/rreffuncxmlserialize.dita
    db/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita
    db/derby/docs/trunk/src/ref/rreflimitsxml.dita
    db/derby/docs/trunk/src/ref/rrefsqljtypexml.dita

Modified: db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevstandardsxml.dita Mon Jul 13 15:17:08 2009
@@ -48,22 +48,25 @@
 the Java classpath. If either the parser or Xalan are missing from the classpath, <ph
 conref="../conrefs.dita#prod/productshortname"></ph> disallows any XML-related
 operations.  </p>
-<p>To see a list of the versions of the JAXP implementation and of Apache
-Xalan that have been tested with <ph conref="../conrefs.dita#prod/productshortname"></ph>
XML
-support, see to the <ph conref="../conrefs.dita#prod/productshortname"></ph>
release
-notes. The release notes are available from the Apache Derby Downloads page.</p>
-<note>Most Java virtual machines (JVMs) that are version 1.4 or later have
+<section><title>Classpath and version issues</title>
+<p>Most Java virtual machines (JVMs) that are version 1.4 or later have
 a JAXP parser embedded in the JVM. If you are using one of these JVMs, you
-do not need to add any other JAXP classes to your classpath. Additionally,
-if the JVM that you are using includes an embedded version of Xalan, you should
-confirm that the version of Xalan satisfies the minimum requirements for <ph
-conref="../conrefs.dita#prod/productshortname"></ph>. For example, if your
-JVM is Sun JDK 1.4.2, you must override the version of Xalan in the JVM with
-a newer version. Use Java's Endorsed Standards Override Mechanisms described
-at http://java.sun.com/j2se/1.4.2/docs/guide/standards/ to override the version
-of Xalan. <p>If the JVM that you are using does not have a JAXP parser or
-a version of Xalan, you can add external versions of those classes in your
-classpath and <ph conref="../conrefs.dita#prod/productshortname"></ph> will
-pick up those classes.</p></note>
+may not need to add any classes to your classpath. Some exceptions exist:</p>
+<ul>
+<li>In most version 1.4.2 JVMs, the version of Xalan that comes with the JVM is 
+not new enough, so you must override the version of Xalan in the JVM with a
+newer version by using the Endorsed Standards Override Mechanism described at
+<xref format="html" href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/"
+scope="external">http://java.sun.com/j2se/1.4.2/docs/guide/standards/</xref>. To
+use this mechanism, download and install a binary distribution of Xalan from
+Apache and set the system property <codeph>java.endorsed.dirs</codeph> to point
+to the Xalan installation directory.</li>
+<li>In Sun JVMs later than version 1.4, Sun has renamed the JAXP packages so that
+<ph conref="../conrefs.dita#prod/productshortname"></ph> cannot access them.
If
+you are using a Sun JVM later than version 1.4, download and install a binary
+distribution of Xalan from Apache and place the <codeph>xalan.jar</codeph> file
+in your classpath.</li>
+</ul>
+</section>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/ref/rreffuncxmlexists.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rreffuncxmlexists.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rreffuncxmlexists.dita (original)
+++ db/derby/docs/trunk/src/ref/rreffuncxmlexists.dita Mon Jul 13 15:17:08 2009
@@ -100,9 +100,11 @@
 To create the table, use this statement:<codeblock>CREATE TABLE <varname>x_table</varname>
( id INT, <varname>xcol</varname> XML CHECK (XMLEXISTS ('<varname
 >//student[@age &lt; 25]</varname>' PASSING BY REF <varname>xcol</varname>))
)</codeblock></p></section>
 <section><title>Usage note</title><p><ph conref="../conrefs.dita#prod/productshortname"></ph>
requires
-that a JAXP parser, such as Apache Xerces, and that Apache Xalan are listed
+that a JAXP parser (such as Apache Xerces) and Apache Xalan are listed
 in the Java classpath for the XML functions to work.  If either the JAXP parser
 or Xalan is missing from the classpath, attempts to use the XMLEXISTS operator
-will result in an error.</p></section>
+will result in an error. In some situations, you may need to take steps to place
+the parser and Xalan in your classpath. See "XML data types and operators" in
+the <ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</p></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rreffuncxmlparse.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rreffuncxmlparse.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rreffuncxmlparse.dita (original)
+++ db/derby/docs/trunk/src/ref/rreffuncxmlparse.dita Mon Jul 13 15:17:08 2009
@@ -87,9 +87,11 @@
 </codeblock>You should bind into the statement using the setCharacterStream()
 method, or any other JDBC setXXX method that works for the CAST target type.</p></section>
 <section><title>Usage note</title><p><ph conref="../conrefs.dita#prod/productshortname"></ph>
requires
-that a JAXP parser, such as Apache Xerces, and that Apache Xalan are listed
+that a JAXP parser (such as Apache Xerces) and Apache Xalan are listed
 in the Java classpath for the XML functions to work.  If either the JAXP parser
 or Xalan is missing from the classpath, attempts to use the XMLPARSE operator
-will result in an error.</p></section>
+will result in an error. In some situations, you may need to take steps to place
+the parser and Xalan in your classpath. See "XML data types and operators" in
+the <ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</p></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rreffuncxmlquery.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rreffuncxmlquery.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rreffuncxmlquery.dita (original)
+++ db/derby/docs/trunk/src/ref/rreffuncxmlquery.dita Mon Jul 13 15:17:08 2009
@@ -110,9 +110,11 @@
 </codeblock> The result set for this query contains a row for only the rows
 in <codeph>x_table</codeph> that have a student whose name is BC.</p></section>
 <section><title>Usage note</title><p><ph conref="../conrefs.dita#prod/productshortname"></ph>
requires
-that a JAXP parser, such as Apache Xerces, and that Apache Xalan are listed
+that a JAXP parser (such as Apache Xerces) and Apache Xalan are listed
 in the Java classpath for the XML functions to work.  If either the JAXP parser
 or Xalan is missing from the classpath,  attempts to use the XMLQUERY operator
-will result in an error.</p></section>
+will result in an error. In some situations, you may need to take steps to place
+the parser and Xalan in your classpath. See "XML data types and operators" in
+the <ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</p></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rreffuncxmlserialize.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rreffuncxmlserialize.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rreffuncxmlserialize.dita (original)
+++ db/derby/docs/trunk/src/ref/rreffuncxmlserialize.dita Mon Jul 13 15:17:08 2009
@@ -78,9 +78,11 @@
     AS VARCHAR(50))
 FROM <varname>x_table</varname></codeblock></p></section>
 <section><title>Usage note</title><p><ph conref="../conrefs.dita#prod/productshortname"></ph>
requires
-that a JAXP parser, such as Apache Xerces, and that Apache Xalan are listed
+that a JAXP parser (such as Apache Xerces) and Apache Xalan are listed
 in the Java classpath for the XML functions to work.  If either the JAXP parser
 or Xalan is missing from the classpath, attempts to use the XMLSERIALIZE operator
-will result in an error</p></section>
+will result in an error. In some situations, you may need to take steps to place
+the parser and Xalan in your classpath. See "XML data types and operators" in
+the <ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</p></section>
 </refbody>
 </reference>

Modified: db/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefjdbcjsr169.dita Mon Jul 13 15:17:08 2009
@@ -47,7 +47,10 @@
 query, or otherwise access an XML data value if it has classes for a JAXP parser
 and for Xalan in the classpath.
 <ph conref="../conrefs.dita#prod/productshortname"></ph> issues an error if
-either the parser or Xalan is not found)</li>
+either the parser or Xalan is not found. In some situations, you may need to
+take steps to place the parser and Xalan in your classpath. See
+"XML data types and operators" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</li>
 </ul>
 <p>JSR 169 and its <ph conref="../conrefs.dita#prod/productshortname"></ph>
 implementation do not support the following:</p>

Modified: db/derby/docs/trunk/src/ref/rreflimitsxml.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rreflimitsxml.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rreflimitsxml.dita (original)
+++ db/derby/docs/trunk/src/ref/rreflimitsxml.dita Mon Jul 13 15:17:08 2009
@@ -43,9 +43,12 @@
 </row>
 <row>
 <entry colname="colspec0">Use of XML operators</entry>
-<entry colname="colspec1">Requires that the JAXP parser classes, such as Apache
-Xerces, and Apache Xalan classes are in the classpath.  Attempts to use XML
-operators without these classes in the classpath results in an error.</entry>
+<entry colname="colspec1">Requires that the JAXP parser classes (such as Apache
+Xerces) and the Apache Xalan classes are in the classpath.  Attempts to use
+XML operators without these classes in the classpath result in an error. In
+some situations, you may need to take steps to place the parser and Xalan in
+your classpath. See "XML data types and operators" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</entry>
 </row>
 </tbody>
 </tgroup>

Modified: db/derby/docs/trunk/src/ref/rrefsqljtypexml.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefsqljtypexml.dita?rev=793607&r1=793606&r2=793607&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefsqljtypexml.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefsqljtypexml.dita Mon Jul 13 15:17:08 2009
@@ -34,13 +34,17 @@
 </ul></p><note>For an application to retrieve, update, query, or otherwise
 access an XML data value, the application must have classes for a JAXP parser
 and for Xalan in the classpath.  <ph conref="../conrefs.dita#prod/productshortname"></ph>
issues
-an error if either the parser or Xalan is not found.<p>Because none of the
+an error if either the parser or Xalan is not found. In some situations, you may
+need to take steps to place the parser and Xalan in your classpath. See
+"XML data types and operators" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph> for details.</note>
+<p>Because none of the
 JDBC-side support for SQL/XML is implemented in <ph conref="../conrefs.dita#prod/productshortname"></ph>,
 it is not possible to bind directly into an XML value or to retrieve an XML
 value directly from a result set using JDBC.  Instead, you must bind and retrieve
 the XML data as Java strings or character streams by explicitly specifying
 the appropriate XML operators, XMLPARSE and XMLSERIALIZE, as part of your
-SQL queries.</p></note></section>
+SQL queries.</p></section>
 <refsyn><title>Syntax</title><codeblock><b>XML</b></codeblock>
</refsyn>
 <section><title>Corresponding compile-time Java type</title><p>None</p><p>The
 Java type for XML values is java.sql.SQLXML. However, the java.sql.SQLXML



Mime
View raw message