dleslie 00/01/10 14:20:22
Modified: targets/xalan overview.html install.html commandline.html
api.html
Log:
editorial and link fixes per SPR SCUU4FER9P
Revision Changes Path
1.10 +2 -2 xml-site/targets/xalan/overview.html
Index: overview.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/overview.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- overview.html 2000/01/06 21:50:53 1.9
+++ overview.html 2000/01/10 22:20:21 1.10
@@ -45,7 +45,7 @@
</PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
<P>foo.xsl:</P>
<DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
-<xx?xml version="1.0"?>
+<?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:template match="doc">
<out><xsl:value-of select="."/></out>
@@ -62,7 +62,7 @@
</FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Xalan-Java Features</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1"
hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<UL>
<LI>Implements the <A href="http://www.w3.org/TR/1999/REC-xslt-19991116" target="_top">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</A>.</LI>
- <LI>Uses Xerces-Java></LI>
+ <LI>Uses Xerces-Java</LI>
<LI>Can interface to any XML parser that produces Java DOM Trees</LI>
<LI>Can output to SAX or DOM</LI>
<LI>Includes an applet wrapper</LI>
1.8 +10 -10 xml-site/targets/xalan/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/install.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- install.html 2000/01/06 21:50:53 1.7
+++ install.html 2000/01/10 22:20:21 1.8
@@ -24,7 +24,7 @@
(Xalan-Java should also work fine with 1.1.6 or later versions of the 1.1 JDK or Java
runtime.)</P></LI>
<LI><P>Download <A href="http://xml.apache.org/dist/" target="_top">Xalan distribution</A>.</P></LI>
- <LI><P>Download <A href="http://xml.apache.org/xerces-j/index.html" target="_top">Version 1.0.0 of Xerces-Java</A>.</P></LI>
+ <LI><P>Download <A href="http://xml.apache.org/xerces-j/index.html" target="_top">Version 1.0.1 of Xerces-Java</A>.</P></LI>
<LI><P>Add the Xalan-Java and Xerces-Java JAR files (xalan.jar and xerces.jar) to the system classpath. To add
these jars to the system classpath, you can include a set statement along the lines of</P>
<P><CODE><FONT face="courier, monospaced">set CLASSPATH=\xalan\xalan.jar;\xerces\xerces.jar;%CLASSPATH%</FONT></CODE></P>
@@ -34,12 +34,12 @@
java classes. For more information, see <A href="commandline.xml-index.html" target="_top">Xalan Command-Line Utility</A> and
<A href="api.xml-index.html" target="_top">API Overview</A>.</P>
</FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using Xalan-Java with an Xerces-Java Parser</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG bo
rder="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>By default, Xalan 0.19.1 uses the high-performance DTM parser in Xalan 1.0.0 to parse XML documents
+ <P>By default, Xalan 0.19.2 uses the high-performance DTM parser in Xerces 1.0.1 to parse XML documents
and XSL stylesheets. As indicated in the preceding section, you provide Xalan-Java access to this parser by downloading
- Xerces-Java from http://xml.apache.org and placing xalan.jar in the classpath. Xalan-Java also provides a liaison for the
+ Xerces-Java from http://xml.apache.org and placing xerces.jar in the classpath. Xalan-Java also provides a liaison for the
Xerces-Java 1.0.0 DOM parser.</P>
<TABLE border="0" cellpadding="0" cellspacing="3" width="100%"><TR><TD valign="top" width="20"><IMG alt="Note" border="0" height="24" hspace="0" src="resources/note.gif" vspace="0" width="20"></TD><TD valign="top"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1"><I><P>If you want to use earlier alphaWorks releases of the XML4J DOM or TXDOM parsers, you should download
- LotusXSL 0.19.1 from http://www.alphaworks.ibm.com/tech/LotusXSL.</P></I></FONT></TD></TR></TABLE>
+ LotusXSL 0.19.2 from http://www.alphaworks.ibm.com/tech/LotusXSL.</P></I></FONT></TD></TR></TABLE>
<P>If you want to use Xalan-Java with some other XML parser, it is up to you to implement a liaison
to the parser. Your liaison class should extend org.apache.xalan.xpath.xml.XMLParserLiaisonDefault
and implement org.apache.xalan.xpath.XPathSupport.</P>
@@ -50,12 +50,12 @@
<LI><P>Set up GNU or the equivalent build environment on your workstation.</P>
<P> If you are running Windows 95/98/NT, you can use the Cygwin port of GNU. Be sure to put the
appropriate Cygwin bin directory at the beginning of your system path. For information about Cygwin, see
- <A href="http://sourceware.cygnus.com/cygwin/.html">Cygwin</A>.</P></LI>
- <LI><P>Place <A href="http://xml.apache.org/xerces-j/index.html" target="_top">Version 1.0.0 of Xerces-Java</A> xerces.jar in the Java classpath.</P></LI>
+ <A href="http://www.sourceware.cygnus.com/cygwin/" target="_top">Cygwin</A>.</P></LI>
+ <LI><P>Place <A href="http://xml.apache.org/xerces-j/index.html" target="_top">Version 1.0.1 of Xerces-Java</A> xerces.jar in the Java classpath.</P></LI>
<LI><P>If you are working in Windows, set MAKE_MODE as follows:</P>
<P><CODE><FONT face="courier, monospaced">set MAKE_MODE=UNIX</FONT></CODE></P></LI>
- <LI><P>Run the lMakefile in the Xalan-Java root directory:</P>
- <P><CODE><FONT face="courier, monospaced">make -f lMakefile build</FONT></CODE></P></LI>
+ <LI><P>Run the make file in the Xalan-Java root directory:</P>
+ <P><CODE><FONT face="courier, monospaced">make build</FONT></CODE></P></LI>
</OL>
</FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Generating the documentation</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" heig
ht="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
<P>Xalan-Java includes a number of XML source files, XSL stylesheets, document type definition (DTD)
@@ -63,7 +63,7 @@
and the overview and package-level documents used during the generation of Javadoc.</P>
<P>To generate the Xalan User's Guide, run the Xalan make file in the Xalan <B>docs</B>
directory:</P>
- <P><CODE><FONT face="courier, monospaced">make -f lMakefile stylebook</FONT></CODE></P>
+ <P><CODE><FONT face="courier, monospaced">make stylebook</FONT></CODE></P>
<P>To generate Xalan API documentation, set up the make file to use the Javadoc tool in the Java JDK 1.2.2 bin
directory. </P>
<P>Do the following:</P>
@@ -71,7 +71,7 @@
<LI><P>Put the Java JDK 1.2.2 bin directory on your path (in front of any JDK 1.1.x bin
directory that appears on the path).</P></LI>
<LI><P>In the Xalan docs directory, run the Xalan make file as follows:</P>
- <P><CODE><FONT face="courier, monospaced">make -f lMakefile javadoc</FONT></CODE></P></LI>
+ <P><CODE><FONT face="courier, monospaced">make javadoc</FONT></CODE></P></LI>
</OL>
</FONT></TD></TR></TABLE><BR></TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
Copyright © 1999 The Apache Software Foundation.
1.6 +71 -71 xml-site/targets/xalan/commandline.html
Index: commandline.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/commandline.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- commandline.html 2000/01/03 15:22:38 1.5
+++ commandline.html 2000/01/10 22:20:21 1.6
@@ -1,72 +1,72 @@
-<HTML><HEAD><SCRIPT language="JavaScript" src="resources/script.js" type="text/javascript"></SCRIPT><TITLE>Command-Line Utility</TITLE></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="graphics/commandline-header.jpg" vspace="0" width
="456"></TD></TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','resources/button-xml-hi.gif','resources/button-xml-lo.gif');" src="resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','resources/button-asf-hi.gif','resources/button-asf-lo.gif');" src="resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A
href="http://www.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','resources/button-w3c-hi.gif','resources/button-w3c-lo.gif');" src="resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="resources/join.gif" vspace="0" width="120"><BR>
-<A href="../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','graphics/ext-2-label-2.jpg','graphics/ext-2-label-3.jpg');" src="graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="overview.html" onMouseOut="rolloverOff('side-overview');" onMouseOver="rolloverOn('side-overview');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-overview" onLoad="rolloverLoad('side-overview','graphics/overview-label-2.jpg','graphics/overview-label-3.jpg');" src="graphics/overview-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','graphics/install-label-2.jpg','graphics/install-label-3.jpg');" src="graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
-
-<A href="readme.html" onMouseOut="rolloverOff('side-readme');" onMouseOver="rolloverOn('side-readme');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-readme" onLoad="rolloverLoad('side-readme','graphics/readme-label-2.jpg','graphics/readme-label-3.jpg');" src="graphics/readme-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-
-<IMG alt="Command Line" border="0" height="12" hspace="0" src="graphics/commandline-label-1.jpg" vspace="0" width="120"><BR>
-
-<A href="api.html" onMouseOut="rolloverOff('side-api');" onMouseOver="rolloverOn('side-api');"><IMG alt="Xalan API" border="0" height="12" hspace="0" name="side-api" onLoad="rolloverLoad('side-api','graphics/api-label-2.jpg','graphics/api-label-3.jpg');" src="graphics/api-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="xslt4c.html" onMouseOut="rolloverOff('side-xslt4c');" onMouseOver="rolloverOn('side-xslt4c');"><IMG alt="Xalan C++" border="0" height="12" hspace="0" name="side-xslt4c" onLoad="rolloverLoad('side-xslt4c','graphics/xslt4c-label-2.jpg','graphics/xslt4c-label-3.jpg');" src="graphics/xslt4c-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" he
ight="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Command-Line Utility</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>To perform a transformation, you can call Xalan-Java from the command line (or script),
- an applet, an application, or a servlet. see <A href="api.xml-index.html" target="_top">API Overview</A> and <A href="apidocs/index.html" target="_top">API Documentation</A>.</P>
- <P>The org.apache.xml.xslt4j.Process main() method provides a comand-line interface
- for performing XSL transformation. To perform a transformation from the command line or a script,
- do the following:</P>
- <OL>
- <LI><P>Install Xalan-Java. See <A href="install.xml-index.html" target="_top">Installing Xalan</A>.</P></LI>
- <LI><P>Set the java Classpath to include xalan.jar and xerces.jar.</P>.</LI>
- <LI><P>Call java and the Process class with the appropriate switches and
- arguments (described below). The following command line, for example, includes the -IN, -XSL,
- and -OUT switches with their accompanying arguments -- the XML source document, the XSL
- stylesheet, and the output file:</P>
- <CODE><FONT face="courier, monospaced">java org.apache.xalan.xslt.Process -IN foo.xml -XSL foo.xsl -OUT foo.out</FONT></CODE>
- </LI></OL>
- <P>The command line utility can take the following switches and arguments:</P>
- <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
- -IN inputXMLURL
- -XSL XSLTransformationURL
- -OUT outputFileName
- -LXCIN compiledStylesheetFileNameIn
- -LXCOUT compiledStylesheetFileNameOut (it will be big!)
- -PARSER fully qualified class name of parser liaison
- -E (Keep--do not expand -- entity refs)
- -V (Version info)
- -QC (Quiet Pattern Conflicts Warnings)
- -Q (Quiet Mode)
- -LF (Use linefeeds only on output -- default is CR/LF)
- -CR (Use carriage returns only on output -- default is CR/LF)
- -INDENT (Number of spaces to indent each level in output tree --default is 0)
- -TT (Trace the templates as they are being called)
- -TG (Trace each result tree generation event)
- -TS (Trace each selection event)
- -TTC (Trace the template children as they are being processed)
- -VALIDATE (Validate the XML and XSL input -- validation is off by default)
- -EDUMP [optional]FileName (Do stackdump on error)
- -XML (Use XML formatter and add XML header)
- -TEXT (Use simple Text formatter)
- -HTML (Use HTML formatter)
- -PARAM name expression (Set a stylesheet parameter)
- </PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
- <P>Use -IN to specify the XML source document. To specify the XSL stylesheet, use -XSL
- or -LXCIN. To compile an XSL stylesheet for future use as -LXCIN input, use -LXCOUT.</P>
- <P>Include -PARSER if you supply your own parser liaison class, which is required
- if you do not use the Xerces-Java parser.</P>
- <P>Use -TEXT if you want the output to include only element values (not element tags with element names and
- attributes). Use -HTML to write 4.0 transitional HTML (some elements, such as ltxxbr>, are
- not well formed.</P>
- <P>To set stylesheet parameters from the command line, use -PARAM name expression. If
- you want to set the parameter to a string value, enclose the string in single quotes (') to
- make it an expression.</P>
- </FONT></TD></TR></TABLE><BR></TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
- Copyright © 1999 The Apache Software Foundation.
- All Rights Reserved.
+<HTML><HEAD><SCRIPT language="JavaScript" src="resources/script.js" type="text/javascript"></SCRIPT><TITLE>Command-Line Utility</TITLE></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="graphics/commandline-header.jpg" vspace="0" width
="456"></TD></TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','resources/button-xml-hi.gif','resources/button-xml-lo.gif');" src="resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','resources/button-asf-hi.gif','resources/button-asf-lo.gif');" src="resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A
href="http://www.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','resources/button-w3c-hi.gif','resources/button-w3c-lo.gif');" src="resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="resources/join.gif" vspace="0" width="120"><BR>
+<A href="../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','graphics/ext-2-label-2.jpg','graphics/ext-2-label-3.jpg');" src="graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="overview.html" onMouseOut="rolloverOff('side-overview');" onMouseOver="rolloverOn('side-overview');"><IMG alt="Overview" border="0" height="12" hspace="0" name="side-overview" onLoad="rolloverLoad('side-overview','graphics/overview-label-2.jpg','graphics/overview-label-3.jpg');" src="graphics/overview-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','graphics/install-label-2.jpg','graphics/install-label-3.jpg');" src="graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
+
+<A href="readme.html" onMouseOut="rolloverOff('side-readme');" onMouseOver="rolloverOn('side-readme');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-readme" onLoad="rolloverLoad('side-readme','graphics/readme-label-2.jpg','graphics/readme-label-3.jpg');" src="graphics/readme-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+
+<IMG alt="Command Line" border="0" height="12" hspace="0" src="graphics/commandline-label-1.jpg" vspace="0" width="120"><BR>
+
+<A href="api.html" onMouseOut="rolloverOff('side-api');" onMouseOver="rolloverOn('side-api');"><IMG alt="Xalan API" border="0" height="12" hspace="0" name="side-api" onLoad="rolloverLoad('side-api','graphics/api-label-2.jpg','graphics/api-label-3.jpg');" src="graphics/api-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="xslt4c.html" onMouseOut="rolloverOff('side-xslt4c');" onMouseOver="rolloverOn('side-xslt4c');"><IMG alt="Xalan C++" border="0" height="12" hspace="0" name="side-xslt4c" onLoad="rolloverLoad('side-xslt4c','graphics/xslt4c-label-2.jpg','graphics/xslt4c-label-3.jpg');" src="graphics/xslt4c-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" he
ight="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Command-Line Utility</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>To perform a transformation, you can call Xalan-Java from the command line (or script),
+ an applet, an application, or a servlet. see <A href="api.xml-index.html" target="_top">API Overview</A> and <A href="apidocs/index.html" target="_top">API Documentation</A>.</P>
+ <P>The org.apache.xalan.xslt.Process main() method provides a comand-line interface
+ for performing XSL transformation. To perform a transformation from the command line or a script,
+ do the following:</P>
+ <OL>
+ <LI><P>Install Xalan-Java. See <A href="install.xml-index.html" target="_top">Installing Xalan</A>.</P></LI>
+ <LI><P>Set the java Classpath to include xalan.jar and xerces.jar.</P>.</LI>
+ <LI><P>Call java and the Process class with the appropriate switches and
+ arguments (described below). The following command line, for example, includes the -IN, -XSL,
+ and -OUT switches with their accompanying arguments -- the XML source document, the XSL
+ stylesheet, and the output file:</P>
+ <CODE><FONT face="courier, monospaced">java org.apache.xalan.xslt.Process -IN foo.xml -XSL foo.xsl -OUT foo.out</FONT></CODE>
+ </LI></OL>
+ <P>The command line utility can take the following switches and arguments:</P>
+ <DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
+ -IN inputXMLURL
+ -XSL XSLTransformationURL
+ -OUT outputFileName
+ -LXCIN compiledStylesheetFileNameIn
+ -LXCOUT compiledStylesheetFileNameOut (it will be big!)
+ -PARSER fully qualified class name of parser liaison
+ -E (Keep--do not expand -- entity refs)
+ -V (Version info)
+ -QC (Quiet Pattern Conflicts Warnings)
+ -Q (Quiet Mode)
+ -LF (Use linefeeds only on output -- default is CR/LF)
+ -CR (Use carriage returns only on output -- default is CR/LF)
+ -INDENT (Number of spaces to indent each level in output tree --default is 0)
+ -TT (Trace the templates as they are being called)
+ -TG (Trace each result tree generation event)
+ -TS (Trace each selection event)
+ -TTC (Trace the template children as they are being processed)
+ -VALIDATE (Validate the XML and XSL input -- validation is off by default)
+ -EDUMP [optional]FileName (Do stackdump on error)
+ -XML (Use XML formatter and add XML header)
+ -TEXT (Use simple Text formatter)
+ -HTML (Use HTML formatter)
+ -PARAM name expression (Set a stylesheet parameter)
+ </PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
+ <P>Use -IN to specify the XML source document. To specify the XSL stylesheet, use -XSL
+ or -LXCIN. To compile an XSL stylesheet for future use as -LXCIN input, use -LXCOUT.</P>
+ <P>Include -PARSER if you supply your own parser liaison class, which is required
+ if you do not use the Xerces-Java parser.</P>
+ <P>Use -TEXT if you want the output to include only element values (not element tags with element names and
+ attributes). Use -HTML to write 4.0 transitional HTML (some elements, such as ltxxbr>, are
+ not well formed.</P>
+ <P>To set stylesheet parameters from the command line, use -PARAM name expression. If
+ you want to set the parameter to a string value, enclose the string in single quotes (') to
+ make it an expression.</P>
+ </FONT></TD></TR></TABLE><BR></TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
+ Copyright © 1999 The Apache Software Foundation.
+ All Rights Reserved.
</I></FONT></TD></TR></TABLE></BODY></HTML>
1.6 +167 -205 xml-site/targets/xalan/api.html
Index: api.html
===================================================================
RCS file: /home/cvs/xml-site/targets/xalan/api.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- api.html 2000/01/03 15:22:38 1.5
+++ api.html 2000/01/10 22:20:21 1.6
@@ -1,206 +1,168 @@
-<HTML><HEAD><SCRIPT language="JavaScript" src="resources/script.js" type="text/javascript"></SCRIPT><TITLE>Xalan-Java API</TITLE></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="graphics/api-header.jpg" vspace="0" width="456"></TD></
TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','resources/button-xml-hi.gif','resources/button-xml-lo.gif');" src="resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','resources/button-asf-hi.gif','resources/button-asf-lo.gif');" src="resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://w
ww.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','resources/button-w3c-hi.gif','resources/button-w3c-lo.gif');" src="resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="resources/join.gif" vspace="0" width="120"><BR>
-<A href="../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','graphics/ext-2-label-2.jpg','graphics/ext-2-label-3.jpg');" src="graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="overview.html" onMouseOut="rolloverOff('side-overview');" onMouseOver="rolloverOn('side-overview');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-overview" onLoad="rolloverLoad('side-overview','graphics/overview-label-2.jpg','graphics/overview-label-3.jpg');" src="graphics/overview-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','graphics/install-label-2.jpg','graphics/install-label-3.jpg');" src="graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
-
-<A href="readme.html" onMouseOut="rolloverOff('side-readme');" onMouseOver="rolloverOn('side-readme');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-readme" onLoad="rolloverLoad('side-readme','graphics/readme-label-2.jpg','graphics/readme-label-3.jpg');" src="graphics/readme-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-
-<A href="commandline.html" onMouseOut="rolloverOff('side-commandline');" onMouseOver="rolloverOn('side-commandline');"><IMG alt="Command Line" border="0" height="12" hspace="0" name="side-commandline" onLoad="rolloverLoad('side-commandline','graphics/commandline-label-2.jpg','graphics/commandline-label-3.jpg');" src="graphics/commandline-label-3.jpg" vspace="0" width="120"></A><BR>
-
-<IMG alt="Xalan API" border="0" height="12" hspace="0" src="graphics/api-label-1.jpg" vspace="0" width="120"><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
-<A href="xslt4c.html" onMouseOut="rolloverOff('side-xslt4c');" onMouseOver="rolloverOn('side-xslt4c');"><IMG alt="Xalan C++" border="0" height="12" hspace="0" name="side-xslt4c" onLoad="rolloverLoad('side-xslt4c','graphics/xslt4c-label-2.jpg','graphics/xslt4c-label-3.jpg');" src="graphics/xslt4c-label-3.jpg" vspace="0" width="120"></A><BR>
-<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" he
ight="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Introduction</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>This document provides an overview of the Xalan-Java API. For the details (javadoc), see
- <A href="apidocs/index.html" target="_top">API Documentation</A>. For a general introduction to Xalan-Java, see
- <A href="overview.xml.html">Overview: XSL Transformer for Java (Xalan)</A>. For specifics
- concerning the current release, see <A href="readme.xml.html">Release Notes</A>.</P>
-
- <P>Xalan-Java takes as primary input an XML source document and an XSL stylesheet. The XML document and the XSL stylesheet
- may be a URL or file, a character stream, an input stream, or a DOM tree. The stylesheet may also take the form of a
- compiled stylesheet. If the XML document contains a stylesheet Processing Instruction (PI), a separate stylesheet is not
- required.</P>
- <P>Xalan-Java uses an implementation of the <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaison.html" target="_top">XMLParserLiaison interface</A> to interact with Xerces-Java (or another
- XML parsser) and sends output events to a <A href="apidocs/org/apache/xalan/xpath/xml/FormatterListener.html" target="_top">FormatterListener</A>, an extension of
- <A href="http://www.megginson.com/SAX/sax.html" target="_top">SAX</A> <A href="http://www.megginson.com/SAX/javadoc/org.xml.sax.DocumentHandler.html#_top" target="_top">org.xml.sax.DocumentHandler</A>.</P>
- <P>The XSLT and XPath engines are independent from any given DOM or XML implementation. All parser-dependent calls are
- funneled through the XMLParserLiaison.</P>
- </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Packages</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src
="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>Xalan-Java is composed of three XPATH4J packages and four Xalan-Java packages. The XPATH4J packages can be used on their
- own, but for convenience are packaged in the same JAR as the XSLT processor.</P>
- <P>XPATH4J packages:</P>
- <UL>
- <LI><P><A href="apidocs/org/apache/xalan/xpath/package-summary.html" target="_top">org.apache.xalan.xpath package</A> -- Contains the infrastructure for processing
- XPATH expressions.</P></LI>
- <LI><P><A href="apidocs/org/apache/xalan/xpath/xml/package-summary.html" target="_top">org.apache.xalan.xpath.xml package</A> -- The <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaison.html" target="_top">XMLParserLiaison interface</A>
- provides a liaison between the XSLT processor and an XML parser. Unless you specify an XML parser and your own
- implementation of the XMLParserLiaison interface, Xalan-Java uses <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaisonDefault.html" target="_top">XMLParserLiaisonDefault class</A> to
- interface the Xerces-Java parser. This package also includes four implementations of the
- <A href="apidocs/org/apache/xalan/xpath/xml/FormatterListener.html" target="_top">FormatterListener</A>, a SAX-based formatter interface for the XSL
- processor: the <A href="apidocs/org/apache/xalan/xpath/xml/FormatterToDOM.html" target="_top">FormatterToDOM class</A>, the <A href="apidocs/org/apache/xalan/xpath/xml/FormatterToXML.html" target="_top">FormatterToXML class</A>, the
- <A href="apidocs/org/apache/xalan/xpath/xml/FormatterToHTML.html" target="_top">FormatterToHTML class</A> (an extension of FormatterToXML), and the
- <A href="apidocs/org/apache/xalan/xpath/xml/FormatterToText.html" target="_top">FormatterToText class</A>.</P></LI>
- <LI><P><A href="apidocs/org/apache/xalan/xpath/xml4j2dom/package-summary.html" target="_top">org.apache.xalan.xpath.xml4j2dom package</A> -- Contains the
- <A href="apidocs/org/apache/xalan/xpath/xml4j2dom/XML4JLiaison4dom.html" target="_top">XML4JLiaison4dom class</A>, an extension of the XMLParserLiaisonDefault that provides an interface to
- XML4J Version 2.0.15.</P></LI>
- </UL>
- <P>Xalan-Java packages:</P>
- <UL>
- <LI><P><A href="apidocs/org/apache/xalan/xslt/package-summary.html" target="_top">org.apache.xalan.xslt package</A> -- This is the main Xalan-Java package.</P>
- <P>The <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A> defines the XSLT processor API. The
- <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> provides methods for creating an instance of the XSLT processor,
- which actually uses <A href="apidocs/org/apache/xalan/xslt/XSLTEngineImpl.html" target="_top">XSLTEngineImpl class</A>, an implementation of XSLTProcessor that users never need
- to call directly.</P>
- <P>To perform a transformation, you also need <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A> objects to represent the the
- XML source document and the XSL stylesheet, and an <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A> object to represent the
- result of the transformation.</P>
- </LI>
- <LI><P><A href="apidocs/org/apache/xalan/xslt/client/package-summary.html" target="_top">org.apache.xalan.xslt.client package</A> -- Contains
- <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html" target="_top">XSLTProcessorApplet class</A>, a simple applet for hosting the Xalan-Java processor.</P></LI>
- <LI><P><A href="apidocs/org/apache/xalan/xslt/extensions/package-summary.html" target="_top">org.apache.xalan.xslt.extensions package</A> -- Contains <A href="apidocs/org/apache/xalan/xpath/extensions/Redirect.html" target="_top">Redirect class</A>,
- an element extension class that allows an XSLT transformation to redirect its output to multiple FormatterListeners
- and documents.</P></LI>
- <LI><P><A href="apidocs/org/apache/xalan/xslt/trace/package-summary.html" target="_top">org.apache.xalan.xslt.trace package</A> -- Contains a
- <A href="#debugger-interface" target="_top">debugger interface</A> for Xalan-Java.</P></LI>
- </UL>
- </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Performing XSL Transformations</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0"
height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>This release of Xalan-Java supports three mechanisms for transforming an xml document.</P>
- <UL>
- <LI>Calling the Xalan-Java processor from the command-line</LI>
- <LI>Calling the Xalan-Java API from another java class</LI>
- <LI>Using the Xalan-Java applet wrapper</LI>
- </UL>
- <P>For information about performing transformation from the command-line or a script, see <A href="CommandLineUtility" target="_top"></A>.</P>
- <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Calling the Xalan-Java API from a java class</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src=
"resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
- <P>In the java class where you want to perform an XSL transformation, do the following:</P>
- <OL>
- <LI>Call one of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> static getProcessor() methods to
- instantiate an implementation of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A>.
- <P>XSLTProcessorFactory uses XSLTEngineImpl, an implementation of the XSLTProcessor interface that you never need
- to call directly.</P></LI>
- <LI><P>Create <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A> objects for the XML source document and the XSL stylesheet,
- and an <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A> object for the output.</P>
- <P>If the XML document contains a stylesheet Processing Instruction (PI), you do not need to create a separate
- XSLTInputSource object for an XSL stylesheet.</P></LI>
- <LI><P>Call the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#process(org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTResultTarget)" target="_top">XSLTProcessor process() method</A>.</P></LI></OL>
- <P>In your application, for example, you could include the following transform method(), then call this method with file
- names or URLs for the source XML document, the XSL stylesheet and the new document to be produced.</P><DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
-public static void transform(String xmlSourceURL, String xslURL, String outputURL)
- throws java.io.IOException,
- java.net.MalformedURLException,
- org.xml.sax.SAXException
-{
- // Instantiate an XSLTProcessor.
- org.apache.xalan.xslt.XSLTProcessor processor =
- org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor();
-
- // Create the 3 objects the XSLTProcessor needs to perform the transformation.
- org.apache.xalan.xslt.XSLTInputSource xmlSource =
- new org.apache.xalan.xslt.XSLTInputSource (xmlSourceURL);
- org.apache.xalan.xslt.XSLTInputSource xslSheet =
- new org.apache.xalan.xslt.XSLTInputSource (xslURL);
- org.apache.xalan.xslt.XSLTResultTarget xmlResult =
- new org.apache.xalan.xslt.XSLTResultTarget (outputURL);
-
- // Perform the transformation.
- processor.process(xmlSource, xslSheet, xmlResult);
- }</PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
- <P>The XSLTProcessor "compiles" the input XSL stylesheet into an internal representation,
- the <A href="apidocs/org/apache/xalan/xslt/Stylesheet.html" target="_top">Stylesheet class</A>. You can compile the stylesheet separately,
- before the transformation is complete, via the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#processStylesheet(java.lang.String)" target="_top">processStylesheet method</A>. This is
- especially useful when you need to get information from the stylesheet before the tranformation occurs,
- for instance, when you need to find out the output encoding in order to construct the right kind of Writer.</P>
- <P>Stylesheet parameters can be set via the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#setStylesheetParam(java.lang.String, java.lang.String)" target="_top">setStylesheetParam method</A>.
- This method takes as input an <A href="apidocs/org/apache/xalan/xpath/XObject.html" target="_top">XObject class</A> or derivative. The
- XObject class itself can hold any kind of Java object, if you need to pass it
- to an extension. Each XObject type has a convenience function on the XSLTProcessor class to make it easy
- to create:</P>
- <UL>
- <LI><A href="apidocs/org/apache/xalan/xpath/XObject.html" target="_top">XObject class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXObject(java.lang.Object)" target="_top">createXObject method</A></LI>
- <LI><A href="apidocs/org/apache/xalan/xpath/XNodeSet.html" target="_top">XNodeSet class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNodeSet(org.w3c.dom.NodeList)" target="_top">createXNodeSet(NodeList nl) method</A> or
- <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNodeSet(org.w3c.dom.Node)" target="_top">createXNodeSet(Node n) method</A></LI>
- <LI><A href="apidocs/org/apache/xalan/xpath/XBoolean.html" target="_top">XBoolean class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXBoolean(boolean)" target="_top">createXBoolean method</A></LI>
- <LI><A href="apidocs/org/apache/xalan/xpath/XNumber.html" target="_top">XNumber class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNumber(double)" target="_top">createXNumber method</A></LI>
- <LI><A href="apidocs/org/apache/xalan/xpath/XNull.html" target="_top">XNull class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNull()" target="_top">createXNull method</A></LI>
- <LI><A href="apidocs/org/apache/xalan/xpath/XString.html" target="_top">XString class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXString(java.lang.String)" target="_top">createXString method</A></LI>
- </UL>
- <P>Xalan-Java is thread-safe for one instance per thread. However,
- if you reuse the processor instance, you should call reset() between calls.</P>
- <P>The XPath engine has pluggable backend drivers called <A href="apidocs/org/apache/xalan/xpath/XLocator.html" target="_top">XLocator interface</A>s.
- The default implementation of the XLocator is the <A href="apidocs/org/apache/xalan/xpath/SimpleNodeLocator.html" target="_top">SimpleNodeLocator class</A>.
- Though users of the API can implement their own XLocators for custom data access,
- it is not for the faint of heart.</P>
-</FONT></TD></TR></TABLE><BR>
-
-<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Xalan-Java applet</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
-<OL>
-<LI><P>Include <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html" target="_top">XSLTProcessorApplet class</A> in an HTML client.</P></LI>
-<LI><P>Specify the XML source document and XSL stylesheet.</P>
-<P>You can use the DocumentURL and StyleURL PARAM tags or the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setDocumentURL(java.lang.String)" target="_top">XSLTProcessorApplet setDocumentURL() method</A> and <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setStyleURL(java.lang.String)" target="_top">XSLTProcessorApplet setStyleURL() method</A>. If the XML document contains a stylesheet Processing Instruction (PI), you do not need to specify an XSL stylesheet.</P></LI>
-<LI>Call the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#transformToHtml(java.lang.String, java.lang.String)" target="_top">XSLTProcessorApplet transformHTML() method</A> which performs the transformation and returns the new document as a String.</LI></OL>
-</FONT></TD></TR></TABLE><BR>
-<A name="debugger-interface"></A>
-</FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Debugger Interface</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace
="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>Xalan-Java contains a debugger interface in the org.apache.xalan.xslt.trace package. This
- should be looked upon as a work in progress, possibly to be replaced by a more
- standard interface in the future. The source code information given is
- somewhat limited by what the SAX interface provides... the line and column numbers
- at the *end* of the event. I'll have to work on obtaining the character selection
- of the executing event. Also, at this time there is no source tree line information
- available. Again, I'll be working on this. The interfaces are:</P>
- <UL>
- <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/TraceListener.html" target="_top">TraceListener class</A> is an interface that debuggers
- can implement. The interface can be set on the
- <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A> by calling the addTraceListener() function.</P></LI>
- <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/PrintTraceListener.html" target="_top">PrintTraceListener class</A> is an implementation of
- the TraceListener interface that is used by Xalan-Java for the -TT, TG, and -TTC
- switches. It's code is a good example to look at when figuring out how to
- use the trace functionality.</P></LI>
- <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/TracerEvent.html" target="_top">TracerEvent class</A> is an event that is
- passed to the TraceListener.trace() function. It is called before a node is 'executed'
- in the stylesheet.</P></LI>
- <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/GenerateEvent.html" target="_top">GenerateEvent class</A> is an event that is
- passed to the TraceListener.generated() function. It is called after an event
- occurs to create something in the result tree.</P></LI>
- </UL>
- </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Source Code</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <P>The source code is in the <A href="../src" target="_top">'xml-xalan/src' directory</A>.</P>
- <P>The <A href="src/org/apache/xalan/xslt/XSLTEngineImpl.java" target="_top">XSLTEngineImpl class</A> class is where the main
- stuff is going on. This is a big file, so I highly recommend using an IDE.</P>
- <P> The XPaths are parsed in the
- <A href="apidocs/org/apache/xalan/xpath/XPathProcessorImpl.html" target="_top">XPathProcessorImpl class</A>, the result XPath object is
- performed in the <A href="apidocs/org/apache/xalan/xpath/XPath.html" target="_top">XPath class</A>, and the query and pattern
- match is performed in the <A href="apidocs/org/apache/xalan/xpath/SimpleNodeLocator.html" target="_top">SimpleNodeLocator class</A>>.</P>
- </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Glossary</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src
="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
- <DL>
- <DT>XSL Instruction</DT>
- <DD>Any tag with an XSL namespace prefix.<P></P></DD>
-
- <DT>XSL Template Instruction</DT>
- <DD>Any tag with an XSL namespace prefix
- that occurs inside an xsl:template element.<P></P></DD>
-
- <DT>Template Child</DT>
- <DD>Any node that is a child of an xsl:template element.<P></P></DD>
-
- <DT>Source Tree</DT>
- <DD>The tree input to the XSL process.<P></P></DD>
-
- <DT>Result Tree</DT>
- <DD>The tree that is output by the XSL process.<P></P></DD>
-
- <DT>Stylesheet Tree</DT>
- <DD>The stylesheet tree produced from the XSL file.<P></P></DD>
-
- <DT>Pattern List</DT>
- <DD>A parsed query or match pattern.<P></P></DD>
- </DL>
- </FONT></TD></TR></TABLE><BR></TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
- Copyright © 1999 The Apache Software Foundation.
- All Rights Reserved.
+<HTML><HEAD><SCRIPT language="JavaScript" src="resources/script.js" type="text/javascript"></SCRIPT><TITLE>Xalan-Java API</TITLE></HEAD><BODY alink="#ff0000" bgcolor="#ffffff" leftmargin="4" link="#0000ff" marginheight="4" marginwidth="4" text="#000000" topmargin="4" vlink="#0000aa"><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" height="60" rowspan="3" valign="top" width="135"><IMG border="0" height="60" hspace="0" src="resources/logo.gif" vspace="0" width="135"></TD><TD align="left" colspan="4" height="5" valign="top" width="456"><IMG border="0" height="5" hspace="0" src="resources/line.gif" vspace="0" width="456"></TD><TD align="left" height="60" rowspan="3" valign="top" width="29"><IMG border="0" height="60" hspace="0" src="resources/right.gif" vspace="0" width="29"></TD></TR><TR><TD align="left" bgcolor="#0086b2" colspan="4" height="35" valign="top" width="456"><IMG alt="" border="0" height="35" hspace="0" src="graphics/api-header.jpg" vspace="0" width="456"></TD></
TR><TR><TD align="left" height="20" valign="top" width="168"><IMG border="0" height="20" hspace="0" src="resources/bottom.gif" vspace="0" width="168"></TD><TD align="left" height="20" valign="top" width="96"><A href="http://xml.apache.org/" onMouseOut="rolloverOff('xml');" onMouseOver="rolloverOn('xml');" target="new"><IMG alt="http://xml.apache.org/" border="0" height="20" hspace="0" name="xml" onLoad="rolloverLoad('xml','resources/button-xml-hi.gif','resources/button-xml-lo.gif');" src="resources/button-xml-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://www.apache.org/" onMouseOut="rolloverOff('asf');" onMouseOver="rolloverOn('asf');" target="new"><IMG alt="http://www.apache.org/" border="0" height="20" hspace="0" name="asf" onLoad="rolloverLoad('asf','resources/button-asf-hi.gif','resources/button-asf-lo.gif');" src="resources/button-asf-lo.gif" vspace="0" width="96"></A></TD><TD align="left" height="20" valign="top" width="96"><A href="http://w
ww.w3.org/" onMouseOut="rolloverOff('w3c');" onMouseOver="rolloverOn('w3c');" target="new"><IMG alt="http://www.w3.org/" border="0" height="20" hspace="0" name="w3c" onLoad="rolloverLoad('w3c','resources/button-w3c-hi.gif','resources/button-w3c-lo.gif');" src="resources/button-w3c-lo.gif" vspace="0" width="96"></A></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD align="left" valign="top" width="120"><IMG border="0" height="14" hspace="0" src="resources/join.gif" vspace="0" width="120"><BR>
+<A href="../index.html" onMouseOut="rolloverOff('side-ext-2');" onMouseOver="rolloverOn('side-ext-2');"><IMG alt="Home" border="0" height="12" hspace="0" name="side-ext-2" onLoad="rolloverLoad('side-ext-2','graphics/ext-2-label-2.jpg','graphics/ext-2-label-3.jpg');" src="graphics/ext-2-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="overview.html" onMouseOut="rolloverOff('side-overview');" onMouseOver="rolloverOn('side-overview');"><IMG alt="Overview" border="0" height="12" hspace="0" name="side-overview" onLoad="rolloverLoad('side-overview','graphics/overview-label-2.jpg','graphics/overview-label-3.jpg');" src="graphics/overview-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="install.html" onMouseOut="rolloverOff('side-install');" onMouseOver="rolloverOn('side-install');"><IMG alt="Installation" border="0" height="12" hspace="0" name="side-install" onLoad="rolloverLoad('side-install','graphics/install-label-2.jpg','graphics/install-label-3.jpg');" src="graphics/install-label-3.jpg" vspace="0" width="120"></A><BR>
+
+<A href="readme.html" onMouseOut="rolloverOff('side-readme');" onMouseOver="rolloverOn('side-readme');"><IMG alt="Release Notes" border="0" height="12" hspace="0" name="side-readme" onLoad="rolloverLoad('side-readme','graphics/readme-label-2.jpg','graphics/readme-label-3.jpg');" src="graphics/readme-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+
+<A href="commandline.html" onMouseOut="rolloverOff('side-commandline');" onMouseOver="rolloverOn('side-commandline');"><IMG alt="Command Line" border="0" height="12" hspace="0" name="side-commandline" onLoad="rolloverLoad('side-commandline','graphics/commandline-label-2.jpg','graphics/commandline-label-3.jpg');" src="graphics/commandline-label-3.jpg" vspace="0" width="120"></A><BR>
+
+<IMG alt="Xalan API" border="0" height="12" hspace="0" src="graphics/api-label-1.jpg" vspace="0" width="120"><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="dtm.html" onMouseOut="rolloverOff('side-dtm');" onMouseOver="rolloverOn('side-dtm');"><IMG alt="Xalan DTM" border="0" height="12" hspace="0" name="side-dtm" onLoad="rolloverLoad('side-dtm','graphics/dtm-label-2.jpg','graphics/dtm-label-3.jpg');" src="graphics/dtm-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="6" hspace="0" src="resources/separator.gif" vspace="0" width="120"><BR>
+<A href="xslt4c.html" onMouseOut="rolloverOff('side-xslt4c');" onMouseOver="rolloverOn('side-xslt4c');"><IMG alt="Xalan C++" border="0" height="12" hspace="0" name="side-xslt4c" onLoad="rolloverLoad('side-xslt4c','graphics/xslt4c-label-2.jpg','graphics/xslt4c-label-3.jpg');" src="graphics/xslt4c-label-3.jpg" vspace="0" width="120"></A><BR>
+<IMG border="0" height="14" hspace="0" src="resources/close.gif" vspace="0" width="120"><BR></TD><TD align="left" valign="top" width="500"><TABLE border="0" cellpadding="3" cellspacing="0"><TR><TD><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" he
ight="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Introduction</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>This document provides an overview of the Xalan-Java API. For the details (javadoc), see
+ <A href="apidocs/index.html" target="_top">API Documentation</A>. For a general introduction to Xalan-Java, see
+ <A href="overview.xml.html">Overview: XSL Transformer for Java (Xalan)</A>. For specifics
+ concerning the current release, see <A href="readme.xml.html">Release Notes</A>.</P>
+
+ <P>Xalan-Java takes as primary input an XML source document and an XSL stylesheet. The XML document and the XSL stylesheet
+ may be a URL or file, a character stream, an input stream, or a DOM tree. The stylesheet may also take the form of a
+ compiled stylesheet. If the XML document contains a stylesheet Processing Instruction (PI), a separate stylesheet is not
+ required.</P>
+ <P>Xalan-Java uses an implementation of the <A href="apidocs/org/apache/xalan/xpath/xml/XMLParserLiaison.html" target="_top">XMLParserLiaison interface</A> to interact with Xerces-Java (or another
+ XML parsser) and sends output events to an extension of
+ <A href="http://www.megginson.com/SAX/sax.html" target="_top">SAX</A> <A href="http://www.megginson.com/SAX/javadoc/org.xml.sax.DocumentHandler.html#_top" target="_top">org.xml.sax.DocumentHandler</A>.</P>
+ <P>The XSLT and XPath engines are independent from any given DOM or XML implementation. All parser-dependent calls are
+ funneled through the XMLParserLiaison.</P>
+ </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Performing XSL Transformations</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" hei
ght="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>This release of Xalan-Java supports three mechanisms for transforming an xml document.</P>
+ <UL>
+ <LI>Calling the Xalan-Java processor from the command-line</LI>
+ <LI>Calling the Xalan-Java API from another java class</LI>
+ <LI>Using the Xalan-Java applet wrapper</LI>
+ </UL>
+ <P>For information about performing transformation from the command-line or a script, see <A href="CommandLineUtility" target="_top"></A>.</P>
+ <TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Calling the Xalan-Java API from a java class</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src=
"resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+ <P>In the java class where you want to perform an XSL transformation, do the following:</P>
+ <OL>
+ <LI>Call one of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessorFactory.html" target="_top">XSLTProcessorFactory class</A> static getProcessor() methods to
+ instantiate an implementation of the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A>.
+ <P>XSLTProcessorFactory uses XSLTEngineImpl, an implementation of the XSLTProcessor interface that you never need
+ to call directly.</P></LI>
+ <LI><P>Create <A href="apidocs/org/apache/xalan/xslt/XSLTInputSource.html" target="_top">XSLTInputSource class</A> objects for the XML source document and the XSL stylesheet,
+ and an <A href="apidocs/org/apache/xalan/xslt/XSLTResultTarget.html" target="_top">XSLTResultTarget class</A> object for the output.</P>
+ <P>If the XML document contains a stylesheet Processing Instruction (PI), you do not need to create a separate
+ XSLTInputSource object for an XSL stylesheet.</P></LI>
+ <LI><P>Call the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#process(org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTInputSource, org.apache.xalan.xslt.XSLTResultTarget)" target="_top">XSLTProcessor process() method</A>.</P></LI></OL>
+ <P>In your application, for example, you could include the following transform method(), then call this method with file
+ names or URLs for the source XML document, the XSL stylesheet and the new document to be produced.</P><DIV align="right"><TABLE border="0" cellpadding="0" cellspacing="4" width="464"><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#ffffff" width="462"><FONT size="-1"><PRE>
+public static void transform(String xmlSourceURL, String xslURL, String outputURL)
+ throws java.io.IOException,
+ java.net.MalformedURLException,
+ org.xml.sax.SAXException
+{
+ // Instantiate an XSLTProcessor.
+ org.apache.xalan.xslt.XSLTProcessor processor =
+ org.apache.xalan.xslt.XSLTProcessorFactory.getProcessor();
+
+ // Create the 3 objects the XSLTProcessor needs to perform the transformation.
+ org.apache.xalan.xslt.XSLTInputSource xmlSource =
+ new org.apache.xalan.xslt.XSLTInputSource (xmlSourceURL);
+ org.apache.xalan.xslt.XSLTInputSource xslSheet =
+ new org.apache.xalan.xslt.XSLTInputSource (xslURL);
+ org.apache.xalan.xslt.XSLTResultTarget xmlResult =
+ new org.apache.xalan.xslt.XSLTResultTarget (outputURL);
+
+ // Perform the transformation.
+ processor.process(xmlSource, xslSheet, xmlResult);
+ }</PRE></FONT></TD><TD bgcolor="#0086b2" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" height="1" width="462"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="462"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></DIV>
+ <P>The XSLTProcessor "compiles" the input XSL stylesheet into an internal representation,
+ the <A href="apidocs/org/apache/xalan/xslt/Stylesheet.html" target="_top">Stylesheet class</A>. You can compile the stylesheet separately,
+ before the transformation is complete, via the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#processStylesheet(java.lang.String)" target="_top">processStylesheet method</A>. This is
+ especially useful when you need to get information from the stylesheet before the tranformation occurs,
+ for instance, when you need to find out the output encoding in order to construct the right kind of Writer.</P>
+ <P>Stylesheet parameters can be set via the <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#setStylesheetParam(java.lang.String, java.lang.String)" target="_top">setStylesheetParam method</A>.
+ This method takes as input an <A href="apidocs/org/apache/xalan/xpath/XObject.html" target="_top">XObject class</A> or derivative. The
+ XObject class itself can hold any kind of Java object, if you need to pass it
+ to an extension. Each XObject type has a convenience function on the XSLTProcessor class to make it easy
+ to create:</P>
+ <UL>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XObject.html" target="_top">XObject class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXObject(java.lang.Object)" target="_top">createXObject method</A></LI>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XNodeSet.html" target="_top">XNodeSet class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNodeSet(org.w3c.dom.NodeList)" target="_top">createXNodeSet(NodeList nl) method</A> or
+ <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNodeSet(org.w3c.dom.Node)" target="_top">createXNodeSet(Node n) method</A></LI>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XBoolean.html" target="_top">XBoolean class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXBoolean(boolean)" target="_top">createXBoolean method</A></LI>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XNumber.html" target="_top">XNumber class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNumber(double)" target="_top">createXNumber method</A></LI>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XNull.html" target="_top">XNull class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXNull()" target="_top">createXNull method</A></LI>
+ <LI><A href="apidocs/org/apache/xalan/xpath/XString.html" target="_top">XString class</A>, <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html#createXString(java.lang.String)" target="_top">createXString method</A></LI>
+ </UL>
+ <P>Xalan-Java is thread-safe for one instance per thread. However,
+ if you reuse the processor instance, you should call reset() between calls.</P>
+ <P>The XPath engine has pluggable backend drivers called <A href="apidocs/org/apache/xalan/xpath/XLocator.html" target="_top">XLocator interface</A>s.
+ The default implementation of the XLocator is the <A href="apidocs/org/apache/xalan/xpath/SimpleNodeLocator.html" target="_top">SimpleNodeLocator class</A>.
+ Though users of the API can implement their own XLocators for custom data access,
+ it is not for the faint of heart.</P>
+</FONT></TD></TR></TABLE><BR>
+
+<TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="666699" colspan="2" width="484"><TABLE border="0" cellpadding="0" cellspacing="0" width="484"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="482"><FONT color="#ffffff" face="arial,helvetica,sanserif"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Using the Xalan-Java applet</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="482"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="482"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="474"><FONT color="#000000" face="arial,helvetica,sanserif" size="-1">
+<OL>
+<LI><P>Include <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html" target="_top">XSLTProcessorApplet class</A> in an HTML client.</P></LI>
+<LI><P>Specify the XML source document and XSL stylesheet.</P>
+<P>You can use the DocumentURL and StyleURL PARAM tags or the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setDocumentURL(java.lang.String)" target="_top">XSLTProcessorApplet setDocumentURL() method</A> and <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#setStyleURL(java.lang.String)" target="_top">XSLTProcessorApplet setStyleURL() method</A>. If the XML document contains a stylesheet Processing Instruction (PI), you do not need to specify an XSL stylesheet.</P></LI>
+<LI>Call the <A href="apidocs/org/apache/xalan/xslt/client/XSLTProcessorApplet.html#transformToHtml(java.lang.String, java.lang.String)" target="_top">XSLTProcessorApplet transformHTML() method</A> which performs the transformation and returns the new document as a String.</LI></OL>
+</FONT></TD></TR></TABLE><BR>
+<A name="debugger-interface"></A>
+</FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Debugger Interface</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace
="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>Xalan-Java contains a debugger interface in the org.apache.xalan.xslt.trace package. This
+ should be looked upon as a work in progress, possibly to be replaced by a more
+ standard interface in the future. The source code information given is
+ somewhat limited by what the SAX interface provides... the line and column numbers
+ at the *end* of the event. I'll have to work on obtaining the character selection
+ of the executing event. Also, at this time there is no source tree line information
+ available. Again, I'll be working on this. The interfaces are:</P>
+ <UL>
+ <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/TraceListener.html" target="_top">TraceListener class</A> is an interface that debuggers
+ can implement. The interface can be set on the
+ <A href="apidocs/org/apache/xalan/xslt/XSLTProcessor.html" target="_top">XSLTProcessor interface</A> by calling the addTraceListener() function.</P></LI>
+ <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/PrintTraceListener.html" target="_top">PrintTraceListener class</A> is an implementation of
+ the TraceListener interface that is used by Xalan-Java for the -TT, TG, and -TTC
+ switches. It's code is a good example to look at when figuring out how to
+ use the trace functionality.</P></LI>
+ <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/TracerEvent.html" target="_top">TracerEvent class</A> is an event that is
+ passed to the TraceListener.trace() function. It is called before a node is 'executed'
+ in the stylesheet.</P></LI>
+ <LI><P>The <A href="apidocs/org/apache/xalan/xpath/trace/GenerateEvent.html" target="_top">GenerateEvent class</A> is an event that is
+ passed to the TraceListener.generated() function. It is called after an event
+ occurs to create something in the result tree.</P></LI>
+ </UL>
+ </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Source Code</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>The source code is in the <A href="../src" target="_top">'xml-xalan/src' directory</A>.</P>
+ <P>The <A href="src/org/apache/xalan/xslt/XSLTEngineImpl.java" target="_top">XSLTEngineImpl class</A> class is where the main
+ stuff is going on. This is a big file, so I highly recommend using an IDE.</P>
+ <P> The XPaths are parsed in the
+ <A href="apidocs/org/apache/xalan/xpath/XPathProcessorImpl.html" target="_top">XPathProcessorImpl class</A>, the result XPath object is
+ performed in the <A href="apidocs/org/apache/xalan/xpath/XPath.html" target="_top">XPath class</A>, and the query and pattern
+ match is performed in the <A href="apidocs/org/apache/xalan/xpath/SimpleNodeLocator.html" target="_top">SimpleNodeLocator class</A>>.</P>
+ </FONT></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="666699" colspan="2" width="494"><TABLE border="0" cellpadding="0" cellspacing="0" width="494"><TR><TD bgcolor="#039acc" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#039acc" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#039acc" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#0086b2" width="492"><FONT color="#ffffff" face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="2" hspace="0" src="resources/void.gif" vspace="0" width="2"><B>Glossary</B></FONT></TD><TD bgcolor="#017299" width="1"><IMG border="0" height="1" hspace="0" src
="resources/void.gif" vspace="0" width="1"></TD></TR><TR><TD bgcolor="#0086b2" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD><TD bgcolor="#017299" height="1" width="492"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="492"></TD><TD bgcolor="#017299" height="1" width="1"><IMG border="0" height="1" hspace="0" src="resources/void.gif" vspace="0" width="1"></TD></TR></TABLE></TD></TR><TR><TD width="10"> </TD><TD width="484"><FONT color="#000000" face="arial,helvetica,sanserif">
+ <DL>
+ <DT>XSL Instruction</DT>
+ <DD>Any tag with an XSL namespace prefix.<P></P></DD>
+
+ <DT>XSL Template Instruction</DT>
+ <DD>Any tag with an XSL namespace prefix
+ that occurs inside an xsl:template element.<P></P></DD>
+
+ <DT>Template Child</DT>
+ <DD>Any node that is a child of an xsl:template element.<P></P></DD>
+
+ <DT>Source Tree</DT>
+ <DD>The tree input to the XSL process.<P></P></DD>
+
+ <DT>Result Tree</DT>
+ <DD>The tree that is output by the XSL process.<P></P></DD>
+
+ <DT>Stylesheet Tree</DT>
+ <DD>The stylesheet tree produced from the XSL file.<P></P></DD>
+
+ <DT>Pattern List</DT>
+ <DD>A parsed query or match pattern.<P></P></DD>
+ </DL>
+ </FONT></TD></TR></TABLE><BR></TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0" cellspacing="0" width="620"><TR><TD bgcolor="#0086b2"><IMG height="1" src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT color="#0086b2" size="-1"><I>
+ Copyright © 1999 The Apache Software Foundation.
+ All Rights Reserved.
</I></FONT></TD></TR></TABLE></BODY></HTML>
|