<HTML><HEAD></HEAD><BODY> | |
<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> | |
<OL> | |
<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 | |
object.<BR><BR></LI> | |
<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> | |
</OL> | |
</BODY></HTML> |