dleslie 00/09/06 14:23:08
Modified: java/src/org/apache/xalan/transformer package.html
Log:
Editorial updates.
Revision Changes Path
1.2 +18 -8
xml-xalan/java/src/org/apache/xalan/transformer/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/xml-xalan/java/src/org/apache/xalan/transformer/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 2000/07/06 02:28:14 1.1
+++ package.html 2000/09/06 21:23:05 1.2
@@ -1,15 +1,25 @@
<html>
- <title>Xalan Transformation Package.</title>
+ <title>Xalan Transformer Package.</title>
<body>
- <p>Implementation of run-time transformation support of source trees to
- result trees -- the TransformerImpl class implements the TRaX
Transformer
- interface, and extends the SAX XMLFilterImpl class --
- heavy dependence of the "templates" package -- also see the
ResultTreeHandler,
- where result tree events are bottle-necked for output to the SAX
ContentHandler.<p>
+ <p>In charge of run-time transformations and the production of result
trees.</p>
+ <p>TransformerImpl implements the TRaX Transformer interface, and
extends the SAX XMLFilterImpl. It uses a SAX XMLParser to
+ parse the XML input and sends parse events to an input SAX
ContentHandler, org.apache.xalan.stree.SourceTreeHandler, which in
+ turn uses org.apache.xalan.utils.DOMBuilder to assemble the input into a
DOM tree (this step is unnecessary if the XML input
+ is submitted as a DOM).</p>
+ <p>For each node in the XML source, TransformerImpl uses the
StylesheetRoot and underlying XSLT schema to determine which
+ template to apply: one of the templates in the StylesheetRoot, a default
template rule as specified in the XSLT spec, or
+ none.</p>
+ <p>The Transformer works with
org.apache.xalan.transformer.ResultTreeHandler to forward the SAX events
produced by this
+ process to the appropriate output ContentHandler, a serializer if the
Result object has been set up to write to a stream or
+ file, a DOMBuilder utility if the output is to be a DOM tree.</p>
+ <p>To the degree possible, the parsing of the XML source and application
of the Templates object to that source are performed
+ concurrently in separate threads. When necessary, the Transformer waits
for the parse events that must be in place before a
+ given template may be applied.</p>
<dl>
- <dt><b>Version: </b></dt><dd>Alpha, 2.0.0, July 05, 2000</dd>
+ <dt><b>Version: </b></dt><dd>xalan-j_2_0_D01, September 6, 2000</dd>
<dt><b>Author: </b></dt><dd><a href="mailto:[EMAIL PROTECTED]">Scott
Boag</a></dd>
- </dl>
</body>
+ </dl>
+ </body>
</html>
