Package com.saxonica.ee.stream.adjunct

This package contains classes used to support streaming.

See: Description

Class Summary

Class	Description
AdjacentTextNodeMergerAdjunct	Compile an AdjacentTextNodeMerger expression to Java source code Needed only for streaming - this class is not used in XQuery
ApplyImportsAdjunct	Compile an xsl:apply-imports expression/instruction to Java source code.
ApplyTemplatesAdjunct	Handle streaming for the xsl:apply-templates instruction
AtomicSequenceConverterAdjunct	Compile a AtomicSequenceConverter or UntypedSequenceConverter expression to streaming code.
AtomizerAdjunct	Streaming adjunct class for an atomizer (or call on the data() function)
AxisExpressionAdjunct	Compile an axis expression to streaming code.
BlockAdjunct	Generate streaming code for a Block, that is a sequence of expressions or instructions
BooleanFnAdjunct	Streaming code for an boolean() function call
BooleanFnAdjunct.BooleanFnFeed
CallTemplateAdjunct
CardinalityCheckerAdjunct	Generate streaming code for a cardinality checker
ChooseAdjunct	Streaming code to implement a conditional ("if/choose") expression
CodepointsToStringAdjunct
ComposingAdjunct	Watch factory class for an class that composes items from sequences of events: examples are copy-of(), data(), and string().
ConditionalBlockAdjunct	Generate streaming code for a conditional Block, that is a sequence constructor containing xsl:on-empty and/or xsl:on-not-empty instructions
ConditionalBlockAdjunct.ConditionalBlockFeed
ContextItemExprAdjunct
CopyAdjunct	Compile an xsl:copy expression/instruction to streaming code.
CopyOfAdjunct
CountAdjunct	Streaming code for the count() function.
CurrentGroupAdjunct	Provides streaming code for a call on current-group().
CurrentMergeGroupAdjunct	Generate streaming code for a call on current-group().
DeepEqualAdjunct	Implement streaming of insert-before instruction.
DistinctValuesAdjunct	Implement the distinct-values function in streaming code.
DocumentInstrAdjunct	Evaluate an xsl:document instruction in streaming code.
DocumentInstrAdjunct.DocumentInstrFeed
DocumentSorterAdjunct	Generate streaming code for a document sorting expression node.
ElementCreatorAdjunct	Generate streaming code for an xsl:element instruction
EmptyAdjunct	Streaming code for an empty() function call
EmptyTextNodeRemoverAdjunct	Compile an EmptyTextNodeRemover expression to Java source code Needed only for streaming - this class is not used in XQuery
ExistsAdjunct	Generate streaming code for an exists() function call
FilterExpressionAdjunct	Generate streaming code for a filter expression (when not part of a Watch).
FilterFnAdjunct	Generate streaming code for the fn:filter function.
FilteringAdjunct	A subclass of StreamingAdjunct used for expressions that have a sequence-valued operand with usage transmission.
FirstItemExpressionAdjunct	Generate streaming code for a first item expression (when not part of a Watch).
FoldAdjunct	Streaming code for functions implemented as fold operations.
ForEachAdjunct	Compile an xsl:for-each instruction to streaming code.
ForEachGroupAdjunct	Compile an xsl:for-each-group instruction to streaming code.
ForExpressionAdjunct	Compiles streaming code to implement a Let expression
ForExpressionAdjunct.ForExpressionFeed
ForkAdjunct	Streaming code to implement an xsl:fork expression
GeneralComparisonAdjunct	Watch factory class for a general comparison
GroupAdjacentTester	This class implements GroupingFeed when the group-adjacent option is used.
GroupBoundaryTester	This feed supports xsl:for-each-group in streaming mode.
GroupEndingTester	This class implements GroupingFeed when the group-ending-with option is used.
GroupStartingTester	This class implements GroupingFeed when the group-starting-with option is used.
IndexOfAdjunct	Generate streaming code for the index-of() function.
InsertBeforeAdjunct	Implement streaming of insert-before instruction.
InspectionAdjunct	Abstract superclass for constructs that have operand usage "inspection" on their primary (sequence-valued) operand
InstanceOfAdjunct	Generate streaming code for an "instance of" expression
IsLastExprAdjunct
ItemCheckerAdjunct	Streaming code for an item checker
IterateAdjunct	Implement streaming code for xsl:iterate
LastAdjunct
LetExpressionAdjunct	Compiles streaming code to implement a Let expression
LetExpressionAdjunctB	Compiles streaming code to implement a Let expression for which the "action" part (the return clause) is consuming
LiteralAdjunct	Streamed evaluation of a literal (not difficult!)
MapEntryAdjunct	Streaming code to implement an xsl:map instruction or map constructor, where each map entry is allowed to be consuming.
MergeInstrAdjunct	Streaming adjunct for the xsl:merge instruction.
MinimaxAdjunct	Generate streaming code for the min() and max() functions.
NewMapAdjunct	Streaming code to implement an xsl:map instruction or map constructor, where each map entry is allowed to be consuming.
NextIterationAdjunct	Compile a xsl:next-intruction instruction to streaming code.
NextMatchAdjunct	Compile an xsl:next-match expression/instruction to streaming code.
NotFnAdjunct	Streaming code for a not() function call
OnEmptyAdjunct	Generate streaming code for a consuming xsl:on-empty instruction
OnNonEmptyAdjunct	Generate streaming code for a consuming xsl:on-non-empty instruction
OutermostAdjunct	Generate streaming code for a remove() function call.
ParentConstructorAdjunct	Watch factory class for an atomizer
RemoveAdjunct	Generate streaming code for a remove() function call.
ResultDocumentAdjunct	Handle an xsl:result-document expression/instruction for XSLT streaming capability.
ResultDocumentAdjunct.ResultDocumentFeed
ReverseAdjunct
RootAdjunct
RootExpressionAdjunct	Streaming code for an expression that does not support streaming
SimpleNodeConstructorAdjunct	Generate streaming code for an xsl:value-of, xsl:comment, xsl:processing-instruction instruction, etc
SingletonAtomizerAdjunct	Watch factory class for a singleton atomizer
SnapshotFnAdjunct	Generate streaming code for the snapshot() function
SortExpressionAdjunct	Streaming code for an expression that does not support streaming
StreamingAdjunct	This abstract class supplements an Expression with methods used at compile-time to support streaming, by generating a Watch that allows the expression to be evaluated in push mode.
StreamInstrAdjunct
StringFnAdjunct	Generate Java code to implement the XPath string() function
SubscriptExpressionAdjunct	Streaming code for an expression that does not support streaming
SubsequenceAdjunct	Generate streaming code for a subsequence() function call.
SumAdjunct	Streaming code for the sum() function.
TailExpressionAdjunct
TraceAdjunct	Implement streaming of fn:trace instruction.
TransmissionAdjunct	A subclass of StreamingAdjunct used for expressions that have a sequence-valued operand with usage transmission.
TreatFnAdjunct	Generate streaming code for a "treat" function call (for example one-or-more)
TryCatchAdjunct	Generate streaming code for a try/catch expression
TryCatchAdjunct.TryCatchFeed
UseAttributeSetAdjunct
UserFunctionCallAdjunct	Handle streaming for calls to user-defined functions Used only for XSLT streaming capability.
VariableReferenceAdjunct
VennExpressionAdjunct
WherePopulatedAdjunct	Generate streaming code for an xsl:where-populated instruction.

Package com.saxonica.ee.stream.adjunct Description

This package contains classes used to support streaming. For every kind of expression that can appear in the expression tree, there is an auxiliary or adjunct class that contains the code needed to support streaming (if any).

None of these classes will be used directly by typical user applications.

The interface to these adjunct classes is defined in the abstract class StreamingAdjunct. The main methods are getWatchMaker() and getFeedMaker() which return a factory for respectively a Watch and a Feed; a Watch is used to evaluate the expression in decomposed push mode, an event at a time, while a Feed is used to evaluate it in composed push mode, an item at a time.

The association between an expression class and its corresponding adjunct is made by the method getStreamingAdjunct() in the Expression class, which is compiled out by the source preprocessor for all builds except Saxon-EE.