SAXONICA

Saxon Documentation
Full Contents
About Saxon
| Introduction
| Getting Started
| What is Saxon?
» | Prerequisites
| Product Packages
| Installation
| Historical Note
| Technical Support
Changes in this Release
Conditions of Use
Using XSLT 2.0
Using XQuery
Handling Source Documents
XML Schema Processing
The XPath API
Standards Conformance
Extensibility
Saxon Extensions
Sample Saxon Applications
The Saxon SQL Extension
XSLT Elements
XPath 2.0 Expression Syntax
Function Library
XSLT Patterns

# Prerequisites

The following software must be installed separately, it is not included with the Saxon download.

- To run Saxon you need at least a Java VM, and preferably a Java development environment. Saxon 8.x will run with either JDK 1.4 (properly the Java 2 platform, Standard Edition, v1.4) or JDK 1.5 (properly Java 2 Platform, Standard Edition 5.0).

- Saxon will no longer work with the Microsoft Java VM.

- Saxon implements APIs defined in JAXP 1.3 (JAXP is the Java API for XML Processing). JAXP 1.3 is a standard component in JDK 1.5, but if you are using JDK 1.4, it must be installed separately. For licensing reasons the JAXP package is not included in the Saxon distribution; instead you must download it separately from https://jaxp.dev.java.net/. This download includes two JAR files, `jaxp-api.jar` and `dom.jar`, which must be present on the classpath when running Saxon. Note that this means you cannot invoke Saxon using the `-jar` option, since this requires all files to be present in a single JAR archive, and ignores the CLASSPATH setting.

  Most XSLT and XQuery functionality in Saxon will work without installing JAXP 1.3. You need to install it if you are using DOM interfaces; if you are using the XPath API; or if you are using the schema validation API (applies to Saxon-SA only).

  It is likely that at some time in the future, Saxon will require J2SE 5.0

- Saxon has an option to work with a source tree constructed using JDOM. Saxon 8.6 is validated with JDOM 1.0; it probably also works with other recent releases. To use Saxon with JDOM, you need to add `saxon8-jdom.jar` to your CLASSPATH.

- Saxon now also has an option to work with a source tree constructed using XOM. Saxon 8.6 is tested with XOM 1.0b7. To use Saxon with XOM, you need to add `saxon8-xom.jar` to your CLASSPATH.

Saxon has been tested successfully in the past with a wide variety of XML parsers including Xerces, Lark, SUN Project X, Crimson, Piccolo, Oracle XML, xerces, xml4j, and xp. Use of a SAX2-compliant parser is now mandatory. All the relevant classes must be installed on your Java CLASSPATH.

Earlier releases of Saxon included a version of the Ælfred XML parser. This is no longer bundled with the Saxon distribution, because JDK 1.4 now includes an XML parser as standard, but the Ælfred XML parser remains available as a separate download from the Saxon site at SourceForge.

Saxon's DOM interface has been tested with the Crimson parser included as standard in Sun's JDK 1.4 platform and with the Xerces 2.5.0 DOM implementation.

Because Saxon is run from the command line, you might find it useful (under Microsoft Windows) to have a text editor with better command-line support than the standard DOS window. I use jEdit, which is an open source product with a wide-selection of optional plug-ins, including one for editing XQuery.

Next