This package provides support for push pipeline processing based on the
and its implementation classes. The classes are mainly for internal use, but are available for use in advanced
Interface Summary Interface Description CopyInformeeA CopyInformee is an agent that receives extra information while a tree is being copied. FilterFactoryFactory class to create a ProxyReceiver which filters events on a push pipeline ReceiverReceiver: This interface represents a recipient of XML tree-walking (push) events. ReceiverWithOutputPropertiesMarker interface attached to a
Outputterthat retains serialization properties (typically, a Receiver that forms part of the serialization pipeline).
Class Summary Class Description BuilderThe abstract Builder class is responsible for taking a stream of SAX events and constructing a Document tree. BuilderMonitorA BuilderMonitor can be inserted into a pipeline immediately in front of a Builder. CheckSumFilterA filter to go on a Receiver pipeline and calculate a checksum of the data passing through the pipeline. CloseNotifierA receiver that performs specified actions when closed CommentStripperThe CommentStripper class is a filter that removes all comments and processing instructions. ComplexContentOutputterThis class is used for generating complex content, that is, the content of an element or document node. ContentHandlerProxyA ContentHandlerProxy is a Receiver that converts events into the form expected by an underlying SAX2 ContentHandler. ContentHandlerProxy.ContentHandlerProxyTraceListenerCreate a TraceListener that will collect information about the current location in the source document. ContentHandlerProxyLocatorImplementation of the SAX Locator interface, used to supply location information to the ContentHandler. DocumentValidatorDocumentValidator checks that a document is well-formed: specifically, that it contains a single element node child and no text node children. EventAn event is an object representing one of the events that can be passed to a receiver: for example, a startElement, endElement, characters, or comment event. Event.AppendEvent representing an arbitrary item being sent to the event stream in composed form. Event.CommentEvent representing a comment node Event.EndDocumentEvent representing end of document Event.EndElementEvent representing the end of an element Event.ProcessingInstructionEvent representing a processing instruction node Event.StartDocumentEvent representing start of document Event.StartElementEvent representing the start of an element (including attributes or namespaces) Event.TextEvent representing a text node EventBufferAn EventBuffer is a receiver of events that records the events in memory for subsequent replay. EventMonitorAn EventMonitor is a filter that passes all events down the pipeline unchanged, keeping a note of whether any data has passed through the filter. EventSourceAn implementation of the JAXP Source class that supplies a document in the form of a stream of push events sent to a Receiver IDFilterIDFilter is a ProxyReceiver that extracts the subtree of a document rooted at the element with a given ID value. IgnorableWhitespaceStripperThe IgnorableWhitespaceStripper removes whitespace text nodes belonging to elements whose schema-defined type defines element-only content LocationCopierA Receiver that can be inserted into an event pipeline to copy location information. NamePoolConverterThis class is a filter that passes all Receiver events through unchanged, except that it changes namecodes to allow for the source and the destination using different NamePools. NamespaceDifferencerNamespaceDifferencer is a
ProxyReceiverresponsible for removing duplicate namespace declarations.
NamespaceReducerNamespaceReducer is a
ProxyReceiverresponsible for removing duplicate namespace declarations.
OutputterOutputter: This interface represents a recipient of XML tree-walking (push) events. OutputterEventAn outputter event is an object representing one of the events that can be passed to an
Outputter: for example, a startElement, attribute, namespace endElement, characters, or comment event.
OutputterEvent.AppendEvent representing an arbitrary item being sent to the event stream in composed form. OutputterEvent.AttributeEvent representing an attribute node OutputterEvent.CommentEvent representing a comment node OutputterEvent.EndDocumentEvent representing end of document OutputterEvent.EndElementEvent representing the end of an element OutputterEvent.NamespaceEvent representing a namespace node OutputterEvent.ProcessingInstructionEvent representing a processing instruction node OutputterEvent.StartContentEvent representing the start of element content OutputterEvent.StartDocumentEvent representing start of document OutputterEvent.StartElementEvent representing the start of an element (including attributes or namespaces) OutputterEvent.TextEvent representing a text node OutputterEventBufferAn EventBuffer is a receiver of events that records the events in memory for subsequent replay. PathMaintainerThis class sits in a receiver (push) pipeline and maintains the current path. PIGrabberThe PIGrabber class is a
ProxyReceiverthat looks for
xml-stylesheetprocessing instructions and tests whether they match specified criteria; for those that do, it creates a
Sourceobject referring to the relevant stylesheet
PipelineConfigurationA PipelineConfiguration sets options that apply to all the operations in a pipeline. ProxyOutputter ProxyReceiverA ProxyReceiver is an Receiver that filters data before passing it to another underlying Receiver. PushToReceiver ReceiverOptionReceiverOption defines a set of constants representing boolean flags, which can be used in calls to methods on the Receiver interface. ReceivingContentHandlerReceivingContentHandler is a glue class that provides a standard SAX ContentHandler interface to a Saxon Receiver. ReceivingContentHandler.LocalLocatorAn implementation of the Saxon
Locationinterface that wraps the SAX Locator information.
RegularSequenceCheckerA RegularSequenceChecker is a filter that can be inserted into a Receiver pipeline to check that the sequence of events passed in is a regular event sequence. RepairingContentHandlerA RepairingContentHandler is a SAX filter that can be placed on the input pipeline in front of a
ReceivingContentHandlerfor use in cases where the events supplied by the XML parser are not guaranteed to satisfy all the consistency constraints.
SenderSender is a helper class that sends events to a Receiver from any kind of Source object SequenceCollectorThis receiver is used when writing a sequence of atomic values and nodes, that is, when xsl:variable is used with content and an "as" attribute. SequenceCopierCopies a sequence, supplied as a SequenceIterator, to a push pipeline, represented by a SequenceReceiver SequenceNormalizerImplement the "sequence normalization" logic as defined in the XSLT 3.0/XQuery 3.0 serialization spec. SequenceNormalizerWithItemSeparatorImplement the "sequence normalization" logic as defined in the XSLT 3.0/XQuery 3.0 serialization spec. SequenceNormalizerWithSpaceSeparatorImplement the "sequence normalization" logic as defined in the XSLT 3.0/XQuery 3.0 serialization spec, for the case where there is no item-separator. SequenceReceiverSequenceReceiver: this extension of the Receiver interface is used when processing a sequence constructor. SequenceWriterThe SequenceWriter is used when writing a sequence of items, for example, when
xsl:variableis used with content and an "as" attribute.
SignificantItemDetectorThis receiver is inserted into the output pipeline whenever on-empty or on-non-empty is used (XSLT 3.0). SinkA Sink is a Receiver that discards all information passed to it SinkOutputterAn Outputter that swallows (discards) all input supplied to it StreamWriterToReceiverThis class implements the XmlStreamWriter interface, translating the events into Saxon Receiver events. StripperThe
Stripperclass performs whitespace stripping according to the rules of the xsl:strip-space and xsl:preserve-space instructions.
Stripper.StripRuleTarget TeeOutputterTeeOutputter: a SequenceReceiver that duplicates received events to two different destinations TransformerReceiverTransformerReceiver is similar in concept to the JAXP TransformerHandler, except that it implements Saxon's Receiver interface rather than the standard SAX2 interface. TreeReceiverA TreeReceiver acts as a bridge between a SequenceReceiver, which can receive events for constructing any kind of sequence, and an ordinary Receiver, which only handles events relating to the building of trees. TypeCheckingFilterA filter on the push pipeline that performs type checking, both of the item type and the cardinality. ValveA Valve is a general-purpose component for use in a pipeline of receivers. WherePopulatedOutputterThis class acts as a filter on a push pipeline, allowing through only those items that are deemed non-empty according to the rules of the xsl:where-populated instruction.
Enum Summary Enum Description RegularSequenceChecker.State
Exception Summary Exception Description CopyNamespaceSensitiveExceptionException indicating that an attempt was made to copy namespace-sensitive content without copying its associated namespaces NoOpenStartTagExceptionException indicating that an attribute or namespace node has been written when there is no open element to write it to