The XML Streams Package

XML Streams Module Reference Guide
Rogue Wave web site: Home Page | Main Documentation Page

2.2 The XML Streams Package

This section includes the XML Streams package hierarchy and a listing of classes.

2.2.1 Class Hierarchy

Figure 1 and Figure 2 illustrate the class hierarchy of the XML Streams package.

Figure 1: XML Streams package class hierarchy

Figure 2: XML Streams package hierarchy, continued

2.2.2 Listing of Class Groups

The classes in the XML Streams package fall into three functional groups:

Basic XML streams classes
Enhanced XML streams classes
XML transformation classes

2.2.2.1 Basic XML Streams Classes

The basic XML streams classes serialize objects as XML data and restore objects previously serialized as XML data.

Table 1: Listing of basic XML streams classes

Class Name	Purpose
*RWXmlObjectStreamCommon*	The abstract base class for XML streams. This class simply defines a set of static data members used in common by the two implementation classes.
*RWXmlObjectOutputStreamImp*	The implementation class for XML output streams. Creates a data stream that: serializes objects as a stream of XML data passes the stream on to a lower-level output streaming object
*RWXmlObjectInputStreamImp*	The implementation class for XML input streams. Creates a stream that: accepts an XML data stream passed to it by a lower-level input streaming object restores the objects represented by the data stream

2.2.2.2 Enhanced XML Streams Classes

The enhanced XML streams classes extend the functionality of the basic XML streams classes. They offer full support for namespaces and impose no restrictions regarding ordering of elements or attributes. They also produce a more natural-looking XML document. As such, for instance, they may be used as the serializer/deserializer for objects embedded in SOAP documents.

Table 2: Listing of enhanced XML streams classes

Class Name	Purpose
*RWEnhancedXmlObjectInputStreamImp*	A new XML input stream using a more robust and forgiving XML parser and reading a more natural-looking XML document.
*RWEnhancedXmlObjectOutputStreamImp*	A new XML output stream producing a more natural looking XML document.

2.2.2.3 XML Transformation Classes

The XML transformation classes allow you to insert a transformation into the XML data stream.

NOTE -- For a list of XSLT Transformation classes previously included in this group, see the Appendix in the XML Streams User's Guide.

Table 3: Listing of XML transformation classes

Class Name	Purpose
*RWTParsedTransformInputStreamImp*	An element-based transformation input stream utilizing a built-in C++ parser and calling a C++ transformation object.
*RWTParsedTransformOutputStreamImp*	An element-based transformation output stream utilizing a built-in C++ parser and calling a C++ transformation object.
*RWTParsedTransformObjectInputStreamImp*	An object input stream transformation class that builds up a chain of streams using a element-based parsed transformation stream to perform the transform operation.
*RWTParsedTransformObjectOutputStreamImp*	An object output stream transformation class that builds up a chain of streams using a element-based parsed transformation stream to perform the transform operation.
*RWTTransformInputStreamImp*	A template class for creating a `char` or `byte` input stream that includes a transformation.
*RWTTransformOutputStreamImp*	A template class for creating a `char` or `byte` output stream that includes a transformation.
*RWTTransformObjectInputStreamImp*	A template class for creating an XML object input stream that includes a generic transformation.
*RWTTransformObjectOutputStreamImp*	A template class for creating an XML object output stream that includes a generic transformation.
*RWTXmlTraits*	A traits class used to provide character and string values required by the *RWTParsed* transformation streams.
*RWXmlStreamElement*	An XML element abstraction for implementing efficient C++ based transformations.

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.