JAR files included in the product

The full list of JAR files in the SaxonJ distribution is as follows. Here "11.#" means "11.0", "11.1", "11.2", etc. depending on the maintenance release.

JAR file

Size (approx)

Contents

Included in Editions

saxon-he-11.#.jar

5.4Mb

SaxonJ Home Edition. Contains all the software in SaxonJ-HE, except as noted below.

HE

saxon-pe-11.#.jar

6Mb

SaxonJ Professional Edition. Contains all the software in SaxonJ-PE, except as noted below.

PE

saxon-ee-11.#.jar

8.3Mb

SaxonJ Enterprise Edition. Contains all the software in SaxonJ-EE, except as noted below.

EE

icu4j-59_1.jar

11.9Mb

A copy of the open source ICU-J localization library, used to support sorting and date/number formatting in a wide variety of languages. If this JAR file is not present on the classpath, this will restrict the collations and localization options available to those that are found in the Java runtime.

It should be possible to replace this JAR with a later version downloaded from the ICU project.

(Previous SaxonJ releases used a tailored version of this JAR file. With experience, we found that this added complexity and delivered no tangible benefits.)

PE, EE

saxon-xqj-11.#.jar

100Kb

Support for the XQJ (XQuery for Java) API. Provided as a separate JAR file in Saxon-HE so that it can be excluded from distributions that require pure OSI-approved open source licensing. The code is included as an integral part of SaxonJ-PE and SaxonJ-EE, so no separate JAR file is required in those cases.

HE

saxon-sql-11.#.jar

61Kb

Supports XSLT and XPath extensions for accessing and updating a relational database from within a stylesheet or query. Provided with SaxonJ-PE and SaxonJ-EE. The source code is open source so that it can be modified, but it requires support for element extensibility, which requires SaxonJ-PE or higher.

PE, EE

saxon-he-test-11.#.jar

127Kb

Test drivers for running the W3C test suites for XSLT and XQuery against SaxonJ-HE. The test drivers are published as open source code in the saxon-resources download. The test suites themselves are on GitHub: repositories w3c/xslt30-test and w3c/qt3tests.

HE

saxon-pe-test-11.#.jar

176Kb

Test drivers for running the W3C test suites for XSLT and XQuery against SaxonJ-PE. The test suites themselves are on GitHub: repositories w3c/xslt30-test and w3c/qt3tests.

PE

saxon-ee-test-11.#.jar

215Kb

Test drivers for running the W3C test suites for XSLT, XQuery, and XSD against SaxonJ-EE. The test suites themselves are on GitHub: repositories w3c/xslt30-test, w3c/qt3tests, w3c/xsdtests.

EE

jline-2.14.6.jar

205Kb

JLine 2: an open source library supporting interactive command-line applications, including content completion and command history. This is used by the Gizmo utility, and must be on the classpath when Gizmo is run (it is not needed otherwise).

HE, PE, EE

When running any Java application, SaxonJ included, all Java classes that are needed must be present on the CLASSPATH. The classpath can be set in the form of an environment variable, or it can be included in the java command that invokes the application.

The classpath is written as a list of filenames. These will either be the names of directories (folders) that contain relevant classes, or the names of JAR files containing the classes. On Windows, the names in the list are separated by semicolons; on Linux and macOS, a colon is used.

The table above lists the JAR files provided with SaxonJ that you may need to include on your classpath. In addition, you may need to include the following resource:

Resource

Description

saxon-license.lic

License file. This is needed only for running SaxonJ-EE/SaxonJ-PE. The license file is obtained when you purchase the product or when you apply for an evaluation license. If the license file is placed in the same directory as the saxon-pe-11.#.jar or saxon-ee-11.#.jar JAR file, then SaxonJ will usually be able to find it without further assistance; in some class-loading environments, however, the directory containing the license file (not the license file itself) needs to be listed on the classpath.

Verifying the Saxon JAR files

Before releasing new versions of the SaxonJ JAR files, Saxonica signs them with a digital signature which you can use to verify that the files have not been tampered with. The signatures are based on a digital certificate issued to Saxonica by the security company GlobalSign.

You can verify that a particular JAR file (for example saxon-ee-11.0.jar) has a valid signature using the command:

jarsigner -verify saxon-ee-11.0.jar

More usefully, you can check that it was signed by Saxonica with the command:

jarsigner -verify -verbose saxon-ee-11.0.jar

This produces voluminous information about the contents of the JAR file, ending with details of the security certificate, something like this:

- Signed by "EMAILADDRESS=mike@saxonica.com, CN=Saxonica Limited, O=Saxonica Limited, L=Reading, ST=Berkshire, C=GB" Digest algorithm: SHA-256 Signature algorithm: SHA256withRSA, 2048-bit key Timestamped by "CN=GlobalSign TSA for Advanced - G3 - 003-01, O=GMO GlobalSign K.K., C=JP" on Thu Sep 27 16:58:22 UTC 2018 Timestamp digest algorithm: SHA-256 Timestamp signature algorithm: SHA256withRSA, 2048-bit key

The details will vary from release to release, but will always identify Saxonica as the originator, and give the date on which the JAR file was built prior to release.

Saxonica signs both the open-source and commercial JAR files. The signature does not prevent the JAR file being unpacked and modified, but it means that you can always distinguish a modified JAR file from the original.