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 9.1 (2008-07-02)
  • Highlights
  • XQuery Updates
  • XML Schema 1.1
  • XML Schema 1.0
  • XSLT 2.0
  • XQuery 1.0
  • XQJ (XQuery API for Java)
  • S9API
  • JAXP
  • Extensibility
  • Extensions
  • Diagnostics and Tracing
  • Saxon on .NET
  • Internal APIs
  • Serialization
  • Optimization
• Version 9.0 (2007-11-03)
  • Highlights
  • New Java API
  • Command line changes
  • XSLT changes
  • XPath changes
  • Extensions
  • Schema-related changes
  • Changes to existing APIs
  • Pull processing in Java
  • Serialization
  • Localization
  • Optimization
  • Diagnostics
  • NamePool changes
  • Expression tree changes

Notices

• Introduction
• Contributors
• Third Party Source Components
• Redistributed Components
• Published Algorithms and Specifications

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
  • Using s9api for Transformations
  • Using JAXP for Transformations
• Performance Analysis

Using XQuery

• Introduction
• Running XQuery from the Command Line
• Running Queries from a Java Application
  • Using s9api for XQuery
  • Invoking XQuery using the XQJ API
  • The legacy XQuery API
• Using XQuery Update
• Calling XQuery Functions from Java
• Result Format
• Compiling Queries to Java code
  • Limitations
  • 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
• Preloading shared reference documents
• 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
  • The saxon:stream() extension function
  • Processing the nodes returned by saxon:stream()
  • Reading source documents partially
  • Streamable path expressions
  • How streaming works
  • Using saxon:stream() with saxon:iterate
• Document Projection

XML Schema Processing

• Introduction
• Running Validation from the Command Line
• Controlling Validation from Java
  • Schema Processing using s9api
  • Schema Processing using JAXP
• Schema-Aware XSLT from the Command Line
• Schema-Aware XSLT from Java
• Schema-Aware XQuery from the Command Line
• Schema-Aware XQuery from Java
• XML Schema 1.1
  • Assertions
  • Conditional Type Assignment
  • All Model Groups
• Extensions to the XML Schema Language
  • Assertions on Simple Types
• Importing and Exporting Schema Component Models
• Handling minOccurs and maxOccurs

XPath API for Java

• Introduction
• Evaluating XPath Expressions using s9api
• The JAXP XPath API
  • Selecting the XPath implementation
  • Context node
  • Return types
  • Additional Saxon methods
• The Standalone XPath API
• The NodeInfo Object

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:double-space attribute
  • The saxon:indent-spaces attribute
  • The saxon:suppress-indentation attribute
  • The saxon:character-representation attribute
  • The saxon:next-in-chain attribute
  • The saxon:require-well-formed attribute
  • The saxon:supply-source-locator attribute
  • The saxon:xquery serialization method
  • User defined serialization attributes
• Extension functions
  • saxon:analyze-string()
  • saxon:base64Binary-to-octets()
  • saxon:base64Binary-to-string()
  • saxon:call()
  • saxon:column-number(node)
  • saxon:compile-query()
  • saxon:compile-stylesheet()
  • saxon:decimal-divide()
  • saxon:deep-equal()
  • saxon:discard-document()
  • saxon:eval()
  • saxon:evaluate()
  • saxon:evaluate-node()
  • saxon:expression()
  • saxon:file-last-modified()
  • 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:in-summer-time()
  • saxon:is-whole-number()
  • saxon:item-at()
  • saxon:last-modified()
  • saxon:leading()
  • saxon:line-number(node)
  • saxon:lowest()
  • saxon:namespace-node()
  • saxon:stream()
  • saxon:octets-to-base64Binary()
  • saxon:octets-to-hexBinary()
  • saxon:parse()
  • saxon:path()
  • saxon:print-stack()
  • saxon:query()
  • saxon:result-document()
  • 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()
  • saxon:unparsed-entities()
• Extension instructions
  • saxon:assign
  • saxon:break
  • saxon:call-template
  • saxon:collation
  • saxon:doctype
  • saxon:entity-ref
  • saxon:import-query
  • saxon:iterate
  • 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
• XML Schema 1.0
• XML Schema 1.1
• Serialization
• XQuery Update 1.0
• Conformance with other specifications
• Character Encodings Supported
• JAXP Conformance
• XQJ Conformance