Package org.writersforge.catalan.transform

Catalan Data Transformation Package.

See:
Description

Class Summary

AsciiConverter	A packed ASCII field processor which explodes a packed ASCII data node into a collection of Java objects, or vice versa.
AsciiFieldManager	A field-level manager for packing and unpacking ASCII data.
BaseNodeProcessor	A common base implementation for NodeProcessor.
BeanToXml	A processor which converts each input node into an XML tree.
Concatenator	A processor which converts all input nodes into String formats and concatenates them into a single output String node.
CustomNodeProcessor	Base class for all user-defined NodeProcessors.
DatumToObject	A text processor which converts Datum content into a List of java objects.
DirectiveStack	Format specification for placing Java Objects into a Datum tree.
DirectiveStack.Attribute	A Directive to create a new attribute (Datum property) inside the current element.
DirectiveStack.Directive	A single operation to perform on a node while creating a Bellows Datum tree from a list of nodes.
DirectiveStack.EndElement	A Directive to close the current element.
DirectiveStack.Pcdata	A Directive to insert PCDATA content into the current element.
DirectiveStack.Repeat	A Directive to repeat an embedded stack of directives until a certain condition is met.
DirectiveStack.StartElement	A Directive to start a new Datum element.
GroupProcessor	Composite NodeProcessor which can combine multiple processors into a single easily referenced one.
Normalizer	A text processor which cleans up the input text content according to its set of configurable rules.
ObjectToDatum	A data processor which converts a List of java objects into Datum content.
ProcessorFactory	Factory for converting XML transform instructions into NodeProcessor classes.
TextProcessor	The shared base class for all Catalan ASCII text processors.
TextReplacer	A text processor which performs a simple search and replace action.
TokenSplitter	A text processor which breaks apart its String contents into smaller parts, based on its own parameters.
Transformer	A XML driven data transformer for converting data from one format to another.
VariableTextReplacer	A text processor which performs dynamic text replacement by looking up specially formatted variables and resolving them against a Map of variable names to text values.
XmlToBean	A processor which converts each Datum input node into a JavaBean.

Package org.writersforge.catalan.transform Description

Catalan Data Transformation Package. This set of classes provides an architecture for transforming Java objects into other forms, including String to String, String to XML, XML to String, and eventually String or XML to JavaBean and back.

NOTE: Current support includes String to String and String to XML transforms. More transforms will be added later.

The Transformer class is the front-end interface to the transformation engine. The Transformer encapsulates the other Java classes in this package, driven by an XML specification document that maps directly into those support classes. A detailed description of the XML spec format is included in the API documentation for the Transformer class.

The Transformer can process the XML spec in two ways: all transforms in order, from top to bottom; and selected transforms in a user-defined order. The first way, which uses the method processAll(), runs a List of input nodes through every transform in the XML spec. The second method, which uses the method process(), references individual transforms within the XML spec by id (see getProcessorIds()). The first method is good for self-contained atomic transforms; the second method is good for gathering simple, common transforms into a single library for easier maintenance.