A brand new Java API is available in package
net.sf.saxon.s9api (pronounced "snappy", stands for Saxon 9 API).
This is closely modelled on the successful .NET API. The design aims were to:
- Provide an API that is well documented and uncluttered by implementation detail
- Provide uniformity across XSLT, XPath, and XQuery (for example, allowing XSLT and XQuery to be combined naturally in a single pipeline)
- Maximise the ability to create compiled objects that are reusable across multiple threads
- Reuse existing JAXP classes and interfaces where appropriate, but abandon them when they no longer deliver the right functionality
- Provide an accurate representation of the XDM data model
- Provide access to all mainstream Saxon functionality needed by typical users
- Provide escape hatches to underlying implementation classes and methods for power users
- Exploit new Java 5 features such as type-safe enumerations, generics, and iterables, while retaining support for JDK 1.4 users
The new API does not replace any existing APIs: it is a separate layer on top of the Saxon product. It is provided in a separate JAR file, saxon9-api.jar, and can be used only with Java 5. The main Saxon jar files, however, continue to work with JDK 1.4.
For details see the Javadoc: go to package
net.sf.saxon.s9api and start with the
Saxon will continue to support standardized interfaces such as JAXP and XQJ. However, JAXP has become cluttered and inconsistent, and is still missing support for many XSLT 2.0 features. XQJ has been designed with a client-server architecture in mind, and while it is usable with Saxon, it is not really optimized for the kind of applications where Saxon is deployed. For users who want to exploit Saxon fully in their applications, rather than retaining portability across XSLT/XPath/XQuery implementations, the new API offers a much cleaner choice.