mcnamara 2005/03/03 13:32:43
Modified: java/xdocs/sources/design design2_0_0.xml
Log:
Patch for XALANJ-1990. Fixes broken link to apidocs for Serializer.html.
Revision Changes Path
1.6 +1 -1 xml-xalan/java/xdocs/sources/design/design2_0_0.xml
Index: design2_0_0.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/design/design2_0_0.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- design2_0_0.xml 10 Jul 2001 00:06:43 -0000 1.5
+++ design2_0_0.xml 3 Mar 2005 21:32:43 -0000 1.6
@@ -225,7 +225,7 @@
<p>The Stree module implements the default <jump
href="http://www.w3.org/TR/xpath#data-model";>Source Tree </jump> for Xalan,
that is to be transformed. It implements read-only <jump
href="http://www.w3.org/TR/DOM-Level-2/";>DOM2</jump> interfaces, and provides
some information needed for fast transforms, such as document order indexes.
It also attempts to allow an incremental transform by launching the transform
on a secondary thread as soon as the SAX2 <jump
href="http://www.megginson.com/SAX/Java/javadoc/org/xml/sax/ContentHandler.html#startDocument()">StartDocument</jump>
event has occurred. When the transform requests a node, and the node is not
present, the getFirstChild and GetNextSibling methods will wait until the child
node has arrived, or an <jump
href="http://www.megginson.com/SAX/Java/javadoc/org/xml/sax/ContentHandler.html#endElement(java.lang.String,%20java.lang.String,%20java.lang.String)">endElement</jump>
event has occurred.</p><p>Note that the secondary thread is an issue. It
would be better to do the same thing as described above on a single thread, but
using the parser in 'pull' mode, or simply with a parseNext method so the parse
would occur in blocks. However, this model would only be possible</p><p>This
kind of incrementality is not perfect because it still requires an entire
source tree to be concretely built. There have been a lot of good discussions
on the xalan-dev list about how to do static analysis of a stylesheet, and be
able to allocate only the nodes needed by the transform, while they are needed
(or not allocate source objects at all).</p></s3>
<anchor name="serializer"/>
<s3 title="Serializer Module">
-<p>XML serialization is a term used for turning a tree or set of events into
a stream, and should not be confused with Java object serialization. The Xalan
serializers implement the <jump
href="http://www.megginson.com/SAX/Java/javadoc/org/xml/sax/ContentHandler.html";>ContentHandler</jump>
to turn parser events coming from the transform, into a stream of XML, HTML,
or plain text. The serializers also implement the <jump
href="../apidocs/org/apache/xalan/serializer/Serializer.html">Serializer</jump>
which allows the transform process to set XSLT output properties and the output
stream or Writer.</p></s3><anchor name="extensions"/>
+<p>XML serialization is a term used for turning a tree or set of events into
a stream, and should not be confused with Java object serialization. The Xalan
serializers implement the <jump
href="http://www.megginson.com/SAX/Java/javadoc/org/xml/sax/ContentHandler.html";>ContentHandler</jump>
to turn parser events coming from the transform, into a stream of XML, HTML,
or plain text. The serializers also implement the <jump
href="../apidocs/org/apache/xml/serializer/Serializer.html">Serializer</jump>
which allows the transform process to set XSLT output properties and the output
stream or Writer.</p></s3><anchor name="extensions"/>
<s3 title="Extensions Module">
<p>This package contains an implementation of Xalan Extension Mechanism,
which uses the <jump
href="http://oss.software.ibm.com/developerworks/opensource/bsf/";>Bean
Scripting Framework</jump>.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
