blob: cf64817454a39d15f5a75e1a1f51f595d5aaa3bb [file] [log] [blame]
<P>This compatibility API supports limited use of the Xalan-Java 1 API in the Xalan-Java 2 environment. For the Xalan-Java 2 API, see <A href="../apidocs/index.html" target="_top">Xalan-Java 2 API</A>.</P>
<P><B>Basic procedure for performing transformations:</B></P>
<LI>Use one of the {@link org.apache.xalan.xslt.XSLTProcessorFactory} static getProcessor methods to
instantiate an {@link org.apache.xalan.xslt.XSLTProcessor}.<BR><BR>
The XSLT and XPath engines are independent from any given DOM or XML implementation. All parser-dependent
calls are funneled through the {@link org.apache.xalan.xpath.xml.XMLParserLiaison}.<BR><BR></LI>
<LI>Set up {@link org.apache.xalan.xslt.XSLTInputSource} objects for the XML input and XSL stylesheet.
You can use a file name or URL, character stream, byte stream, or SAX input stream to instantiate an
XSLTInputSource object.<BR><BR>
If the XML document contains a stylesheet Processing Instruction (PI), you do not need to create a separate
XSLTInputSource object for an XSL stylesheet.<BR><BR>
<B>Note:</B> For improved performance with a series of transformations, use the XSLTProcessor
processStylesheet method to compile the XSL stylesheet. The result is a
{@link org.apache.xalan.xslt.StylesheetRoot} object with its own process() method for performing transformations.
Compiling the stylesheet is also useful when you need to get information from the
stylesheet before the transformation occurs. You also must compile the stylesheet if you are using the
XSLTProcessor as a SAX document handler.<BR><BR></LI>
<LI>Set up an {@link org.apache.xalan.xslt.XSLTResultTarget} for the transformation output. You can use a
file name or URL, character stream, byte stream, or SAX document handler to instantiate an XSLTResultTarget
<LI>Use the XSLTProcessor or (if you have compiled the stylesheet) the(@link org.apache.xalan.xslt.StylesheetRoot}
process method to perform the transformation.<BR><BR>
Xalan-Java is thread-safe for one instance per thread. If you are using the same instance of XSLTProcessor to
perform more than one transformation, call the reset method between transformations.</LI>