| NAME |
| xslt - optional command wrapper for Apache/Xalan XSLTC runtime processor. |
| |
| SYNOPSIS |
| xslt [-j <jarfile>] [-xhs] |
| {-u <document_url> | <document>} <class> |
| [<name1>=<value1> ...] |
| |
| |
| DESCRIPTION |
| This command-line tool is a wrapper for the Java class |
| org.apache.xalan.xsltc.cmdline.Transform. See CODE section |
| below. |
| |
| The Sun XSLT runtime processor is a Java-based tool for |
| transforming XML document files using a translet (compiled |
| stylesheet). |
| |
| The XSLT processor can be run on any platform including UNIX, |
| Windows, NT, Mac that supports Java. |
| |
| OPTIONS |
| |
| The following options are supported: |
| |
| -j <jarfile> |
| gets the translet <class> from the specified <jarfile> |
| instead of from the user's CLASSPATH. |
| |
| -u |
| Specifies that the XML <document> location will be a URI |
| such as 'http://myserver/hamlet.xml'. |
| |
| -x |
| Turn debugging messages on. |
| |
| -h |
| Output help screen. |
| |
| -s |
| Prevent the command line tool from calling System.exit() |
| |
| OPERANDS |
| |
| The following operands are supported: |
| |
| <document> An XML document to be processed. |
| <document_url> An XML document to be processed, specified |
| as a URL (See -u option above). |
| |
| <class> The translet that will do the processing. |
| The translet may optionally take a set of |
| global parameters specified as name-value |
| pairs. A name-value pair uses the format |
| <name>=<value>. |
| |
| CODE |
| Here is an example script to implement this command. You will have |
| to define INSTALLDIR to be the directory where you install XalanJ. |
| |
| #!/bin/sh |
| # apxslt - Apache XSLT run script. |
| # |
| # if a -j <jarfile> option is set, find it and save off the <jarfile> |
| # argument. |
| # |
| jOptionSeen="0"; |
| jarfile=""; |
| for arg in $* |
| do |
| if [ $arg = "-j" ] ; then |
| jOptionSeen="1"; |
| elif [ $jOptionSeen = "1" ] ; then |
| jarfile=$arg |
| jOptionSeen="0"; |
| fi |
| done |
| |
| # |
| XSLTC=${INSTALLDIR}/java/lib/xsltc.jar |
| XERCES=${INSTALLDIR}/java/lib/xercesImpl.jar |
| XML=${INSTALLDIR}/java/lib/xml-apis.jar |
| CLASSPATH=.:${XSLTC}:${XERCES}:${XML}:$jarfile |
| |
| java -cp ${CLASSPATH} org.apache.xalan.xsltc.cmdline.Transform "$@" |
| |
| |
| EXAMPLES |
| Example 1: Processing an XML document. |
| |
| example% xslt hamlet.xml hamlet |
| |
| where the current working directory contains an XML document |
| 'hamlet.xml' to be processed by the translet class 'hamlet'. |
| The translet would have been created initially using |
| xsltc to compile a XSLT stylesheet named 'hamlet.xsl'. |
| |
| Example 2: Loading translet from a jar file. |
| |
| example% xslt -j hamlet.jar hamlet.xml hamlet |
| |
| In this case the translet class 'hamlet' is loaded from the |
| specified jar file, 'hamlet.jar' instead of from the user's |
| CLASSPATH. |
| |
| Example 3: If the translet defined global parameters, then |
| these can be passed on the command line to the runtime processor |
| as a space separated list of name-value pairs using the format |
| <name>=<value>. For example, |
| |
| example% xslt hamlet.xml hamlet speaker=HAMLET 'scene=SCENE IV' |
| |
| Notice that the second name-value pair had to be quoted due to |
| the intervening space in the value "SCENE IV". |
| |
| example% xslt -u http://zarya.east/test.xml hamlet |
| |
| where the xml document 'test.xml' can be specified as a URL. |
| |
| FILES |
| file.xml input XML document to be processed. |
| file.class byte code file. |
| file.jar java archive file. |
| |
| SEE ALSO |
| xsltc, jar. |
| |
| BUGS |
| See the Apache JIRA issue tracker: http://issues.apache.org/jira |
| |
| AUTHORS |
| Morten Jorgensen morten.jorgensen@ireland.sun.com |
| G. Todd Miller todd.miller@east.sun.com |
| Jacek Ambroziak |
| Santiago Pericas-Geertsen |