dleslie 02/01/30 14:23:13
Modified: java/xdocs/sources xalan-jlocal.xml xalan-jsite.xml
java/xdocs/sources/xalan commandline.xml extensionslib.xml
faq.xml features.xml usagepatterns.xml
Log:
Updates for 2.3
Revision Changes Path
1.21 +1 -1 xml-xalan/java/xdocs/sources/xalan-jlocal.xml
Index: xalan-jlocal.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jlocal.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- xalan-jlocal.xml 30 Jan 2002 14:23:52 -0000 1.20
+++ xalan-jlocal.xml 30 Jan 2002 22:23:12 -0000 1.21
@@ -73,7 +73,7 @@
<document id="commandline" label="Command Line"
source="xalan/commandline.xml"/>
<separator/>
<document id="usagepatterns" label="Usage Patterns"
source="xalan/usagepatterns.xml"/>
- <hidden id="features" source="xalan/features.xml"/>
+ <document id="features" label="Features" source="xalan/features.xml"/>
<separator/>
<document id="trax" label="TrAX" source="xalan/trax.xml"/>
<external href="apidocs/index.html" label="API (Javadoc)"/>
1.39 +1 -1 xml-xalan/java/xdocs/sources/xalan-jsite.xml
Index: xalan-jsite.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jsite.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- xalan-jsite.xml 30 Jan 2002 14:23:52 -0000 1.38
+++ xalan-jsite.xml 30 Jan 2002 22:23:12 -0000 1.39
@@ -76,7 +76,7 @@
<document id="commandline" label="Command Line"
source="xalan/commandline.xml"/>
<separator/>
<document id="usagepatterns" label="Usage Patterns"
source="xalan/usagepatterns.xml"/>
- <hidden id="features" source="xalan/features.xml"/>
+ <document id="features" label="Features" source="xalan/features.xml"/>
<separator/>
<document id="trax" label="TrAX" source="xalan/trax.xml"/>
<external href="apidocs/index.html" label="API (Javadoc)"/>
1.19 +4 -3 xml-xalan/java/xdocs/sources/xalan/commandline.xml
Index: commandline.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/commandline.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- commandline.xml 30 Jan 2002 14:23:52 -0000 1.18
+++ commandline.xml 30 Jan 2002 22:23:12 -0000 1.19
@@ -85,7 +85,6 @@
-V (Version info)
-QC (Quiet Pattern Conflicts Warnings)
--L (Report line numbers for problems with source document)
-TT (Trace the templates as they are being called)
-TG (Trace each result tree generation event)
-TS (Trace each selection event)
@@ -107,8 +106,7 @@
false)
-RL recursionLimit (Set numeric limit on depht of stylesheet
recursion)
--L (Obtain a SourceLocator that can be used within stylesheet to
- report location of nodes within the XML source document)
+-L (Turn on source-location attribute)
</source>
<p>Use <code>-IN</code> to specify the XML source document.</p>
<p>Use <code>-XSL</code> to specify the XSL stylesheet file.</p>
@@ -120,6 +118,9 @@
<code>java org.apache.xalan.xslt.Process -PARAM <ref>name
value</ref></code></p>
<p>The value is passed to the transformer as a String.</p>
<p>For information about incremental and optimized stylesheet
processing, see <link idref="dtm" anchor="settings">DTM settings</link>.</p>
+ <p>Use <code>-L</code> to obtain access to a SourceLocator that a
stylesheet extension can use to get information about the location
+ of nodes in the source document. For more information, see <link
idref="extensionslib" anchor="nodeinfo">NodeInfo extension functions</link>
+ and <link idref="features"
anchor="source-location">source-location</link>.</p>
<p>Use <code>-URIRESOLVER</code> with a fully qualified class name to
utilize a custom implementation of the
<jump
href="apidocs/javax/xml/transform/URIResolver.html">URIResolver</jump> TrAX
interface to resolve URIs for
xsl:include, xsl:import, and the document() function.</p>
1.21 +24 -13 xml-xalan/java/xdocs/sources/xalan/extensionslib.xml
Index: extensionslib.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/extensionslib.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- extensionslib.xml 30 Jan 2002 14:23:52 -0000 1.20
+++ extensionslib.xml 30 Jan 2002 22:23:12 -0000 1.21
@@ -66,10 +66,7 @@
<li><link anchor="difference">difference</link></li>
<li><link anchor="distinct">distinct</link></li>
<li><link anchor="hassamenodes">hasSameNodes</link></li>
-<li><link anchor="systemid">systemId</link></li>
-<li><link anchor="publicid">publicId</link></li>
-<li><link anchor="linenumber">lineNumber</link></li>
-<li><link anchor="columnnumber">columnNumber</link></li>
+<li><link anchor="nodeinfo">NodeInfo extension functions</link></li>
<li><link anchor="sql">SQL library</link></li>
<li><link anchor="pipedocument">PipeDocument</link></li>
<li><link anchor="evaluate">evaluate</link></li>
@@ -217,27 +214,41 @@
<s2 title= "hasSameNodes">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/Extensions.html">org.apache.xalan.lib.Extensions</jump>,<br/>
<code>hasSameNodes(node-set1, node-set2)</code> returns true if both
node-set1 and node-set2 contain exactly the same set of nodes.</p>
-</s2><anchor name="systemid"/><anchor name="nodeinfo"/>
-<s2 title="systemId">
+</s2><anchor name="nodeinfo"/>
+<s2 title="NodeInfo">
+<p><jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>
provides extension elements that you can
+use to get information about the location of nodes in the source
document:</p>
+<ul>
+<li><link anchor="systemid">systemId</link></li>
+<li><link anchor="publicid">publicId</link></li>
+<li><link anchor="linenumber">lineNumber</link></li>
+<li><link anchor="columnnumber">columnNumber</link></li>
+</ul>
+<note>If you want to use the NodeInfo extension elements, you MUST set the
TransformerFactory
+<link idref="features" anchor="source-location">source-location</link>
attribute to Boolean.TRUE.
+You can use the <link idref="commandline">command-line utility</link> -L
flag or the <jump
href="apidocs/javax/xml/transform/TransformerFactory.html#setAttribute(java.lang.String,
java.lang.Object)">TransformerFactory.setAttribute()</jump>
+method to set this attribute.</note>
+<anchor name="systemid"/>
+<s3 title="systemId">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>systemId()</code> returns the system ID for the current node, and <br/>
<code>systemId(node-set)</code> returns the system ID of the first node in
the node-set.</p>
-</s2><anchor name="publicid"/>
-<s2 title="publicId">
+</s3><anchor name="publicid"/>
+<s3 title="publicId">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>publicId()</code> returns the public ID for the current node, and<br/>
<code>publicId(node-set)</code> returns the public ID of the first node in
the node-set.</p>
-</s2><anchor name="linenumber"/>
-<s2 title="lineNumber">
+</s3><anchor name="linenumber"/>
+<s3 title="lineNumber">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>lineNumber()</code> returns the line number in the source document for
the current node, and<br/>
<code>lineNumber(node-set)</code> returns the line number in the source
document for the first node in the node-set.</p>
-</s2><anchor name="columnnumber"/>
-<s2 title="columnNumber">
+</s3><anchor name="columnnumber"/>
+<s3 title="columnNumber">
<p>Implemented in <jump
href="apidocs/org/apache/xalan/lib/NodeInfo.html">org.apache.xalan.lib.NodeInfo</jump>,<br/>
<code>columnNumber()</code> returns the column number in the source document
for the current node, and<br/>
<code>columnNumber(node-set)</code> returns the column number in the source
document for the first node in the node-set.</p>
-</s2><anchor name="sql"/>
+</s3></s2><anchor name="sql"/>
<s2 title= "SQL library">
<note>For UML Diagrams of the SQL Library, see <jump
href="http://xml.apache.org/xalan-j/Xalan-SQL-Extension/DiagramIndex.html";>SQL
Library UML Diagrams</jump>.</note>
<ul>
1.19 +27 -1 xml-xalan/java/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- faq.xml 30 Jan 2002 16:04:13 -0000 1.18
+++ faq.xml 30 Jan 2002 22:23:12 -0000 1.19
@@ -298,4 +298,30 @@
<p>Note too that on some platforms 1MB is an architectural upper limit on
the stack size, so setting -Xss2m (or equivalent) may not allow deeper recusion
than -Xss1m.</p>
</a>
</faq>
-</faqs>
+<faq title="OutOfMemoryError processing multiple documents">
+<q>I get a java.lang.OutOfMemoryError when I try to process multiple
documents with the document() function. What can I do?</q>
+<a>
+<p>As a general rule, &xslt4j; currently caches all of the documents that
you read in with the document() function during a transformation.</p>
+<p>If your objective is to transform a series of documents, you can break
the process into a series of transformations.
+The <link idref="extensionslib" anchor="pipedocument">PipeDocument</link>
extension element provides one strategy for batching a
+series of parallel transformations.</p>
+<p>Another alternative is to place your document() call in the select
attribute of an xsl:for-each instruction element
+and use a custom PI (Processing Instruction) to turn off document caching.
Include an XPath expression in your document() call if you do not
+need to process the entire document.</p>
+<p>Sample stylesheet fragment:</p>
+<source>
+<xsl:template match="doc">
+ <xsl:for-each select="document(@href)/bar/zulu">
+ <?xalan:doc-cache-off?>
+ <!-- process each document -->
+ <xsl:for-each>
+</xsl:template></source>
+<note>PIs do not ordinarily uses namespaces, so "xalan:" is a 'fake'
namespace we have included to indicate that this is not a standard PI.</note>
+<p>If you include an XPath expression in your document() call, you can also
turn on <link idref="dtm" anchor="incremental">incremental transform</link>
+to eliminate the need to read in the entire document. In fact, you can take
advantage of the incremental transform feature even if you are not turning
+off document caching.</p>
+<p>You can also increase your jvm heap size with the -Xmx or -mx flag,
depending on which JVM you are using (you can include both flags, and the JVM
will ignore the one it doesn't understand). For example, to give your JVM 64
meg, try <br/>
+<code> java -Xmx64m -mx64m <ref>Class</ref></code></p>
+</a>
+</faq>
+</faqs>
\ No newline at end of file
1.2 +43 -43 xml-xalan/java/xdocs/sources/xalan/features.xml
Index: features.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/features.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- features.xml 30 Jan 2002 14:23:52 -0000 1.1
+++ features.xml 30 Jan 2002 22:23:12 -0000 1.2
@@ -1,32 +1,31 @@
<?xml version="1.0" standalone="no"?>
<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
<s1 title="Transform Features">
-<p>Transform features include standard JAXP 1.1 behaviors that your
implementation may support (&xslt4j; supports all such behaviors), general
session-level &xslt4j;-defined behaviors that you can set, and &xslt4j;-defined
behaviors that you can set for an individual transformation. Transform features
are identified by URI Strings and fall into the following categories:</p>
+<p>Transform features are identified by URI Strings and fall into the
following categories:</p>
<ul>
<li><link anchor="factoryfeature">Standard TransformationFactory
features</link></li>
-<li><link anchor="factoryattribute">&xslt4j; TransformerFactory
attributes</link></li>
-<li><link anchor="transformerproperty">&xslt4j; Transformer
properties</link></li>
+<li><link anchor="factoryattribute">Implementation-specific
TransformerFactory attributes</link></li>
</ul>
<anchor name="factoryfeature"/>
<s2 title="Standard TransformerFactory features">
<p>The JAXP 1.1 Transformation API for XML (<link idref="trax">TrAX</link>)
defines objects and methods for processing input and producing output in a
variety of formats, including character streams, SAX event streams, and DOM
Documents.</p>
<p>JAXP 1.1 defines the following feature URIs:</p>
<ul>
-<li><link
anchor="streamsource">"http://xml.apache.org.stream.StreamSource/feature";</link></li>
-<li><link
anchor="streamresult">"http://xml.apache.org.stream.StreamResult/feature";</link></li>
-<li><link
anchor="domsource">"http://xml.apache.org.dom.DOMSource/feature";</link></li>
-<li><link
anchor="domresult">"http://xml.apache.org.dom.DOMResult/feature";</link></li>
-<li><link
anchor="saxsource">"http://xml.apache.org.dom.SAXSource/feature";</link></li>
-<li><link
anchor="saxresult">"http://xml.apache.org.dom.SAXResult/feature";</link></li>
-<li><link
anchor="saxtransformerfactory">"http://xml.apache.org.sax.SAXTransformerFactory/feature";</link></li>
-<li><link
anchor="xmlfilter">"http://xml.apache.org.sax.SAXTransformerFactory/feature/xmlfilter";</link></li>
+<li><link
anchor="streamsource">"http://javax.xml.transform.stream.StreamSource/feature";</link></li>
+<li><link
anchor="streamresult">"http://javax.xml.transform.stream.StreamResult/feature";</link></li>
+<li><link
anchor="domsource">"http://javax.xml.transform.dom.DOMSource/feature";</link></li>
+<li><link
anchor="domresult">"http://javax.xml.transform.dom.DOMResult/feature";</link></li>
+<li><link
anchor="saxsource">"http://javax.xml.transform.dom.SAXSource/feature";</link></li>
+<li><link
anchor="saxresult">"http://javax.xml.transform.dom.SAXResult/feature";</link></li>
+<li><link
anchor="saxtransformerfactory">"http://javax.xml.transform.sax.SAXTransformerFactory/feature";</link></li>
+<li><link
anchor="xmlfilter">"http://javax.xml.transform.sax.SAXTransformerFactory/feature/xmlfilter";</link></li>
</ul>
<p>You can use the
<jump
href="apidocs/javax/xml/transform/TransformerFactory.html#getFeature(java.lang.String)">TransformerFactory.getFeature(String)</jump>
method to return a boolean indicating whether the implementation you are
using supports the use of one of these objects or methods. For the String
argument, provide the static String variable or literal URI String as detailed
below.</p>
<p>&xslt4j; supports <em>all</em> TransformerFactory features.</p>
<anchor name="streamsource"/>
-<s3 title='"http://xml.apache.org.stream.StreamSource/feature";'>
+<s3 title='"http://javax.xml.transform.stream.StreamSource/feature";'>
<p>The implementation supports the processing of <jump
href="apidocs/javax/xml/transform/stream/StreamSource.html">StreamSource</jump>
input objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static StreamSource.FEATURE variable (equivalent to the
URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
@@ -37,20 +36,22 @@
// Can process a StreamSource.
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="simpletransform">SimpleTransform</link>.</p>
</s3><anchor name="streamresult"/>
-<s3 title='"http://xml.apache.org.stream.StreamResult/feature";'>
+<s3 title='"http://javax.xml.transform.stream.StreamResult/feature";'>
<p>The implementation supports the production of transformation output in
the form of <jump
href="apidocs/javax/xml/transform/stream/StreamResult.html">StreamResult</jump>
objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static StreamResult.FEATURE variable (equivalent to the
URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
-import javax.xml.stream.StreamSource;
+import javax.xml.stream.StreamResult;
..
TransformerFactory tFact = TransformerFactory.newInstance();
if (tFact.getFeature(StreamResult.FEATURE)){
// Can generate a StreamResult.
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="simpletransform">SimpleTransform</link>.</p>
</s3><anchor name="domsource"/>
-<s3 title='"http://xml.apache.org.dom.DOMSource/feature";'>
+<s3 title='"http://javax.xml.transform.dom.DOMSource/feature";'>
<p>The implementation supports the processing of XML input in the form of
<jump href="apidocs/javax/xml/transform/dom/DOMSource.html">DOMSource</jump>
objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static DOMSource.FEATURE string variable (equivalent to
the URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
@@ -61,8 +62,9 @@
// Can process DOM input
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="dom2dom">DOM2DOM</link>.</p>
</s3><anchor name="domresult"/>
-<s3 title='"http://xml.apache.org.dom.DOMResult/feature";'>
+<s3 title='"http://javax.xml.transform.dom.DOMResult/feature";'>
<p>The implementation supports the production of transformation output in
the form of <jump
href="apidocs/javax/xml/transform/dom/DOMResult.html">DOMResult</jump>
objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static DOMResult.FEATURE variable (equivalent to the
URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
@@ -73,8 +75,9 @@
// Can generate DOM output.
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="dom2dom">DOM2DOM</link>.</p>
</s3><anchor name="saxsource"/>
-<s3 title='"http://xml.apache.org.dom.SAXSource/feature";'>
+<s3 title='"http://javax.xml.transform.dom.SAXSource/feature";'>
<p>The implementation supports the processing of XML input in the form of
<jump href="apidocs/javax/xml/transform/sax/SAXSource.html">SAXSource</jump>
objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static SAXSource.FEATURE string variable (equivalent to
the URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
@@ -86,7 +89,7 @@
..
}</source>
</s3><anchor name="saxresult"/>
-<s3 title='"http://xml.apache.org.dom.SAXResult/feature";'>
+<s3 title='"http://javax.xml.transform.dom.SAXResult/feature";'>
<p>The implementation supports the production of transformation output in
the form of <jump
href="apidocs/javax/xml/transform/sax/SAXResult.html">SAXResult</jump>
objects.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static SAXResult.FEATURE variable (equivalent to the
URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
@@ -97,8 +100,9 @@
// Can output SAX events.
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="sax2sax">SAX2SAX</link>.</p>
</s3><anchor name="saxtransformerfactory"/>
-<s3 title='"http://xml.apache.org.sax.SAXTransformerFactory/feature";'>
+<s3 title='"http://javax.xml.transform.sax.SAXTransformerFactory/feature";'>
<p>The implementation provides a <jump
href="apidocs/javax/xml/transform/sax/SAXTransformerFactory.html">SAXTransformerFactory</jump>.
You may safely cast
the TransformerFactory returned by TransformerFactory.newInstance() to a
SAXTransformerFactory.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static SAXTransformerFactory.FEATURE variable
@@ -111,8 +115,9 @@
SAXTransformerFactory saxTFact = (SAXTransformerFactory)tFact;
..
}</source>
+<p>For a example that uses this feature, see <link idref="samples"
anchor="sax2sax">SAX2SAX</link>.</p>
</s3><anchor name="xmlfilter"/>
-<s3
title='"http://xml.apache.org.sax.SAXTransformerFactory/feature/xmlfilter";'>
+<s3
title='"http://javax.xml.transform.sax.SAXTransformerFactory/feature/xmlfilter";'>
<p>The implementation supports the use of <jump
href="apidocs/org/xml/sax/XMLFilter.html">XMLFilter</jump> to use the output of
one transformation as input for another transformation. The
SAXTransformerFactory newXMLFilter(Source) and newXMLFilter(Templates) methods
are supported.</p>
<p>To determine whether your implementation supports this feature (&xslt4j;
does), you can use the static SAXTransformerFactory.FEATURE_XMLFilter variable
(equivalent to the URI String above) as follows:</p>
@@ -129,14 +134,16 @@
</s2><anchor name="factoryattribute"/>
<s2 title="&xslt4j; TransformerFactory attributes">
<p>A given implementation may provide TransformerFactory attributes that you
can set and get. &xslt4j; uses the <link idref="dtm">
-DTM (Document Table Model)</link> to support two such attributes:</p>
+DTM (Document Table Model)</link> to support three such attributes:</p>
<ul>
<li><link
anchor="optimize">"http://apache.org/xalan/features/optimize";</link></li>
<li><link
anchor="incremental">"http://apache.org/xalan/features/incremental";</link></li>
+<li><link
anchor="source-location">"http://apache.org/xalan/features/source-location";</link></li>
</ul>
-<p>To get an attribute setting, use the
TransformerFactory.getAttribute(String) method, which returns an Object that
(for these two &xslt4j; attributes) you can cast to a boolean. To set an
attribute, use the TransformerFactory.setAttribute(String, Object) method. For
the String argument, provide the static String variable or literal URI String
as detailed below. For the Object argument, use Boolean.TRUE or
Boolean.FALSE.</p><anchor name="optimize"/>
+<p>To get an attribute setting, use the
TransformerFactory.getAttribute(String) method, which returns an Object. For
these three &xslt4j;
+attributes, you can cast the return value to a boolean. To set an attribute,
use the TransformerFactory.setAttribute(String, Object) method. For the String
argument, provide the static String variable or literal URI String as detailed
below. For the Object argument, use Boolean.TRUE or Boolean.FALSE.</p><anchor
name="optimize"/>
<s3 title='"http://apache.org/xalan/features/optimize";'>
-<p>Optimize stylesheet processing. By default, this attribute is on. You may
need to turn it off for tooling applications. For more information, see <link
idref="dtm" anchor="incremental">incremental transforms</link>.</p>
+<p>Optimize stylesheet processing. By default, this attribute is on. You may
need to turn it off for tooling applications. For more information, see <link
idref="dtm" anchor="optimize">optimize</link>.</p>
<p>To turn optimization off, you can use the
TransformerFactoryImpl.FEATURE_OPTIMIZE static variable (equivalent to the URI
String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import org.apache.xalan.processor.TransformerFactoryImpl;
@@ -148,7 +155,7 @@
}</source>
</s3><anchor name="incremental"/>
<s3 title='"http://apache.org/xalan/features/incremental";'>
-<p>Produce output incrementally, rather than waiting to finish parsing the
input before generating any output. By default this attribute is off. You can
turn this attribute on to transform large documents where the stylesheet
structure is optimized to execute individual templates without having to parse
scattered sections of the document. For more information, see <link idref="dtm"
anchor="optimized">optimized transforms</link>.</p>
+<p>Produce output incrementally, rather than waiting to finish parsing the
input before generating any output. By default this attribute is off. You can
turn this attribute on to transform large documents where the stylesheet
structure is optimized to execute individual templates without having to parse
scattered sections of the document. For more information, see <link idref="dtm"
anchor="incremental">incremental</link>.</p>
<p>To turn incremental transformations on, you can use the
TransformerFactoryImpl.FEATURE_INCREMENTAL static variable (equivalent to the
URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
import org.apache.xalan.processor.TransformerFactoryImpl;
@@ -158,30 +165,23 @@
tFact.setAttribute(TransformerFactoryImpl.FEATURE_INCREMENTAL,
Boolean.FALSE);
}</source>
-</s3>
-</s2><anchor name="transformerproperty"/>
-<s2 title="&xslt4j; Transformer property">
-<p>A Transformer implementation may provide runtime properties that you can
set. The JAXP Transformer API provides no method for getting and setting
Transformer properties, so you must use the implementation API. The &xslt4j;
org.apache.xalan.transformer.TransformerImpl supports one such property:</p>
-<ul><li><link
anchor="source-location">"http://apache.org/xalan/properties/source-location";</link></li></ul>
-<p>You can use the TransformerImpl getProperty(String) and
setProperty(String). The getProperty method returns a boolean. For the String
argument, use the static String variable or literal URI String as indicated
below.</p><anchor name="source-location"/>
-<s3 title='"http://apache.org/xalan/properties/source-location";'>
-<p>Provide a <jump
href="apidocs/javax/xml/transform/SourceLocator.html">SourceLocator</jump> that
can be used from within a stylesheet, programatically, or in the command-line
utility to obtain the location in a source document (system ID, public ID, line
number, and column number) of individual nodes. By default, this property is
off.</p>
-<note>The <link idref="commandline">command-line utility</link> -L flag,
<link idref="usagepatterns" anchor="debugging">PrintTraceListener</link>, and
<link idref="extensionslib" anchor="nodeinfo">NodeInfo</link> extension set
this property to Boolean.TRUE.</note>
-<p>To set the SourceLocation property, you can use the
XalanProperties.SOURCE_LOCATION static variable (equivalent to the URI String
above) as follows:</p>
+</s3><anchor name="source-location"/>
+<s3 title='"http://apache.org/xalan/features/source-location";'>
+<p>Provide a <jump
href="apidocs/javax/xml/transform/SourceLocator.html">SourceLocator</jump> that
can be used from within a stylesheet,
+programatically, or in the command-line utility to obtain the location in a
source document (system ID, public ID, line number, and column number)
+of individual nodes.</p>
+<p>By default, this attribute is off. The <link
idref="commandline">command-line utility</link> -L flag sets this attribute to
Boolean.TRUE.
+You must set this attribute to Boolean.TRUE if you want to use the <link
idref="extensionslib" anchor="nodeinfo">NodeInfo</link> extension
+functions.</p>
+<p>To set the source-location attribute, you can use the
TransformerFactoryImpl.FEATURE_SOURCE_LOCATION static variable (equivalent to
the URI String above) as follows:</p>
<source>import javax.xml.transform.TransformerFactory;
-import javax.xml.transform.Transformer;
import org.apache.xalan.transformer.TransformerImpl;
import org.apache.xalan.transformer.XalanProperties;
..
TransformerFactory tFact = TransformerFactory.newInstance();
-Transformer transformer =
- tFact.newTransformer(new StreamSource("foo.xsl"));
-if (transformer instanceof TransformerImpl) {
- TransformerFactoryImpl transImpl =
- (TransformerFactoryImpl)transformer;
- transImpl.setProperty(XalanProperties.SOURCE_LOCATION,
- Boolean.TRUE);
- ..
+if (tFact instanceof TransformerFactoryImpl) {
+ tFact.setAttribute(TransformerFactoryImpl.FEATURE_SOURCE_LOCATION,
+ Boolean.TRUE);
}</source>
</s3>
</s2>
1.49 +1 -1 xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- usagepatterns.xml 30 Jan 2002 14:23:52 -0000 1.48
+++ usagepatterns.xml 30 Jan 2002 22:23:12 -0000 1.49
@@ -76,7 +76,7 @@
<li><link anchor="multithreading">Multithreading</link></li>
<li><link anchor="debugging">Debugger interface</link></li>
</ul>
-<p>See also: <link idref="features">Tranformer Features</link>.</p>
+<p>See also: <link idref="features">Transform Features</link>.</p>
<anchor name="basic"/>
<s2 title="Basic steps">
<ol>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
