Sophie

Sophie

distrib > Mageia > 7 > i586 > by-pkgid > b3bdfe6d859a3d6920ff2c44b38e9a6f > files > 2458

saxon-manual-9.4.0.9-2.mga7.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:51 GMT 2011 -->
<TITLE>
net.sf.saxon.s9api
</TITLE>

<META NAME="date" CONTENT="2011-12-09">

<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">

<SCRIPT type="text/javascript">
function windowTitle()
{
    if (location.href.indexOf('is-external=true') == -1) {
        parent.document.title="net.sf.saxon.s9api";
    }
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>

</HEAD>

<BODY BGCOLOR="white" onload="windowTitle();">
<HR>


<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../net/sf/saxon/query/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../../net/sf/saxon/serialize/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html?net/sf/saxon/s9api/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->

<HR>
<H2>
Package net.sf.saxon.s9api
</H2>
This package provides Saxon's preferred Java API for XSLT, XQuery, XPath, and XML Schema processing.
<P>
<B>See:</B>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#package_description"><B>Description</B></A>
<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Interface Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/BuildingContentHandler.html" title="interface in net.sf.saxon.s9api">BuildingContentHandler</A></B></TD>
<TD>A SAX <A HREF="http://download.oracle.com/javase/6/docs/api/org/xml/sax/ContentHandler.html?is-external=true" title="class or interface in org.xml.sax"><CODE>ContentHandler</CODE></A> that builds a Saxon tree, and allows the node at the root of the tree
 to be retrieved on completion</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/BuildingStreamWriter.html" title="interface in net.sf.saxon.s9api">BuildingStreamWriter</A></B></TD>
<TD>A BuildingStreamWriter allows a document to be constructed by calling the methods defined in the
 <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/stream/XMLStreamWriter.html?is-external=true" title="class or interface in javax.xml.stream"><CODE>XMLStreamWriter</CODE></A> interface; after the document has been constructed, its root
 node may be retrieved by calling the getDocumentNode() method.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/Destination.html" title="interface in net.sf.saxon.s9api">Destination</A></B></TD>
<TD>A Destination represents a place where XML can be sent.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/ExtensionFunction.html" title="interface in net.sf.saxon.s9api">ExtensionFunction</A></B></TD>
<TD>This is an interface for simple external/extension functions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/MessageListener.html" title="interface in net.sf.saxon.s9api">MessageListener</A></B></TD>
<TD>A user-written implementation of the MessageListener interface may be registered with the XsltTransformer
 to receive notification of xsl:message output.</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Class Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/BuildingStreamWriterImpl.html" title="class in net.sf.saxon.s9api">BuildingStreamWriterImpl</A></B></TD>
<TD>This class is an implementation of <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/stream/XMLStreamWriter.html?is-external=true" title="class or interface in javax.xml.stream"><CODE>XMLStreamWriter</CODE></A>, allowing
 a document to be constructed by means of a series of XMLStreamWriter method calls such
 as writeStartElement(), writeAttribute(), writeCharacters(), and writeEndElement().</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/DocumentBuilder.html" title="class in net.sf.saxon.s9api">DocumentBuilder</A></B></TD>
<TD>A document builder holds properties controlling how a Saxon document tree should be built, and
 provides methods to invoke the tree construction.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/DOMDestination.html" title="class in net.sf.saxon.s9api">DOMDestination</A></B></TD>
<TD>This class represents a Destination (for example, the destination of the output of a transformation)
 in which the results are written to a newly constructed DOM tree in memory.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/ItemType.html" title="class in net.sf.saxon.s9api">ItemType</A></B></TD>
<TD>An item type, as defined in the XPath/XQuery specifications.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/ItemTypeFactory.html" title="class in net.sf.saxon.s9api">ItemTypeFactory</A></B></TD>
<TD>This class is used for creating ItemType objects.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/Processor.html" title="class in net.sf.saxon.s9api">Processor</A></B></TD>
<TD>The <code>Processor</code> class serves three purposes: it allows global Saxon configuration options to be set;
 it acts as a factory for generating XQuery, XPath, and XSLT compilers; and it owns certain shared
 resources such as the Saxon NamePool and compiled schemas.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/QName.html" title="class in net.sf.saxon.s9api">QName</A></B></TD>
<TD>The QName class represents an instance of xs:QName, as defined in the XPath 2.0 data model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SAXDestination.html" title="class in net.sf.saxon.s9api">SAXDestination</A></B></TD>
<TD>This class represents a Destination (for example, the destination of the output of a transformation)
 in which events representing the XML document are sent to a user-supplied SAX2 ContentHandler, as
 if the ContentHandler were receiving the document directly from an XML parser.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SchemaManager.html" title="class in net.sf.saxon.s9api">SchemaManager</A></B></TD>
<TD>The SchemaManager is used to load schema documents, and to set options for the way in which they are loaded.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SchemaValidator.html" title="class in net.sf.saxon.s9api">SchemaValidator</A></B></TD>
<TD>A <tt>SchemaValidator</tt> is an object that is used for validating instance documents against a schema.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SequenceType.html" title="class in net.sf.saxon.s9api">SequenceType</A></B></TD>
<TD>A SequenceType is the combination of an ItemType and an OccurrenceIndicator</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/Serializer.html" title="class in net.sf.saxon.s9api">Serializer</A></B></TD>
<TD>A Serializer takes a tree representation of XML and turns it into lexical XML markup.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/TeeDestination.html" title="class in net.sf.saxon.s9api">TeeDestination</A></B></TD>
<TD>A TeeDestination allows writing to two destinations at once.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/WhitespaceStrippingPolicy.html" title="class in net.sf.saxon.s9api">WhitespaceStrippingPolicy</A></B></TD>
<TD>WhitespaceStrippingPolicy is class defining the possible policies for handling
 whitespace text nodes in a source document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmAtomicValue.html" title="class in net.sf.saxon.s9api">XdmAtomicValue</A></B></TD>
<TD>The class XdmAtomicValue represents an item in an XPath 2.0 sequence that is an atomic value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmDestination.html" title="class in net.sf.saxon.s9api">XdmDestination</A></B></TD>
<TD>An <code>XdmDestination</code> is a <A HREF="../../../../net/sf/saxon/s9api/Destination.html" title="interface in net.sf.saxon.s9api"><CODE>Destination</CODE></A> in which an <A HREF="../../../../net/sf/saxon/s9api/XdmNode.html" title="class in net.sf.saxon.s9api"><CODE>XdmNode</CODE></A>
 is constructed to hold the output of a query or transformation:
 that is, a tree using Saxon's implementation of the XDM data model</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmEmptySequence.html" title="class in net.sf.saxon.s9api">XdmEmptySequence</A></B></TD>
<TD>The class <tt>XdmEmptySequence</tt> represents an empty sequence in the XDM Data Model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmFunctionItem.html" title="class in net.sf.saxon.s9api">XdmFunctionItem</A></B></TD>
<TD>The class XdmFunctionItem represents a function item</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmItem.html" title="class in net.sf.saxon.s9api">XdmItem</A></B></TD>
<TD>The class XdmItem represents an item in a sequence, as defined by the XDM data model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmNode.html" title="class in net.sf.saxon.s9api">XdmNode</A></B></TD>
<TD>This class represents a node in the XDM data model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmSequenceIterator.html" title="class in net.sf.saxon.s9api">XdmSequenceIterator</A></B></TD>
<TD>An iterator over an XPath sequence.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmValue.html" title="class in net.sf.saxon.s9api">XdmValue</A></B></TD>
<TD>An value in the XDM data model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XPathCompiler.html" title="class in net.sf.saxon.s9api">XPathCompiler</A></B></TD>
<TD>An XPathCompiler object allows XPath queries to be compiled.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XPathExecutable.html" title="class in net.sf.saxon.s9api">XPathExecutable</A></B></TD>
<TD>An XPathExecutable represents the compiled form of an XPath expression.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XPathSelector.html" title="class in net.sf.saxon.s9api">XPathSelector</A></B></TD>
<TD>An XPathSelector represents a compiled and loaded XPath expression ready for execution.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XQueryCompiler.html" title="class in net.sf.saxon.s9api">XQueryCompiler</A></B></TD>
<TD>An XQueryCompiler object allows XQuery 1.0 queries to be compiled.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XQueryEvaluator.html" title="class in net.sf.saxon.s9api">XQueryEvaluator</A></B></TD>
<TD>An <code>XQueryEvaluator</code> represents a compiled and loaded query ready for execution.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XQueryExecutable.html" title="class in net.sf.saxon.s9api">XQueryExecutable</A></B></TD>
<TD>An XQueryExecutable represents the compiled form of a query.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XsltCompiler.html" title="class in net.sf.saxon.s9api">XsltCompiler</A></B></TD>
<TD>An XsltCompiler object allows XSLT 2.0 stylesheets to be compiled.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XsltExecutable.html" title="class in net.sf.saxon.s9api">XsltExecutable</A></B></TD>
<TD>An XsltExecutable represents the compiled form of a stylesheet.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XsltTransformer.html" title="class in net.sf.saxon.s9api">XsltTransformer</A></B></TD>
<TD>An <code>XsltTransformer</code> represents a compiled and loaded stylesheet ready for execution.</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Enum Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/Axis.html" title="enum in net.sf.saxon.s9api">Axis</A></B></TD>
<TD>This is an enumeration class containaing constants representing the thirteen XPath axes</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/OccurrenceIndicator.html" title="enum in net.sf.saxon.s9api">OccurrenceIndicator</A></B></TD>
<TD>Represents one of the possible occurrence indicators in a SequenceType.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/Serializer.Property.html" title="enum in net.sf.saxon.s9api">Serializer.Property</A></B></TD>
<TD>Enumerator over the defined serialization properties</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/ValidationMode.html" title="enum in net.sf.saxon.s9api">ValidationMode</A></B></TD>
<TD>Enumeration class defining different schema validation (or construction) modes</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/XdmNodeKind.html" title="enum in net.sf.saxon.s9api">XdmNodeKind</A></B></TD>
<TD>Enumeration class defining the seven kinds of node defined in the XDM model</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Exception Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SaxonApiException.html" title="class in net.sf.saxon.s9api">SaxonApiException</A></B></TD>
<TD>An exception thrown by the Saxon s9api API.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../../net/sf/saxon/s9api/SaxonApiUncheckedException.html" title="class in net.sf.saxon.s9api">SaxonApiUncheckedException</A></B></TD>
<TD>An unchecked exception thrown by the Saxon API.</TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package net.sf.saxon.s9api Description
</H2>

<P>
<p>This package provides Saxon's preferred Java API for XSLT, XQuery, XPath, and XML Schema processing.
    The interface is designed to hide as much as possible of the detail of the
implementation. However, the API architecture faithfully reflects the internal architecture
of the Saxon product, unlike standard APIs such as JAXP and XQJ which in many cases force
compromises in the design and performance of the application.</p>

<p>An application starts by loading a <A HREF="../../../../net/sf/saxon/s9api/Processor.html" title="class in net.sf.saxon.s9api"><CODE>Processor</CODE></A>, which allows configuration options
to be set. As far as possible, an application should instantiate a single <code>Processor</code>.</p>

<p>The interfaces for XSLT, XQuery, and XPath processing all follow the same pattern. There is a three-stage
execution model: first a compiler is created using a factory method in the <code>Processor</code> object.
The compiler holds compile-time options and the static context information. Then the compiler's
<code>compile()</code> method is called to create an executable, a representation of the compiled stylesheet,
query, or expression. This is thread-safe and immutable once created. To run the query or transformation,
first call the <code>load()</code> method to create a run-time object called variously an <A HREF="../../../../net/sf/saxon/s9api/XsltTransformer.html" title="class in net.sf.saxon.s9api"><CODE>XsltTransformer</CODE></A>,
<A HREF="../../../../net/sf/saxon/s9api/XQueryEvaluator.html" title="class in net.sf.saxon.s9api"><CODE>XQueryEvaluator</CODE></A>, or <A HREF="../../../../net/sf/saxon/s9api/XPathSelector.html" title="class in net.sf.saxon.s9api"><CODE>XPathSelector</CODE></A>. This holds run-time context information
such as parameter settings and the initial context node; the object is therefore not shareable and should
only be run in a single thread; indeed it should normally only be used once. This object also provides 
methods allowing the transformation or query to be executed.</p>

<p>In Saxon-EE the <code>Processor</code> owns a <A HREF="../../../../net/sf/saxon/s9api/SchemaManager.html" title="class in net.sf.saxon.s9api"><CODE>SchemaManager</CODE></A> that holds
the cache of schema components and can be used to load new schema components from source schema documents.
It can also be used to create a <A HREF="../../../../net/sf/saxon/s9api/SchemaValidator.html" title="class in net.sf.saxon.s9api"><CODE>SchemaValidator</CODE></A>, which in turn is used to validate instance
documents.</p>

<p>Source documents can be constructed using a <A HREF="../../../../net/sf/saxon/s9api/DocumentBuilder.html" title="class in net.sf.saxon.s9api"><CODE>DocumentBuilder</CODE></A>, which holds all the options
and parameters to control document building.</p>

<p>The output of a transformation, or of any other process that generates an XML tree, can be sent to a
<A HREF="../../../../net/sf/saxon/s9api/Destination.html" title="interface in net.sf.saxon.s9api"><CODE>Destination</CODE></A>. There are a number of implementations of this interface, including a
<A HREF="../../../../net/sf/saxon/s9api/Serializer.html" title="class in net.sf.saxon.s9api"><CODE>Serializer</CODE></A> which translates the XML document tree into lexical XML form.</p>

<p>There are classes to represent the objects of the XDM data model, including <A HREF="../../../../net/sf/saxon/s9api/XdmValue.html" title="class in net.sf.saxon.s9api"><CODE>XdmValue</CODE></A>,
<A HREF="../../../../net/sf/saxon/s9api/XdmItem.html" title="class in net.sf.saxon.s9api"><CODE>XdmItem</CODE></A>, <A HREF="../../../../net/sf/saxon/s9api/XdmNode.html" title="class in net.sf.saxon.s9api"><CODE>XdmNode</CODE></A>, and <A HREF="../../../../net/sf/saxon/s9api/XdmAtomicValue.html" title="class in net.sf.saxon.s9api"><CODE>XdmAtomicValue</CODE></A>.</p>

<p>The s9api interface is designed to take advantage of Java 5 constructs such as generics and
iterables. </p>

<hr>

<p align="center"><i>Michael H. Kay<br/>
Saxonica Limited<br/>
30 July 2010</i></p>
<P>

<P>
<DL>
</DL>
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../net/sf/saxon/query/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../../net/sf/saxon/serialize/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../index.html?net/sf/saxon/s9api/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.
</BODY>
</HTML>