Package it.unimo.dbgroup.momis.XmlTools

Package for objects serialization/deserialization in XML format.

See:
Description

Interface Summary

FullXmlExternalizable	Allows a custom class to customize even its XML object definition element.
XmlExternalizable	Extends the Serializable interface to support custom XML serialization.

Class Summary

BaseObjectDomStreamer	Base class for specialized object streamers.
BaseXmlTools	Base class for all XmlTools.
DomNavigator	Provides a cursor to navigate through Elements of a DOM tree.
ObjectsList	XmlWriter helper class to take track of object that was written and related information.
XmlObjectInput	XmlReader wrapper that extends ObjectInputStream.
XmlObjectOutput	XmlWriter wrapper that extends ObjectOutputStream.
XmlReader	This class reads an Xml document produced by XmlWriter and deserializes any object encoutered.
XmlWriter	This class create a DOM tree representing a description or serialization of any Java object passed as input.

Exception Summary

XmlToolsException	Thrown when XmlTools can't accomplish a XML related operation.
XmlWriterException	Exception specific to XmlWriter

Package it.unimo.dbgroup.momis.XmlTools Description

Package for objects serialization/deserialization in XML format.

XmlTools package supplies various classes, the most important are:

• XmlWriter
• XmlReader
• XmlObjectOutput
• XmlObjectInput

XmlReader and XmlWriter are the two main classes used for reading and writing object from and into a DOM tree.

Tools for XML serialization support the following features:

• Description or serialization any java objects graph.
• implementation of ObjectOutput and DataOutput interfaces (through XmlObjectOutput wrapper)
• flexible customization of the XML output without writing any method.
• full customizable XML output implementing simple methods. The user can interviene on three levels depending on what must be customized:
  • small in-class customization implementing one of writeObject methods.
  • Whole class customization implementig XmlExternalizable or Externalizable interfaces.
  • Full Xml customization implemting FullXmlExternalizable Interface.
• XmlWriter output is a standard DOM document that the user can further modify.
• Namespaces aware output.
• Output of balanced DOM.
• Support for Map interface description.
• Support for Collection interface description
• Redundancy minimization.
• Class versioning support
• Xml comments support.
• Complete protected interface to allow user to easily sub-class XmlWriter or replace XmlObjectOutput wrapper.

Tools for XML deserialization support the following features:

• Compatible with any existing Java Object that implements Serializable or Externalizable interface.
• implementation of ObjectInput and DataInput interfaces (through XmlObjectInput wrapper)
• Multiple XML format support.
• Two levels customization handling:
  • small in-class customization implementing one of readObject methods.
  • Whole class customization implementig XmlExternalizable or Externalizable interfaces.
• Input of XmlReader is a standard DOM Document no matter how it was created.
• Support for random access deserialization (needed with balanced DOM tree)
• Support for described Map(s)
• Support for described Collection(s)
• Class version check, (can be disabled also)
• Complete protected interface to allow user to easily sub-class XmlReader or replace the XmlObjectInput wrapper.