Package org.xmlpull.v1.builder

This package defines API modeled after XML Information Set for building incrmentally XML trees from events streamed from pull parser (user can start navigating tree before whole XML input was parsed!) and has an unique ability to bypass tree building for selected sub trees to work directly with underlying event stream.

See: Description

Interface Summary

Interface	Description
Iterable	Use java.lang.Iterable instead when JDK 1.5 comes out ...*
XmlAttribute	This is immutable value object that represents Attribute Information Item with exception of references property.
XmlCharacters	Represents otrdered colection of Character Information Items where character code properties are put together into Java String.
XmlComment	Represents Comment Information Item.
XmlContained	Common abstraction to represent XML infoset item that are contained in other infoet items This is useful so parent can be updated on contained items when container is cloned ...
XmlContainer	Common abstraction shared between XmlElement, XmlDocument and XmlDoctype to represent XML Infoset item that can contain other Infoset items This is useful so getParent() operation will return this instead of Object ...
XmlDoctype	Represents Document Type Declaration Information Item.
XmlDocument	Represents Document Information Item .
XmlElement	Represents Element Information Item except for in-scope namespaces that can be reconstructed by visiting this element parent, checking its namespaces, then grandparent and so on.
XmlNamespace	Represents Namespace Information Item .
XmlNotation	Represents Notation Information Item.
XmlProcessingInstruction	Represents Processing Instruction Information Item .
XmlSerializable	This interface is used during serialization by XmlInfosetBuilder for children that are not in XML infoset.
XmlUnexpandedEntityReference	Represents Unexpanded Entity Reference Information Item .
XmlUnparsedEntity	Represents Unparsed Entity Information Item .

Class Summary

Class	Description
XmlInfosetBuilder	By default builder is using non-validating pull parser with next() method without namespaces to build tree consisting only of XmlDocument, XmlElemenet and String nodes.

Exception Summary

Exception	Description
XmlBuilderException	This exception is thrown to signal XB1 related exceptions.

Package org.xmlpull.v1.builder Description

This package defines API modeled after XML Information Set for building incrmentally XML trees from events streamed from pull parser (user can start navigating tree before whole XML input was parsed!) and has an unique ability to bypass tree building for selected sub trees to work directly with underlying event stream. This coupled with ability to create XML tree that can mix in any Java Object allows to represent objects derived from XML (databinding) in the XML tree.

Features

• unique ability to achieve high performance that is common in streaming parsers and ease of use associated with tree approaches in the same API by provising very precise control over XML tree creation and access to underlying streaming parser during tree creation (API users needs to do it if and only if they do want to bypass default tree creation and replace it with their customized object tree, work directly with XML events or just skip unneded parts of XML that do not need to be in XML node tree).
• easy to use: modeled after XML Information Set to build on well established abstract model to represent XML
• small: only few classes and interfaces
• fast: builds on the most powerful XmlPull API that makes possible to create high perfromance parser implemntations
• flexible: based on the state of the art interface-implementation approach allowing anybody to modify and extend easily API

Overview

API is directly modeled on XML Information Set with few minor exceptions but expands on it to provide additional functions to create and manipulate XML Information Set (essentially providing Synthetic Infoset).

TODO:

• when generics are supported in JDK upgrade API to use Iterator<T> instead of Enumeration ...

  
  

  Aleksander Slominski
  
  Last modified: $Id: package.html,v 1.1 2003/04/13 00:59:23 aslom Exp $