Package ecologylab.xml

Provides facilities to translate trees of nested Java objects to equivalent XML DOMs, and vice versa.

See:
Description

Interface Summary

CharacterConstants	Character Constants for which extra care needs to be taken while parsing.
OptimizationTypes
SpecialCharacterEntities	XML character entity names for special markup.
XMLTranslationExceptionTypes	Types of exceptions that occur during operation of the translation framework.

Class Summary

ElementState	This class is the heart of the ecologylab.xml translation framework.
ElementStateSAXHandler	Use SAX to translate XML into a typed tree of ElementState objects.
NameSpaceDecl	Declare an XML Namespace, by mapping a URI String to an ElementState subclass.
Optimizations	Cached object that holds all of the structures needed to optimize translations to and from XML for a single subclass of ElementState.
TranslationSpace	A set of translations between XML element names (tags) and associated Java ElementState class names.
XMLReaderPool
XMLTools	Static helper methods that are used during the translation of java objects to XML and back.

Enum Summary

ElementState.DeclarationStyle

These are the styles for declaring fields as translated to XML.

Exception Summary

XMLTranslationException

There are certain rules one has to follow while using this framework for translation from Java to XML and back.

Annotation Types Summary

ElementState.xml_attribute	Metalanguage declaration that tells ecologylab.xml translators that each Field it is applied to as an annotation is a scalar-value, which should be represented in XML as an attribute.
ElementState.xml_class	Supplementary metalanguage declaration that can be applied only to a field.
ElementState.xml_classes	Supplementary metalanguage declaration that can be applied only to a field.
ElementState.xml_collection	Metalanguage declaration that tells ecologylab.xml translators that each Field it is applied to as an annotation is of type Collection.
ElementState.xml_leaf	Metalanguage declaration that tells ecologylab.xml translators that each Field it is applied to as an annotation is a scalar-value, which should be represented in XML as a leaf node: an XML element with a single text node child, which represents the value.
ElementState.xml_map	Metalanguage declaration that tells ecologylab.xml translators that each Field it is applied to as an annotation is of type Map.
ElementState.xml_nested	Metalanguage declaration that tells ecologylab.xml translators that each Field it is applied to as an annotation is represented in XML by a (non-leaf) nested child element.
ElementState.xml_tag	Metalanguage declaration that can be applied either to field or to class declarations.
xml_inherit	Metalanguage declaration for classes with metalanguage inside, which are derived from other classes that also have metalanguage that needs interpreting.

Package ecologylab.xml Description

Provides facilities to translate trees of nested Java objects to equivalent XML DOMs, and vice versa. The following dated flowchart shows the overall process of conversion of Java objects to XML and XML back to Java objects.