Package org.umber.bellows

Bellows XML Library.

See:
Description

Interface Summary

IDatumTransformer

Fundamental interface for altering existing Datum content.

Class Summary

Datum	A single unit of generic data.
DatumBrowser	Deprecated.
DatumQuery	A single XPath-like query which expresses a path through a tree of Datum objects.
ListDatum	A Datum which represents a list or one-dimensional array of Datum objects.
TableDatum	A complex Datum representing a two-dimensional array of child Datum objects.

Exception Summary

BellowsException	Base exception class for Bellows API.
DatumTransformException	Exception for expressing errors during IDatumTransform operations.

Package org.umber.bellows Description

Bellows XML Library. This package provides all the basic tools you need to develop with Bellows.

The Datum class is the atomic data node which is loaded and manipulated by the rest of the Bellows library. The Datum is roughly equivalent to an XML element, and is mapped to it when an XML document is converted into a Bellows Datum tree. Datum objects can carry an arbitrary assortment of properties with String keys and Object values. The names and values of these properties are not normally restricted, although you can add protection by wrapping a Datum in a TypesafeDatum class and accessing it through the wrapper. The TypesafeDatum will throw exceptions when its property constraints are violated.

The ListDatum class extends the base Datum class to allow nesting of other Datum nodes, making it possible to create complex hierarchical trees of Datum nodes.

The DatumQuery class provides simple access to a sophisticated XPath-like query language. The query language will save you the trouble of manually iterating through child elements and checking property values to find the Datum node(s) you are looking for.