1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
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
|
