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.
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 $
-
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.