Saxon Documentation

About Saxon

• Introduction
• Getting Started
  • Getting started with Saxon on the Java platform
  • Getting started with Saxon on the .NET platform
• What is Saxon?
• Choosing a software package
• Installation: Java platform
  • Prerequisites
  • Obtaining a license key
  • Troubleshooting license key problems
  • Installing the software
  • JAR files included in the product
• Installation: .NET platform
  • Prerequisites: .NET platform
  • Installing the software
  • Obtaining a license key
  • Sample applications
• Historical Note
• Technical Support
  • Lists and forums for getting help
  • Bugs and patches
• Related Products

Changes in this Release

• Version 8.9 (2007-02-12)
  • XQuery Java Code Generation
  • XInclude support
  • Optimization
  • XSLT changes
  • XQuery changes
  • JAXP and other Java API changes
  • API Changes on .NET
  • Schema Processing
  • Functions and Operators
  • DOM and XOM interfaces
  • Ant Integration
  • Internal Changes
• Version 8.8 (2006-09-05)
  • XSLT Changes
  • Changes to XQuery API
  • SQL sample extension
  • Functions and Operators
  • .NET platform
  • Extensions
  • Streaming Enhancements
  • Miscellaneous
  • Performance improvements
• Version 8.7.3 (2006-06-13)
  • Changes on the .NET platform
• Version 8.7.2 (2006-04-19)
• Version 8.7.1 (2006-04-13)
• Version 8.7 (2006-02-24)
  • Saxon on .NET platform
  • Pull parser support
  • XSLT changes
  • XQuery changes
  • Schema processing changes
  • XPath changes
  • Java API changes
  • Internal Changes
• Version 8.6.1 (24 November 2005)
• Version 8.6 (3 November 2005)
  • Building source documents
  • XSLT changes
  • Functions, Operators, and Data Types
  • Schema Processing
  • XQuery changes
  • JAXP API changes
  • Serialization
  • XML 1.1 support
  • Internal changes
• Version 8.5.1 (26 August 2005)
  • XQuery changes
  • XSLT changes
  • JAXP API
  • Functions and Operators
  • Serializer changes
  • Extensions
  • Internal changes
• Version 8.5 (2 August 2005)
  • XQuery changes
  • XSLT changes
  • Data Model Changes
  • Serialization Changes
  • XPath Changes
  • Changes in Functions, Operators, and Data Types
  • Binary XML: the PTree file
  • Changes to Saxon Extensions
  • Java API Changes
  • Serial Processing for Large Documents
  • Changes to Schema Processing
  • Changes to Schema-Aware XSLT and XQuery Processing
  • Internal Changes
• Version 8.4 (4 April 2005)
  • XQuery changes
  • XSLT changes
  • XPath changes
  • Changes in Schema-aware Processing
  • Java API changes
  • Internal Changes
  • Functions, Operators and Data Types
  • Extensions
  • Pull Processing
• Version 8.3 (11 February 2005)
  • DOM Level 3 support
  • JAXP 1.3 support: the XPath API
  • Schema processing changes
  • XPath 2.0 Changes
  • XSLT 2.0 Changes
  • XQuery 1.0 Changes
  • Changes to Functions and Operators
  • Changes in Serialization
  • New and Changed Extension Functions
  • Internal Changes
  • Pull Processing
• Version 8.2 (21 December 2004)
  • JAXP 1.3 support
  • Support for XOM Object Model
  • Changes to XSLT 2.0 support
  • Changes to XQuery 1.0 support
  • Changes to Serialization
  • Changes to external Java bindings
  • Changes to Schema Processing
  • Changes in XPath 2.0 Processing
  • Changes to Functions and Operators
  • Changes to Saxon Extensions
  • Changes to Data Model
  • Internal Changes
• Version 8.1.1 (8 October 2004)
  • Defects cleared
  • Changes in XML Schema support
  • JAXP Application Programming Interface
  • Changes in Functions and Operators
• Version 8.1 (24 September 2004)
  • Differences between Saxon-SA and Saxon-B
  • Defects Cleared
  • XSLT changes
  • Changes to XQuery
  • Changes to the XQuery Java API
  • Changes to Schema-Aware XSLT and XQuery Processing
  • Changes to Schema Processing
  • Changes to Functions and Operators
  • Changes to Extension Functions
  • Internal Changes
  • Changes to Extension Function Calling Mechanism
  • Changes to Serialization
• Version 8.0 (1 June 2004)
  • Defects cleared in Version 8.0
  • XSLT changes
  • XPath changes (also affecting XQuery)
  • XQuery changes
  • Functions and Operators
  • Schema processing
  • XPath API changes
  • Changes to extension functions
  • Changes to internal APIs
  • Implementation changes
  • Running Saxon as an Applet

Conditions of Use

• Introduction
• Other components

Using XSLT 2.0

• Using XSLT 2.0 Stylesheets
• Running XSLT from the Command Line
• Compiling a Stylesheet
• Running Saxon XSLT transformations from Ant
• Invoking XSLT from an application
• Performance Analysis

Using XQuery

• Introduction
• Running XQuery from the Command Line
• Invoking XQuery using the XQJ API
• Invoking XQuery from an application
• Calling XQuery Functions from Java
• Result Format
• Compiling Queries to Java code
  • Java Code Generation from the Command Line
  • Running Compiled Code from the Command Line
  • Running a Compiled Query as a Servlet
  • Calling Compiled Queries from an Application
• Extensibility
• Extensions
• Use Cases

Handling Source Documents

• Handling Source Documents
• Source Documents on the Command Line
• Collections
• Building a Source Document from an application
• Writing input filters
• XInclude processing
• Saxon and XML 1.1
• JAXP Source Types
• Third-party Object Models: DOM, JDOM, XOM, and DOM4J
• Choosing a Tree Model
• The PTree File Format
• Validation of Source Documents
• Whitespace Stripping in Source Documents
• Streaming of Large Documents

XML Schema Processing

• Introduction
• Running Validation from the Command Line
• Controlling Validation from Java
• Schema-Aware XSLT from the Command Line
• Schema-Aware XSLT from Java
• Schema-Aware XQuery from the Command Line
• Schema-Aware XQuery from Java

XPath API for Java

• Introduction
• The JAXP XPath API
  • Selecting the XPath implementation
  • Context node
  • Return types
  • Additional Saxon methods
• The Standalone XPath API
• The NodeInfo Object
• Building the Source Document

Saxon on .NET

• Introduction
• Saxon API for .NET
• XML Parsing in .NET

Extensibility

• Introduction
• Writing extension functions in Java
  • Calling Static Methods in a Java Class
  • Calling Java Constructors
  • Calling Java Instance-Level Methods
• Converting Arguments to Java Extension Functions
  • Converting Atomic Values and Sequences
  • Converting Nodes and Sequences of Nodes
  • Converting Wrapped Java Objects
• Converting the Result of a Java Extension Function
• Writing extension functions for .NET
  • Calling Static Methods in a .NET Class
  • Calling .NET Constructors
  • Calling .NET Instance-Level Methods
• Converting Arguments to .NET Extension Functions
  • Converting Atomic Values and Sequences
  • Converting Nodes and Sequences of Nodes
  • Converting Wrapped .NET Objects
• Converting the Result of a .NET Extension Function
• Writing XSLT extension instructions
• Customizing Serialization
• Implementing a collating sequence
• Localizing numbers and dates
• Adding an output encoding
• Writing a URI Resolver for Input Files
• Writing a URI Resolver for Output Files

Saxon Extensions

• Introduction
• EXSLT Extensions
• Extension attributes (XSLT only)
  • saxon:allow-all-built-in-types
  • saxon:assignable
  • saxon:explain
  • saxon:memo-function
  • saxon:read-once
• Additional serialization parameters
  • The method attribute
  • The saxon:indent-spaces attribute
  • The saxon:character-representation attribute
  • The saxon:next-in-chain attribute
  • The saxon:require-well-formed attribute
  • The saxon:supply-source-locator attribute
  • User defined serialization attributes
• Extension functions
  • saxon:analyze-string()
  • saxon:base64Binary-to-octets()
  • saxon:base64Binary-to-string()
  • saxon:call()
  • saxon:compile-stylesheet()
  • saxon:decimal-divide()
  • saxon:deep-equal()
  • saxon:discard-document()
  • saxon:eval()
  • saxon:evaluate()
  • saxon:evaluate-node()
  • saxon:expression()
  • saxon:find()
  • saxon:for-each-group()
  • saxon:format-dateTime()
  • saxon:format-number()
  • saxon:function()
  • saxon:generate-id()
  • saxon:get-pseudo-attribute()
  • saxon:has-same-nodes()
  • saxon:hexBinary-to-octets()
  • saxon:hexBinary-to-string()
  • saxon:highest()
  • saxon:index()
  • saxon:leading()
  • saxon:line-number(node)
  • saxon:lowest()
  • saxon:namespace-node()
  • saxon:octets-to-base64Binary()
  • saxon:octets-to-hexBinary()
  • saxon:parse()
  • saxon:path()
  • saxon:serialize()
  • saxon:sort()
  • saxon:string-to-base64Binary()
  • saxon:string-to-hexBinary()
  • saxon:string-to-utf8()
  • saxon:system-id()
  • saxon:transform()
  • saxon:try()
  • saxon:type-annotation()
• Extension instructions
  • saxon:assign
  • saxon:call-template
  • saxon:collation
  • saxon:doctype
  • saxon:import-query
  • saxon:entity-ref
  • saxon:script
  • saxon:while

Sample Saxon Applications

• Introduction
• Knight's Tour
• JAXP Transformation Examples
• SaxonServlet
• The Book List Stylesheet
• Shakespeare Example
• The Bible
• JDOM Example
• Example applications for .NET

The Saxon SQL Extension

• Introduction
• sql:connect
• sql:query
• sql:insert and sql:column
• sql:update and sql:column
• sql:delete
• sql:close
• Example
• A Warning about Side-Effects

XSLT Elements

• Introduction
• xsl:analyze-string
• xsl:apply-imports
• xsl:apply-templates
• xsl:attribute
• xsl:attribute-set
• xsl:call-template
• xsl:character-map
• xsl:choose
• xsl:comment
• xsl:copy
• xsl:copy-of
• xsl:decimal-format
• xsl:document
• xsl:element
• xsl:fallback
• xsl:for-each
• xsl:for-each-group
• xsl:function
• xsl:if
• xsl:include
• xsl:import
• xsl:import-schema
• xsl:key
• xsl:matching-substring
• xsl:message
• xsl:namespace
• xsl:namespace-alias
• xsl:next-match
• xsl:non-matching-substring
• xsl:number
• xsl:otherwise
• xsl:output
• xsl:output-character
• xsl:param
• xsl:perform-sort
• xsl:preserve-space
• xsl:processing-instruction
• xsl:result-document
• xsl:sequence
• xsl:sort
• xsl:strip-space
• xsl:stylesheet
• xsl:template
• xsl:text
• xsl:value-of
• xsl:variable
• xsl:when
• xsl:with-param
• Literal Result Elements
• XSLT Patterns
  • Examples of Patterns
  • Pattern syntax

XPath 2.0 Expression Syntax

• Introduction
• Constants
• Variable References
• Function Calls
• Axis steps
• Parentheses and operator precedence
• Filter expressions
• Path expressions
• Cast as, Treat as
• Set difference and intersection
• Union
• Arithmetic expressions
  • Unary plus and minus
  • Multiplication and division
  • Addition and subtraction
• Range expressions
• Comparisons
• Instance of and Castable as
• Conditional Expressions
• Quantified Expressions
• For Expressions
• Boolean expressions: AND and OR
• Sequence expressions

• fn:QName

• fn:abs

• fn:adjust-date-to-timezone

• fn:adjust-dateTime-to-timezone

• fn:adjust-time-to-timezone

• fn:avg

• fn:base-uri

• fn:boolean

• fn:ceiling

• fn:codepoint-equal

• fn:codepoints-to-string

• fn:collection

• fn:compare

• fn:concat

• fn:contains

• fn:count

• xslt:current

• fn:current-date

• fn:current-dateTime

• xslt:current-group

• xslt:current-grouping-key

• fn:current-time

• fn:data

• fn:dateTime

• fn:day-from-date

• fn:day-from-dateTime

• fn:days-from-duration

• fn:deep-equal

• fn:default-collation

• fn:distinct-values

• fn:doc

• fn:doc-available

• xslt:document

• fn:document-uri

• xslt:element-available

• fn:empty

• fn:encode-for-uri

• fn:ends-with

• fn:error

• fn:escape-html-uri

• fn:exactly-one

• fn:exists

• fn:false

• fn:floor

• xslt:format-date

• xslt:format-dateTime

• xslt:format-number

• xslt:format-time

• xslt:function-available

• xslt:generate-id

• fn:hours-from-dateTime

• fn:hours-from-duration

• fn:hours-from-time

• fn:id

• fn:idref

• fn:implicit-timezone

• fn:in-scope-prefixes

• fn:index-of

• fn:insert-before

• fn:iri-to-uri

• xslt:key

• fn:lang

• fn:last

• fn:local-name

• fn:local-name-from-QName

• fn:lower-case

• fn:matches

• fn:max

• fn:min

• fn:minutes-from-dateTime

• fn:minutes-from-duration

• fn:minutes-from-time

• fn:month-from-date

• fn:month-from-dateTime

• fn:months-from-duration

• fn:name

• fn:namespace-uri

• fn:namespace-uri-for-prefix

• fn:namespace-uri-from-QName

• fn:nilled

• fn:node-name

• fn:normalize-space

• fn:normalize-unicode

• fn:not

• fn:number

• fn:one-or-more

• fn:position

• fn:prefix-from-QName

• xslt:regex-group

• fn:remove

• fn:replace

• fn:resolve-QName

• fn:resolve-uri

• fn:reverse

• fn:root

• fn:round

• fn:round-half-to-even

• fn:seconds-from-dateTime

• fn:seconds-from-duration

• fn:seconds-from-time

• fn:starts-with

• fn:static-base-uri

• fn:string

• fn:string-join

• fn:string-length

• fn:string-to-codepoints

• fn:subsequence

• fn:substring

• fn:substring-after

• fn:substring-before

• fn:sum

• xslt:system-property

• fn:timezone-from-date

• fn:timezone-from-dateTime

• fn:timezone-from-time

• fn:tokenize

• fn:trace

• fn:translate

• fn:true

• xslt:type-available

• fn:unordered

• xslt:unparsed-entity-public-id

• xslt:unparsed-entity-uri

• xslt:unparsed-text

• xslt:unparsed-text-available

• fn:upper-case

• fn:year-from-date

• fn:year-from-dateTime

• fn:years-from-duration

• fn:zero-or-one

Standards Conformance

• Introduction
• XSLT 2.0 conformance
• XPath 2.0 conformance
• XQuery 1.0 Conformance
• Conformance with XML Schema 1.0
• Serialization
• Conformance with other specifications
• Character Encodings Supported
• JAXP 1.3 Conformance