Sophie

Sophie

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

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:48 GMT 2011 -->
<TITLE>
com.saxonica.stream
</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="com.saxonica.stream";
    }
}
</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="../../../com/saxonica/serialize/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../com/saxonica/stream/adjunct/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?com/saxonica/stream/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 com.saxonica.stream
</H2>
This package and its subpackages contains classes used to support streaming
        and document projection.
<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>Class Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/Conduit.html" title="class in com.saxonica.stream">Conduit</A></B></TD>
<TD>A Conduit is a communication channel from a Producer to a Consumer: the channel is used to pass
 a sequence of items (and possibly an exception) from the producer to the consumer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/ExpressionInverter.html" title="class in com.saxonica.stream">ExpressionInverter</A></B></TD>
<TD>This class performs inversion of an expression so that it can be evaluated in push mode as events are
 received from the XML parser.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/InvertedExpression.html" title="class in com.saxonica.stream">InvertedExpression</A></B></TD>
<TD>This class represents an expression that has been "inverted" (in the Jackson sense) so that its
 execution is push-driven, that is, driven by events from the streamed document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/ManualIterator.html" title="class in com.saxonica.stream">ManualIterator</A></B></TD>
<TD>ManualIterator: a pseudo-iterator used while streaming.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/Projector.html" title="class in com.saxonica.stream">Projector</A></B></TD>
<TD>This class uses a <A HREF="../../../net/sf/saxon/expr/parser/PathMap.html" title="class in net.sf.saxon.expr.parser"><CODE>PathMap</CODE></A> to do document projection.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceExchanger.html" title="class in com.saxonica.stream">SequenceExchanger</A></B></TD>
<TD>This class enables one thread to produce a sequence of items in push mode, and another thread to
 read the sequence of items in pull mode, using a producer/consumer model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceExchanger.Consumer.html" title="class in com.saxonica.stream">SequenceExchanger.Consumer</A></B></TD>
<TD>The Consumer is a SequenceIterator that reads a sequence of items from the Conduit: that
 is, it allows its caller to make a sequence of calls on next(), each of which will return the
 next item pushed onto the Conduit by the corresponding Producer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceExchanger.EvaluationThread.html" title="class in com.saxonica.stream">SequenceExchanger.EvaluationThread</A></B></TD>
<TD>EvaluationThread is a producer that evaluates an expression in "push" mode, writing the results
 to a Conduit.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceExchanger.Producer.html" title="class in com.saxonica.stream">SequenceExchanger.Producer</A></B></TD>
<TD>The class Producer represents the thread that pushes items onto the Conduit.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceExchanger.SequencePusher.html" title="class in com.saxonica.stream">SequenceExchanger.SequencePusher</A></B></TD>
<TD>A SequenceReceiver that accepts a sequence of events and writes them to a Conduit</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceFilter.html" title="class in com.saxonica.stream">SequenceFilter</A></B></TD>
<TD>A sequence writer that passes on only those items that satisfy a filter predicate.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/SequenceTransmitter.html" title="class in com.saxonica.stream">SequenceTransmitter</A></B></TD>
<TD>This is a SequenceWriter that passes items through to a supplied SequenceReceiver</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/StreamingApplyTemplates.html" title="class in com.saxonica.stream">StreamingApplyTemplates</A></B></TD>
<TD>Streaming version of the xsl:apply-templates instruction.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/StreamingCopy.html" title="class in com.saxonica.stream">StreamingCopy</A></B></TD>
<TD>This class performs a streaming copy of selected nodes within a document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/StreamingPatternMaker.html" title="class in com.saxonica.stream">StreamingPatternMaker</A></B></TD>
<TD>Factory class to make a streaming pattern from an expression.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/StreamingRoute.html" title="class in com.saxonica.stream">StreamingRoute</A></B></TD>
<TD>A StreamingRoute represents the path of events through an expression tree being
 evaluated in streaming mode.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/StreamingRoute.PushAction.html" title="class in com.saxonica.stream">StreamingRoute.PushAction</A></B></TD>
<TD>A PushAction is a collection of data that together represents the strategy for how an expression should be
 evaluated in push mode.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../../com/saxonica/stream/TemplateInversion.html" title="class in com.saxonica.stream">TemplateInversion</A></B></TD>
<TD>This class represents the inversion of a template body</TD>
</TR>
</TABLE>
&nbsp;

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

<P>
<p>This package and its subpackages contains classes used to support streaming
        and document projection. In principle these facilities are applicable both
        to XSLT and XQuery; the streamed evaluation of XPath expressions is also used
        during schema validation, to process identity constraints.</p>
    
    <p>None of these classes will be used directly by typical user applications.</p>

    <p>This package contains classes that watch for events coming from the streamed document. Different
    kinds of watch are associated with different expressions and perform differing actions with these events;
    for example a <A HREF="../../../com/saxonica/stream/watch/CopyOfWatch.html" title="class in com.saxonica.stream.watch"><CODE>CopyOfWatch</CODE></A> builds a subtree representing an element
    and passes this to a feed that expects a stream of element nodes, while a <A HREF="../../../com/saxonica/stream/watch/CountWatch.html" title="class in com.saxonica.stream.watch"><CODE>CountWatch</CODE></A>
    counts the nodes and passes an integer to the next expression in the pipeline; a <A HREF="../../../com/saxonica/stream/watch/TypedValueWatch.html" title="class in com.saxonica.stream.watch"><CODE>TypedValueWatch</CODE></A>
    atomizes nodes and feeds the resulting atomic values to the next stage.</p>

    <p>The instantiation of watch classes, calling them to test whether they are interested in particular events,
    and remembering when to de-activate them, is all handled by the <A HREF="../../../com/saxonica/stream/watch/WatchManager.html" title="class in com.saxonica.stream.watch"><CODE>WatchManager</CODE></A>.</p>


   <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="../../../com/saxonica/serialize/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
&nbsp;<A HREF="../../../com/saxonica/stream/adjunct/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?com/saxonica/stream/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>