Sophie

Sophie

distrib > Mandriva > 8.2 > i586 > by-pkgid > 455f0c5faba5a18e97e845364ab15c78 > files > 230

saxon-6.5-1mdk.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc on Tue Sep 18 10:25:31 GMT+01:00 2001 -->
<TITLE>
: Package com.icl.saxon
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
</HEAD>
<BODY BGCOLOR="white">

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_top"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <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;PREV PACKAGE&nbsp;
&nbsp;<A HREF="../../../com/icl/saxon/aelfred/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<H2>
Package com.icl.saxon
</H2>
This package provides the core classes of the SAXON XSLT library.
<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" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Interface Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Binding.html"><I>Binding</I></A></B></TD>
<TD>Binding is a interface used to mark objects that represent a variable declaration</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NodeHandler.html"><I>NodeHandler</I></A></B></TD>
<TD>This abstract class defines the node handler interface used by SAXON.</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Class Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Bindery.html">Bindery</A></B></TD>
<TD>The Bindery class holds information about variables and their values.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="ContentEmitter.html">ContentEmitter</A></B></TD>
<TD>ContentEmitter is a glue class that provides a standard SAX ContentHandler 
 interface to a Saxon Emitter.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Context.html">Context</A></B></TD>
<TD>This class represents a context in which an expression is evaluated or a template is executed
 (as defined in the XSLT specification).</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Controller.html">Controller</A></B></TD>
<TD><B>Controller</B> processes an XML file, calling registered node handlers
 when appropriate to process its elements, character content, and attributes.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="DecimalFormatManager.html">DecimalFormatManager</A></B></TD>
<TD>DecimalFormatManager manages the collection of named and unnamed decimal formats</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="DOMDriver.html">DOMDriver</A></B></TD>
<TD>DOMDriver.java: (pseudo-)SAX driver for DOM.<BR>
 This class simulates the action of a SAX Parser, taking an already-constructed
 DOM Document and walking around it in a depth-first traversal,
 calling a SAX-compliant ContentHandler to process the children as it does so.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="ExtendedInputSource.html">ExtendedInputSource</A></B></TD>
<TD>This class allows a SAXON application to encapsulate information
 about an input source in a single object, which may include
 a public identifier, a system identifier, a byte stream (possibly
 with a specified encoding), a character stream, or a file.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="FeatureKeys.html">FeatureKeys</A></B></TD>
<TD>FeatureKeys defines a set of constants, names of Saxon configuration
 options which can be supplied to the TransformerFactoryImpl interface</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Filter.html">Filter</A></B></TD>
<TD><B>Filter</B> is an XMLFilter (a SAX2 filter) that performs a transformation
 taking a SAX stream as input and producing a SAX stream as output.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="IdentityTransformerHandler.html">IdentityTransformerHandler</A></B></TD>
<TD><b>IdentityTransformerHandler</b> implements the javax.xml.transform.sax.TransformerHandler
 interface.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="IDFilter.html">IDFilter</A></B></TD>
<TD>IDFilter is a SAX filter that extracts the subtree of a document rooted at the
 element with a given ID value.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="KeyDefinition.html">KeyDefinition</A></B></TD>
<TD>Corresponds to a single key definition.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="KeyManager.html">KeyManager</A></B></TD>
<TD>KeyManager manages the set of key definitions in a stylesheet, and the indexes
 associated with these key definitions</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Loader.html">Loader</A></B></TD>
<TD>Loader is used to load a class given its name.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Mode.html">Mode</A></B></TD>
<TD>A Mode is a collection of rules; the selection of a rule to apply to a given element
 is determined by a Pattern.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="ParameterSet.html">ParameterSet</A></B></TD>
<TD>A ParameterSet is a set of parameters supplied when calling a template.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PIGrabber.html">PIGrabber</A></B></TD>
<TD>The PIGrabber class is a SAX ContentHandler that looks for xml-stylesheet processing
 instructions and tests whether they match specified criteria; for those that do, it creates
 an InputSource object referring to the relevant stylesheet</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PreparedStyleSheet.html">PreparedStyleSheet</A></B></TD>
<TD>This <B>PreparedStyleSheet</B> class represents a StyleSheet that has been
 prepared for execution (or "compiled").</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PreviewManager.html">PreviewManager</A></B></TD>
<TD><B>PreviewManager</B> handles the registration of preview elements for use by the Builder</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="RuleManager.html">RuleManager</A></B></TD>
<TD><B>RuleManager</B> maintains a set of template rules, one set for each mode</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="StandardErrorListener.html">StandardErrorListener</A></B></TD>
<TD><B>StandardErrorListener</B> is the standard error handler for XSLT processing
 errors, used if no other ErrorListener is nominated.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="StandardURIResolver.html">StandardURIResolver</A></B></TD>
<TD>This class provides the service of converting a URI into an InputSource.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="StyleSheet.html">StyleSheet</A></B></TD>
<TD>This <B>StyleSheet</B> class is the entry point to the Saxon XSLT Processor.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="StylesheetStripper.html">StylesheetStripper</A></B></TD>
<TD>The StylesheetStripper refines the Stripper class to do stripping of
 whitespace nodes on a stylesheet.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TemplatesHandlerImpl.html">TemplatesHandlerImpl</A></B></TD>
<TD><b>TemplatesHandlerImpl</b> implements the javax.xml.transform.sax.TemplatesHandler
 interface.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TransformerFactoryImpl.html">TransformerFactoryImpl</A></B></TD>
<TD>A TransformerFactoryImpl instance can be used to create Transformer and Template
 objects.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TransformerHandlerImpl.html">TransformerHandlerImpl</A></B></TD>
<TD><b>TransformerHandlerImpl</b> implements the javax.xml.transform.sax.TransformerHandler
 interface.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TreeDriver.html">TreeDriver</A></B></TD>
<TD>TreeDriver.java: (pseudo-)SAX driver for Saxon trees.<BR>
 Subclasses DOMDriver for the case where the tree is a Saxon tree (a DocumentInfo)
 This class simulates the action of a SAX Parser, taking an already-constructed
 DOM Document and walking around it in a depth-first traversal,
 calling a SAX-compliant ContentHandler to process the children as it does so.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="Version.html">Version</A></B></TD>
<TD>The Version class holds the SAXON version information.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="WinStyleSheet.html">WinStyleSheet</A></B></TD>
<TD>This <B>WinStyleSheet</B> class is used in instant-saxon, a packaged
 interface to the StyleSheet interpreter, intended for use with jexegen
 on Windows platforms.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="XSLTProcessorApplet.html">XSLTProcessorApplet</A></B></TD>
<TD><meta name="usage" content="general"/>
 Provides applet host for the XSLT processor.</TD>
</TR>
</TABLE>
&nbsp;

<P>

<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Error Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="InternalSaxonError.html">InternalSaxonError</A></B></TD>
<TD>An InternalError represents an condition detected during Saxon processing that
 should never occur.</TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package com.icl.saxon Description
</H2>

<P>
<p>This package provides the core classes of the SAXON XSLT library. </p>

<p>The classes you are most likely to use directly in your application are listed below: </p>

<p><b>StyleSheet</b>:<br>
This is the XSLT processor. It has a command-line interface allowing you to
apply a given style sheet to a given source document.</p>

<p><b>PreparedStyleSheet</b>:<br>
This represents a compiled XSLT stylesheet in memory.</p>

<p><b>RuleManager</b>:<br>
This class allows you to register
user-supplied handlers to process the elements, attributes, and character content.
For information on writing handlers, see the Handlers package.</p>

<p><b>Controller</b>:<br>
This class represents the context information for a single execution of an XSLT stylesheet,
and allows the application to
process the tree navigationally. It calls
user-supplied handlers registered with the RuleManager.
If you want to write your own Java application to process a document navigationally, you
can write it as a subclass of Controller, or you can instantiate Controller
directly. </p>

<p><b>Context</b>:<br>
The Context object bundles together all the information about the context in which a node
handler is invoked. As such it corresponds directly to the context concept defined in the
XSLT specification. Information available from the Context includes: <ul>
    <li>The current node: context.getCurrentNode()</li>
    <li>Information about the current node list. The full current node list is not maintained, as
    the only things that depend on it are the XSL functions position() and last():
     these are accessible as context.getPosition() and context.getLast()</li>
     <li>The current set of variable bindings: this is available from the Bindery object,
     which may be accessed as context.getBindery(); however the most common operations to
     discover values of variables are available directly from the Context object.</li>
     <li>The current output destination: output services are available from the Outputter object
     which can be accessed as context.getOutputter().</li>
     <li>The indexes for identifiers and keys. These are maintained by the controller, which
     can be accessed as context.getController().</li>
     </ul>
 </p>


<h2>Choosing a SAX Parser</h2>

<p>SAXON provides a layer of services on top of a SAX-compliant XML parser. It will work
with any Java-based XML parser that implements the
 <a HREF="http://www.megginson.com/SAX/index.html">SAX1 or SAX2</a> interface.</p>

<p>SAXON uses the configuration file <code>ParserManager.properties</code> to decide which
SAX parser to use. This file identifies a default parser and a list of alternatives. As
issued, it lists some popular (and free) SAX-compliant parsers which have been tested with
SAXON. The default is the &AElig;lfred parser bundled with Saxon.
If you do nothing, SAXON will search your CLASSPATH to see if any of these known
parsers are installed. If you want to specify a different parser, or change the default,
simply edit the ParserManager.properties file.</p>



<hr>

<p align="center"><i>Michael H. Kay<br>
20 September 2000</i></p>
<P>
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <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;PREV PACKAGE&nbsp;
&nbsp;<A HREF="../../../com/icl/saxon/aelfred/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="package-summary.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>