org.xmlpull.v1.builder.package.html Maven / Gradle / Ivy
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.1.1 2004/05/23 20:10:15 esweeney Exp $
© 2015 - 2024 Weber Informatics LLC | Privacy Policy