Examples of net.htmlparser.jericho.StreamedSource$StreamedSourceIterator

• net.htmlparser.jericho.StreamedSource
  kipedia.org/wiki/StAX">StAX parser, but with some important benefits:

  • The source document does not have to be valid XML. It can be plain HTML, can contain invalid syntax, undefined entities, incorrectly nested elements, {@linkplain TagType#isServerTag() server tags}, or anything else that is commonly found in "tag soup".
  • Every single syntactical construct in the source document's original text is included in the iterator, including the {@linkplain StartTagType#XML_DECLARATION XML declaration}, {@linkplain CharacterReference character references}, {@linkplain StartTagType#COMMENT comments}, {@linkplain StartTagType#CDATA_SECTION CDATA sections} and {@linkplain TagType#isServerTag() server tags}, each providing the segment's {@linkplain Segment#getBegin() begin} and {@linkplain Segment#getEnd() end} position in the source document.This allows an exact copy of the original document to be generated, allowing modifications to be made only where they are explicitly required. This is not possible with either SAX or StAX, which to some extent provide interpretations of the content of the XML instead of the syntactial structures used in the original source document.

  The following table summarises the differences between the StreamedSource, StAX and SAX interfaces. Note that some of the available features are documented as optional and may not be supported by all implementations of StAX and SAX.

  Feature	StreamedSource	StAX	SAX
  Parse XML	●	●	●
  Parse entities without DTD	●
  Automatically validate XML		●	●
  Parse HTML	●
  Tolerant of syntax or nesting errors	●
  Provide begin and end character positions of each event1	●	○
  Provide source text of each event	●
  Handle {@linkplain TagType#isServerTag() server tag} events	●
  Handle {@linkplain StartTagType#XML_DECLARATION XML declaration} event	●
  Handle {@linkplain StartTagType#COMMENT comment} events	●	●	●
  Handle {@linkplain StartTagType#CDATA_SECTION CDATA section} events	●	●	●
  Handle {@linkplain StartTagType#DOCTYPE_DECLARATION document type declaration} event	●	●	●
  Handle {@linkplain CharacterReference character reference} events	●
  Allow chunking of plain text	●	●	●
  Allow chunking of comment text
  Allow chunking of CDATA section text			●
  Allow specification of maximum buffer size	●

  ¹ StAX optionally reports the "offset" of each event but this could be either byte or character position depending on the source.

  Note that the {@link OutputDocument} class can not be used to create a modified version of a streamed source document.Instead, the output document must be constructed manually from the segments provided by the {@link #iterator() iterator}.

  StreamedSource objects are not thread safe.

Related Classes of net.htmlparser.jericho.StreamedSource$StreamedSourceIterator