SAXONICA

Saxon Documentation
Full Contents
About Saxon
| Introduction
| Getting Started
| What is Saxon?
| Choosing a software package
» | Installation: Java platform
| Installation: .NET platform
| Historical Note
| Technical Support
| Related Products
Changes in this Release
Conditions of Use
Using XSLT 2.0
Using XQuery
Handling Source Documents
XML Schema Processing
The XPath API
Saxon on .NET
Extensibility
Saxon Extensions
Sample Saxon Applications
The Saxon SQL Extension
XSLT Elements
XPath 2.0 Expression Syntax
Function Library
Standards Conformance

# 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 the Java 2 Platform, Standard Edition 5.0).

- 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).

  - Saxon has an option to work with a source tree constructed using JDOM. Saxon is validated with JDOM 1.0, which has been stable since September 2004; it should not be used with earlier JDOM releases. To use Saxon with JDOM, you need to add `jdom.jar` and `saxon8-jdom.jar` to your CLASSPATH.

  - Saxon also has an option to work with a source tree constructed using XOM. Saxon 8.7 is tested with XOM 1.1, though it will probably still work with other recent releases. To use Saxon with XOM, you need to add `xom-1.1.jar` and `saxon8-xom.jar` to your CLASSPATH.

Saxon has been tested successfully in the past with a wide variety of XML parsers including Ælfred, Xerces, Lark, SUN Project X, Crimson, Piccolo, Oracle XML, xerces, xml4j, and xp. By default, however, it uses the parser that comes with the Java platform (this is Crimson in the case of JDK 1.4, Xerces in the case of JDK 1.5). The parser must be SAX2-compliant. All the relevant JAR files must be installed on your Java CLASSPATH.

Earlier releases of Saxon included a version of the Ælfred XML parser. This version is no longer bundled with the Saxon distribution on Java platforms, because JDK 1.4 now includes an XML parser as standard. However the Saxon version of the Ælfred XML parser remains available as a separate download from the Saxon site at SourceForge. (Note that this version is not identical to the one that is included in GNU Classpath, which now forms part of the Saxon distribution on the .NET platform).

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 DOM implementation included in JDK 1.5. It has also been used successfully with other DOM implementations such as Oracle's, though it is not routinely tested in this environment.

Next