jd.xslt - Command-Line

This is a description of all command-line arguments and options to jd.xslt.

Synopsis: java jd.xml.xslt.Stylesheet [options] xmluri [xsluris...]

xmluri is the URI of a XML document.

xsluris... are zero or more URIs of stylesheet documents. If their number is
= 0: use the associated stylesheets of the XML document
= 1: transform the input with that stylesheet
> 1: chain the stylesheets using the output of a transformation as input to next one
The pseudo-URI {identity} denotes the identity transformation¹.

Possible URIs are relative or absolute file names (like a.xml, c:\a.xsl) or absolute URLs (like http://myhost.com/a.xml).
The valid options are:

-entityresolver <class> Set a SAX EntityRresolver: class is the name of a class that implements the interface org.xml.sax.EntityResolver.

-errorstack In case of an error the transformation aborts and displays a diagnostic error message. If this option is switched on, then the stack trace of the error is also shown.

-media media Filter associated stylesheets by their media attribute.

-out file Write the transformation output to the file. It will overwrite the file if it already exists. If the file name contains a nonexistent directory, then the directory is automatically created. If the -out option is not set, the output is written to the console.

-out:method method Set the output method. This option overrides the output method specified by the stylesheet. The possible values are xml, html, text and the non standard output method canonical-xml to produce a XML document in canonical form.

-param name expr Set the value of a top-level parameter with the given name. expr is a XPath expression which can be evaluated without an expression context. Multiple -param options are possible.
Example: -param n 1 -param b true() -param s 'abc'
will set the top-level parameter named n to the number value 1, the parameter b to the boolean value true and the parameter s to the string value 'abc'.

-parser class Set the SAX parser which is used to parse XML and XSL documents. class is the name of a class that implements the interface org.xml.sax.XMLReader or org.xml.sax.Parser.
jd.xslt automatically instantiates a default parser if this option is not set.
The class names of some popular parser are listed on the parser page.

-parserxml class Set the SAX parser which is used to parse xml documents.

-parserxsl class Set the SAX parser which is used to parse stylesheet documents.

-proxy url Use a proxy host when accessing documents which are referenced by a URL.
url is the url of the proxy, consisting of protocol, host name and port (for instance http://myproxy:8080). When the protocol is not specified then it defaults to http. When the port is not specified it defaults to the protocol-dependent default port.

-repeat number Execute the transformation n times. Use this option in combination with -verbose to gather more accurate timing information, since JIT compilers need some time to gain full performance.

-security class Set a XsltSecurityManager: class is the name of a class that implements the interface jd.xml.xslt.XsltSecurityManager.

-title title Filter associated stylesheets by their title attribute.

-uriresolver class Set an uriresolver, which is used to resolve URIs to a XML document: class is the name of a class that implements the interface jd.xml.util.UriResolver or javax.xml.transform.URIResolver.

-validate Validate XML documents.

-verbose Turn on verbose mode to display transformation and performance info.

-w0 Recover silently from recoverable errors ².

-w1 Report recoverable errors and continue (default).

-w2 Treat recoverable errors as fatal.

^[1] The identity transformation can be used to create a document version with proper indentation or a document in canonical XML form:
java jd.xml.xslt.Stylesheet -out:method canonical-xml test.xml {identity}

^[2] Currently these recoverable errors are handled by the -wxoptions:

If there is an error when evaluation a call to the document()-function, then the processor may recover by returning an empty node-set.
If the content of a xsl:processing-instruction contains the string ?>, then the processor may recover by inserting a space after any occurrence of ? that is followed by a >.
If the content of a xsl:comment contains the string -- or ends with -, thenthe processor may recover by by inserting a space after any occurrence of - that is followed by another - or that ends the comment.

main page

`xmluri`	is the URI of a XML document.
`xsluris...`	are zero or more URIs of stylesheet documents. If their number is = 0: use the associated stylesheets of the XML document = 1: transform the input with that stylesheet > 1: chain the stylesheets using the output of a transformation as input to next one The pseudo-URI `{identity}` denotes the identity transformation¹.
Possible URIs are relative or absolute file names (like `a.xml`, `c:\a.xsl`) or absolute URLs (like `http://myhost.com/a.xml`). The valid options are:
`-entityresolver <class>`	Set a SAX EntityRresolver: `class` is the name of a class that implements the interface `org.xml.sax.EntityResolver`.
`-errorstack`	In case of an error the transformation aborts and displays a diagnostic error message. If this option is switched on, then the stack trace of the error is also shown.
`-media media`	Filter associated stylesheets by their media attribute.
`-out file`	Write the transformation output to the file. It will overwrite the file if it already exists. If the file name contains a nonexistent directory, then the directory is automatically created. If the `-out` option is not set, the output is written to the console.
`-out:method method`	Set the output method. This option overrides the output method specified by the stylesheet. The possible values are `xml`, `html`, `text` and the non standard output method `canonical-xml` to produce a XML document in canonical form.
`-param name expr`	Set the value of a top-level parameter with the given name. `expr` is a XPath expression which can be evaluated without an expression context. Multiple `-param` options are possible. Example: `-param n 1 -param b true() -param s 'abc'` will set the top-level parameter named n to the number value `1`, the parameter b to the boolean value `true` and the parameter s to the string value `'abc'`.
`-parser class`	Set the SAX parser which is used to parse XML and XSL documents. `class` is the name of a class that implements the interface `org.xml.sax.XMLReader` or `org.xml.sax.Parser`. jd.xslt automatically instantiates a default parser if this option is not set. The class names of some popular parser are listed on the parser page.
`-parserxml class`	Set the SAX parser which is used to parse xml documents.
`-parserxsl class`	Set the SAX parser which is used to parse stylesheet documents.
`-proxy url`	Use a proxy host when accessing documents which are referenced by a URL. `url` is the url of the proxy, consisting of protocol, host name and port (for instance `http://myproxy:8080`). When the protocol is not specified then it defaults to `http`. When the port is not specified it defaults to the protocol-dependent default port.
`-repeat number`	Execute the transformation n times. Use this option in combination with `-verbose` to gather more accurate timing information, since JIT compilers need some time to gain full performance.
`-security class`	Set a XsltSecurityManager: `class` is the name of a class that implements the interface `jd.xml.xslt.XsltSecurityManager`.
`-title title`	Filter associated stylesheets by their title attribute.
`-uriresolver class`	Set an uriresolver, which is used to resolve URIs to a XML document: `class` is the name of a class that implements the interface `jd.xml.util.UriResolver` or `javax.xml.transform.URIResolver`.
`-validate`	Validate XML documents.
`-verbose`	Turn on verbose mode to display transformation and performance info.
`-w0`	Recover silently from recoverable errors ².
`-w1`	Report recoverable errors and continue (default).
`-w2`	Treat recoverable errors as fatal.

^[1]	The identity transformation can be used to create a document version with proper indentation or a document in canonical XML form: `java jd.xml.xslt.Stylesheet -out:method canonical-xml test.xml {identity}`
^[2]	Currently these recoverable errors are handled by the `-wx`options:
	If there is an error when evaluation a call to the `document()`-function, then the processor may recover by returning an empty node-set. If the content of a `xsl:processing-instruction` contains the string `?>`, then the processor may recover by inserting a space after any occurrence of `?` that is followed by a `>`. If the content of a `xsl:comment` contains the string `--` or ends with `-`, thenthe processor may recover by by inserting a space after any occurrence of `-` that is followed by another `-` or that ends the comment.